szhygulin/recon-crypto-mcp

First public release of Recon Crypto MCP — a Model Context Protocol server that lets AI agents (Claude Code, Claude Desktop, Cursor, and any MCP-compatible client) read on-chain DeFi positions and prepare EVM transactions that you sign on a Ledger hardware wallet via WalletConnect. Private keys never leave the device; every transaction is previewed in human-readable form before on-device approval.

Highlights

• Self-custodial: Ledger-signed via WalletConnect v2. The MCP never holds keys or broadcasts unsigned-by-you txs.
• Cross-chain portfolio: Ethereum, Arbitrum, Polygon. Wallet balances + Aave V3 + Compound V3 + Morpho Blue + Uniswap V3 LP + Lido + EigenLayer, aggregated with USD totals.
• Agent-first design: metadata, descriptions, and a request_capability escape hatch tuned so agents can discover what the server can and can't do.
• Security tooling: contract verification, EIP-1967 proxy/admin detection, privileged-role enumeration (Ownable, AccessControl, Gnosis Safe, Timelock), DefiLlama-backed 0–100 protocol risk score.

Supported protocols

Aave V3 · Compound V3 (Comet) · Morpho Blue · Uniswap V3 LP · Lido (stETH / wstETH) · EigenLayer · LiFi (swap/bridge aggregation) · 1inch (optional intra-chain quote comparison) · ENS · DefiLlama prices.

Actions exposed to the agent

Read-only — get_portfolio_summary, get_lending_positions, get_compound_positions, get_morpho_positions, get_lp_positions, get_staking_positions, get_staking_rewards, estimate_staking_yield, get_health_alerts, simulate_position_change, get_token_balance, get_token_price, resolve_ens_name, reverse_resolve_ens, get_swap_quote, check_contract_security, check_permission_risks, get_protocol_risk_score, get_transaction_status.

Execution (Ledger-signed) — supply/withdraw/borrow/repay on Aave, Compound, Morpho · supply/withdraw collateral on Morpho · Lido stake/unstake · EigenLayer deposit · LiFi swap/bridge · native + ERC-20 sends · send_transaction to forward a prepared tx to Ledger Live.

Meta — request_capability: agent-facing escape hatch for missing protocols/chains/tools. Defaults to a pre-filled GitHub issue URL (zero spam risk, user click-through). Rate-limited (30s / 3 per hour / 10 per day, 7-day dedupe).

Install

npm install -g recon-crypto-mcp
recon-crypto-mcp-setup

Then add to Claude Desktop / Claude Code / Cursor config:

{ "mcpServers": { "recon-crypto-mcp": { "command": "recon-crypto-mcp" } } }

See the README for full setup, environment variables, and operator notes on the optional RECON_FEEDBACK_ENDPOINT proxy.

Requirements

• Node.js ≥ 18.17
• An RPC provider (Infura, Alchemy, or custom) for Ethereum / Arbitrum / Polygon
• WalletConnect Cloud project ID (for Ledger signing)
• Optional: Etherscan API key, 1inch Developer Portal API key

Roadmap

MetaMask support · Base · Solana — see README.

MIT licensed.