recon-crypto-mcp 0.1.0

package/dist/index.js

@@ -0,0 +1,344 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { getLendingPositions, getLpPositions, getHealthAlerts, simulatePositionChange, } from "./modules/positions/index.js";
+import { getLendingPositionsInput, getLpPositionsInput, getHealthAlertsInput, simulatePositionChangeInput, } from "./modules/positions/schemas.js";
+import { checkContractSecurityHandler, checkPermissionRisksHandler, getProtocolRiskScoreHandler, } from "./modules/security/index.js";
+import { checkContractSecurityInput, checkPermissionRisksInput, getProtocolRiskScoreInput, } from "./modules/security/schemas.js";
+import { getStakingPositions, getStakingRewards, estimateStakingYield, } from "./modules/staking/index.js";
+import { getStakingPositionsInput, getStakingRewardsInput, estimateStakingYieldInput, } from "./modules/staking/schemas.js";
+import { getPortfolioSummary } from "./modules/portfolio/index.js";
+import { getPortfolioSummaryInput } from "./modules/portfolio/schemas.js";
+import { getSwapQuote, prepareSwap } from "./modules/swap/index.js";
+import { getSwapQuoteInput, prepareSwapInput } from "./modules/swap/schemas.js";
+import { pairLedgerLive, getLedgerStatus, prepareAaveSupply, prepareAaveWithdraw, prepareAaveBorrow, prepareAaveRepay, prepareLidoStake, prepareLidoUnstake, prepareEigenLayerDeposit, prepareNativeSend, prepareTokenSend, sendTransaction, getTransactionStatus, } from "./modules/execution/index.js";
+import { pairLedgerLiveInput, getLedgerStatusInput, prepareAaveSupplyInput, prepareAaveWithdrawInput, prepareAaveBorrowInput, prepareAaveRepayInput, prepareLidoStakeInput, prepareLidoUnstakeInput, prepareEigenLayerDepositInput, prepareNativeSendInput, prepareTokenSendInput, sendTransactionInput, getTransactionStatusInput, } from "./modules/execution/schemas.js";
+import { getTokenBalance, resolveName, reverseResolve } from "./modules/balances/index.js";
+import { getTokenBalanceInput, resolveNameInput, reverseResolveInput, } from "./modules/balances/schemas.js";
+import { getCompoundPositions } from "./modules/compound/index.js";
+import { buildCompoundSupply, buildCompoundWithdraw, buildCompoundBorrow, buildCompoundRepay, } from "./modules/compound/actions.js";
+import { getCompoundPositionsInput, prepareCompoundSupplyInput, prepareCompoundWithdrawInput, prepareCompoundBorrowInput, prepareCompoundRepayInput, } from "./modules/compound/schemas.js";
+import { getMorphoPositions } from "./modules/morpho/index.js";
+import { buildMorphoSupply, buildMorphoWithdraw, buildMorphoBorrow, buildMorphoRepay, buildMorphoSupplyCollateral, buildMorphoWithdrawCollateral, } from "./modules/morpho/actions.js";
+import { getMorphoPositionsInput, prepareMorphoSupplyInput, prepareMorphoWithdrawInput, prepareMorphoBorrowInput, prepareMorphoRepayInput, prepareMorphoSupplyCollateralInput, prepareMorphoWithdrawCollateralInput, } from "./modules/morpho/schemas.js";
+import { getTokenPriceInput, getTokenPriceTool } from "./modules/prices/index.js";
+import { requestCapability, requestCapabilityInput } from "./modules/feedback/index.js";
+import { issueHandles } from "./signing/tx-store.js";
+import { readUserConfig } from "./config/user-config.js";
+/**
+ * Wrap a plain async function into the shape MCP expects.
+ * Returns `{ content: [{ type: "text", text }] }` on success,
+ * `{ content, isError: true }` on failure.
+ */
+function handler(fn) {
+    return async (args) => {
+        try {
+            const result = await fn(args);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, bigintReplacer, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    };
+}
+/**
+ * Handler wrapper for prepare_* tools that return UnsignedTx. Runs the function,
+ * then issues opaque handles across the tx and every `.next` node so
+ * `send_transaction` can re-hydrate the exact tx from server state. The agent
+ * never passes raw calldata to the signing path — it calls send_transaction
+ * with a handle, which closes the prompt-injection → arbitrary-calldata window.
+ */
+function txHandler(fn) {
+    return handler(async (args) => issueHandles(await fn(args)));
+}
+/** JSON.stringify replacer that converts bigint to decimal string. */
+function bigintReplacer(_key, value) {
+    return typeof value === "bigint" ? value.toString() : value;
+}
+async function main() {
+    // Check for at least one configured RPC path early. We don't hard-fail — the
+    // user may only use read-only tools with per-chain env vars. We just warn.
+    const cfg = readUserConfig();
+    const hasEnvChain = process.env.ETHEREUM_RPC_URL || process.env.ARBITRUM_RPC_URL;
+    const hasEnvProvider = process.env.RPC_PROVIDER && process.env.RPC_API_KEY;
+    if (!cfg && !hasEnvChain && !hasEnvProvider) {
+        console.error("[recon-crypto-mcp] warning: no RPC provider configured. Run `recon-crypto-mcp-setup` or set RPC_PROVIDER + RPC_API_KEY.");
+    }
+    const server = new McpServer({
+        name: "recon-crypto-mcp",
+        title: "Recon — Ledger-Signed Crypto Portfolio & DeFi",
+        version: "0.1.0",
+        websiteUrl: "https://github.com/szhygulin/recon-crypto-mcp",
+    }, {
+        instructions: [
+            "Recon is a self-custodial crypto-portfolio and DeFi tooling server for AI agents.",
+            "The user's private keys live on a Ledger hardware wallet; this server never holds or",
+            "broadcasts keys. Every state-changing transaction is prepared here (read-only) and",
+            "then forwarded to Ledger Live via WalletConnect so the user can review and approve it",
+            "on the physical device.",
+            "",
+            "USE THIS SERVER WHEN the user asks about:",
+            "- their crypto wallet, balances, tokens, ETH, ERC-20 holdings, or ENS name",
+            "- their DeFi positions on Ethereum, Arbitrum, or Polygon — Aave V3 lending/borrowing,",
+            "  Compound V3 (Comet), Morpho Blue, Uniswap V3 LP, Lido staking, EigenLayer restaking",
+            "- portfolio value, cross-chain aggregation, health-factor / liquidation risk",
+            "- executing on-chain actions: supply, borrow, repay, withdraw, stake, unstake,",
+            "  send ETH/tokens, swap, bridge",
+            "- token prices, ENS forward/reverse resolution",
+            "- assessing the security of a smart contract or DeFi protocol (verification, proxy",
+            "  upgradeability, privileged roles, TVL/audit-based risk score)",
+            "",
+            "TYPICAL WORKFLOW for a transaction:",
+            "1. Call `get_ledger_status` first to discover the user's connected wallet address(es)",
+            "   — resolve phrases like \"my wallet\" or \"account 2\" to a concrete 0x… address before",
+            "   calling any other tool that takes a `wallet` argument.",
+            "2. If not paired yet, call `pair_ledger_live` and show the returned QR/URI.",
+            "3. Call a `prepare_*` tool to build the unsigned transaction (this returns a handle",
+            "   plus a human-readable decoded preview; no calldata is exposed to the agent).",
+            "4. Show the decoded preview to the user and get explicit confirmation.",
+            "5. Call `send_transaction` with the handle and `confirmed: true` — Ledger Live will",
+            "   prompt the user to review and physically sign on the device.",
+            "6. Optionally poll `get_transaction_status` for inclusion.",
+            "",
+            "READ-ONLY TOOLS need no pairing and can be called freely: get_lending_positions,",
+            "get_lp_positions, get_compound_positions, get_morpho_positions, get_staking_positions,",
+            "get_staking_rewards, estimate_staking_yield, get_portfolio_summary, get_swap_quote,",
+            "get_token_balance, get_token_price, resolve_ens_name, reverse_resolve_ens,",
+            "get_health_alerts, simulate_position_change, check_contract_security,",
+            "check_permission_risks, get_protocol_risk_score, get_transaction_status.",
+            "",
+            "SWAP/BRIDGE ROUTING: prefer `prepare_swap` (LiFi aggregator) over building DEX",
+            "router calls directly — LiFi handles route selection, approvals, and cross-chain",
+            "bridging uniformly.",
+            "",
+            "CAPABILITY GAPS: if the user asks for something this server cannot do (unsupported",
+            "protocol, chain, token, or a workflow none of the existing tools cover), call",
+            "`request_capability` to file a GitHub issue on the recon-crypto-mcp repo. By default it",
+            "returns a prefilled URL for the user to click — nothing is sent automatically. Use",
+            "this only after confirming no existing tool fits; it is rate-limited (3/hour,",
+            "10/day, dedup'd for 7 days). Never substitute this for completing the task.",
+            "",
+            "SECURITY: the `wallet` / `peerUrl` returned by `get_ledger_status` is self-reported",
+            "by the paired WalletConnect peer. Before the FIRST `send_transaction` of a session,",
+            "state the paired wallet name + URL back to the user and have them confirm it matches",
+            "their real Ledger Live install. The Ledger device's on-screen confirmation is the",
+            "ultimate authority — tell the user to verify the recipient, amount, and chain on",
+            "the device, not just in chat.",
+        ].join("\n"),
+    });
+    // ---- Module 1: Positions ----
+    server.registerTool("get_lending_positions", {
+        description: "Fetch all Aave V3 lending/borrowing positions for a wallet. Returns collateral, debt (both in USD and per-asset), health factor, LTV, and liquidation threshold across Ethereum and Arbitrum.",
+        inputSchema: getLendingPositionsInput.shape,
+    }, handler(getLendingPositions));
+    server.registerTool("get_lp_positions", {
+        description: "Fetch all Uniswap V3 liquidity-provider positions for a wallet. Returns token pair, current token amounts, fee tier, in-range status, uncollected fees (lower bound), and an approximate impermanent-loss estimate.",
+        inputSchema: getLpPositionsInput.shape,
+    }, handler(getLpPositions));
+    server.registerTool("get_health_alerts", {
+        description: "Check for Aave V3 lending positions approaching liquidation. Returns positions whose health factor is below the given threshold (default 1.5).",
+        inputSchema: getHealthAlertsInput.shape,
+    }, handler(getHealthAlerts));
+    server.registerTool("simulate_position_change", {
+        description: "Simulate the effect of adding or removing collateral, or borrowing/repaying debt on an Aave V3 position. Returns the projected health factor and collateral/debt totals. No transaction is sent.",
+        inputSchema: simulatePositionChangeInput.shape,
+    }, handler(simulatePositionChange));
+    // ---- Module 2: Security ----
+    server.registerTool("check_contract_security", {
+        description: "Check Etherscan verification status, EIP-1967 proxy pattern, implementation/admin slots, and the presence of dangerous admin functions (mint, pause, upgradeTo, etc.) for a given contract.",
+        inputSchema: checkContractSecurityInput.shape,
+    }, handler((a) => checkContractSecurityHandler(a)));
+    server.registerTool("check_permission_risks", {
+        description: "Enumerate privileged roles on a contract (Ownable.owner, AccessControl hints) and classify holders as EOA, Gnosis Safe multisig, or TimelockController.",
+        inputSchema: checkPermissionRisksInput.shape,
+    }, handler((a) => checkPermissionRisksHandler(a)));
+    server.registerTool("get_protocol_risk_score", {
+        description: "Return a 0-100 risk score for a DeFi protocol, combining TVL size, 30-day TVL trend, contract age, audit count (DefiLlama), and Immunefi bug-bounty status. Higher = safer.",
+        inputSchema: getProtocolRiskScoreInput.shape,
+    }, handler((a) => getProtocolRiskScoreHandler(a)));
+    // ---- Module 3: Staking ----
+    server.registerTool("get_staking_positions", {
+        description: "Fetch Lido (stETH/wstETH) and EigenLayer staking positions for a wallet across supported chains. Returns per-protocol staked amounts, USD value, APR, and EigenLayer delegation target.",
+        inputSchema: getStakingPositionsInput.shape,
+    }, handler(getStakingPositions));
+    server.registerTool("get_staking_rewards", {
+        description: "Estimate staking rewards earned over a given period (7d/30d/90d/1y) using the current APR as a proxy. This is an estimate, not an on-chain rewards query.",
+        inputSchema: getStakingRewardsInput.shape,
+    }, handler(getStakingRewards));
+    server.registerTool("estimate_staking_yield", {
+        description: "Project annual yield on a hypothetical staking amount for a given protocol (Lido or EigenLayer) using current APRs.",
+        inputSchema: estimateStakingYieldInput.shape,
+    }, handler(estimateStakingYield));
+    // ---- Module 4: Portfolio ----
+    server.registerTool("get_portfolio_summary", {
+        description: "Aggregate a complete portfolio view: native balances, top ERC-20 holdings, Aave V3 positions, Uniswap V3 LP positions, and staking — with USD totals and per-chain breakdown.",
+        inputSchema: getPortfolioSummaryInput.shape,
+    }, handler(getPortfolioSummary));
+    // ---- Module 5: Swap/Bridge (LiFi) ----
+    server.registerTool("get_swap_quote", {
+        description: "Get a LiFi aggregator quote for a token swap (same-chain) or bridge (cross-chain). Returns expected output, fees, execution time, and the underlying tool selected. No transaction is built.",
+        inputSchema: getSwapQuoteInput.shape,
+    }, handler(getSwapQuote));
+    server.registerTool("prepare_swap", {
+        description: "Prepare an unsigned swap or bridge transaction via LiFi aggregator. Same-chain swaps use the best DEX route; cross-chain swaps use a bridge + DEX combo. The returned tx can be sent via `send_transaction`.",
+        inputSchema: prepareSwapInput.shape,
+    }, txHandler(prepareSwap));
+    // ---- Module 6: Execution (Ledger Live) ----
+    server.registerTool("pair_ledger_live", {
+        description: "Initiate a WalletConnect v2 pairing session with Ledger Live. Returns a URI and ASCII QR code — paste into Ledger Live's WalletConnect screen to complete pairing. The session persists for future transactions.",
+        inputSchema: pairLedgerLiveInput.shape,
+    }, handler(pairLedgerLive));
+    server.registerTool("get_ledger_status", {
+        description: "Report whether a WalletConnect session with Ledger Live is active, which wallet it's connected to, and which accounts are exposed. " +
+            "Returns `accounts: 0x…[]` — the list of wallet addresses the user has connected. " +
+            "Call this FIRST whenever the user refers to their wallet(s) by position or nickname instead of by address — e.g. " +
+            '\"my wallet\", \"the first address\", \"account 2\", \"second wallet\" — so you can resolve the reference to a concrete 0x… ' +
+            "before invoking any prepare_* / swap / send / portfolio tool that takes a `wallet` argument. Do NOT ask the user to paste an " +
+            "address if it's already in `accounts` here. " +
+            "SECURITY: the returned `wallet`/`peerUrl` are self-reported by the paired app. Before the FIRST send_transaction of a session, " +
+            "state the paired wallet name + URL back to the user and ask them to confirm it matches their Ledger Live install — " +
+            "any WalletConnect peer can claim to be 'Ledger Live'. The physical Ledger device's on-screen confirmation is the final check.",
+        inputSchema: getLedgerStatusInput.shape,
+    }, handler(getLedgerStatus));
+    server.registerTool("prepare_aave_supply", {
+        description: "Build an unsigned Aave V3 supply transaction. If an ERC-20 approve() is required first, it is returned as the outer tx and the supply tx is embedded in `.next`. Both must be signed for the supply to succeed.",
+        inputSchema: prepareAaveSupplyInput.shape,
+    }, txHandler(prepareAaveSupply));
+    server.registerTool("prepare_aave_withdraw", {
+        description: "Build an unsigned Aave V3 withdraw transaction. Pass `amount: \"max\"` to withdraw the entire aToken balance.",
+        inputSchema: prepareAaveWithdrawInput.shape,
+    }, txHandler(prepareAaveWithdraw));
+    server.registerTool("prepare_aave_borrow", {
+        description: "Build an unsigned Aave V3 borrow transaction (variable rate — stable rate is deprecated and reverts on production markets). The borrower must already have sufficient collateral supplied.",
+        inputSchema: prepareAaveBorrowInput.shape,
+    }, txHandler(prepareAaveBorrow));
+    server.registerTool("prepare_aave_repay", {
+        description: "Build an unsigned Aave V3 repay transaction. If an ERC-20 approve() is required first, it is returned as the outer tx and repay is in `.next`. Pass `amount: \"max\"` to repay the full debt.",
+        inputSchema: prepareAaveRepayInput.shape,
+    }, txHandler(prepareAaveRepay));
+    server.registerTool("prepare_lido_stake", {
+        description: "Build an unsigned Lido stake transaction (wraps ETH into stETH via stETH.submit). The tx's value field is the ETH amount to stake.",
+        inputSchema: prepareLidoStakeInput.shape,
+    }, txHandler(prepareLidoStake));
+    server.registerTool("prepare_lido_unstake", {
+        description: "Build an unsigned Lido withdrawal request transaction. Wraps `requestWithdrawals` on the Lido Withdrawal Queue and includes an approve step if needed.",
+        inputSchema: prepareLidoUnstakeInput.shape,
+    }, txHandler(prepareLidoUnstake));
+    server.registerTool("prepare_eigenlayer_deposit", {
+        description: "Build an unsigned EigenLayer StrategyManager.depositIntoStrategy transaction. Includes an ERC-20 approve step if needed.",
+        inputSchema: prepareEigenLayerDepositInput.shape,
+    }, txHandler(prepareEigenLayerDeposit));
+    server.registerTool("send_transaction", {
+        description: "Forward an already-prepared transaction to Ledger Live via WalletConnect for user signing. The user must review and approve the tx in Ledger Live and on their Ledger device; this call blocks until the user signs or rejects. " +
+            "You MUST pass `confirmed: true` — the agent is affirming that the user has seen and acknowledged the decoded preview.",
+        inputSchema: sendTransactionInput.shape,
+    }, handler(sendTransaction));
+    server.registerTool("get_transaction_status", {
+        description: "Poll a transaction's status via the chain's RPC. Returns pending / success / failed, or unknown if the node hasn't seen it yet.",
+        inputSchema: getTransactionStatusInput.shape,
+    }, handler(getTransactionStatus));
+    // ---- Module 7: Balances & ENS ----
+    server.registerTool("get_token_balance", {
+        description: "Fetch a wallet's balance of any ERC-20 token or the chain's native coin. Pass `token: \"native\"` for ETH (or chain-native asset) or an ERC-20 contract address. Returns amount, decimals, symbol, and USD value.",
+        inputSchema: getTokenBalanceInput.shape,
+    }, handler(getTokenBalance));
+    server.registerTool("get_token_price", {
+        description: "Fetch the USD price of a token via DefiLlama. Pass `token: \"native\"` for the chain's native asset (ETH on ethereum/arbitrum, MATIC on polygon) or an ERC-20 contract address. Prefer this over get_swap_quote for pure price lookups — no wallet or liquidity simulation needed.",
+        inputSchema: getTokenPriceInput.shape,
+    }, handler(getTokenPriceTool));
+    server.registerTool("resolve_ens_name", {
+        description: "Resolve an ENS name (e.g. vitalik.eth) to an Ethereum address via mainnet ENS resolver. Returns null if unregistered.",
+        inputSchema: resolveNameInput.shape,
+    }, handler(resolveName));
+    server.registerTool("reverse_resolve_ens", {
+        description: "Reverse-resolve an Ethereum address to its primary ENS name. Returns null if no primary name is set.",
+        inputSchema: reverseResolveInput.shape,
+    }, handler(reverseResolve));
+    server.registerTool("prepare_native_send", {
+        description: "Build an unsigned native-coin send transaction (ETH on Ethereum/Arbitrum). Pass a human-readable amount like \"0.5\".",
+        inputSchema: prepareNativeSendInput.shape,
+    }, txHandler(prepareNativeSend));
+    server.registerTool("prepare_token_send", {
+        description: "Build an unsigned ERC-20 transfer transaction. Pass `amount: \"max\"` to send the full balance (resolved at build time).",
+        inputSchema: prepareTokenSendInput.shape,
+    }, txHandler(prepareTokenSend));
+    // ---- Module 8: Compound V3 ----
+    server.registerTool("get_compound_positions", {
+        description: "Fetch Compound V3 (Comet) positions for a wallet across supported markets (cUSDCv3, cUSDTv3, cWETHv3, etc.). Returns base-token supplied/borrowed, per-asset collateral, and USD totals.",
+        inputSchema: getCompoundPositionsInput.shape,
+    }, handler(getCompoundPositions));
+    server.registerTool("prepare_compound_supply", {
+        description: "Build an unsigned Compound V3 supply transaction (base token or collateral). If an ERC-20 approve() is required first, it is returned as the outer tx with supply in `.next`.",
+        inputSchema: prepareCompoundSupplyInput.shape,
+    }, txHandler(buildCompoundSupply));
+    server.registerTool("prepare_compound_withdraw", {
+        description: "Build an unsigned Compound V3 withdraw transaction. Pass `amount: \"max\"` to withdraw the full supplied balance.",
+        inputSchema: prepareCompoundWithdrawInput.shape,
+    }, txHandler(buildCompoundWithdraw));
+    server.registerTool("prepare_compound_borrow", {
+        description: "Build an unsigned Compound V3 borrow transaction — encoded as withdraw(baseToken) beyond the user's supplied balance. Base token is resolved on-chain from the Comet.",
+        inputSchema: prepareCompoundBorrowInput.shape,
+    }, txHandler(buildCompoundBorrow));
+    server.registerTool("prepare_compound_repay", {
+        description: "Build an unsigned Compound V3 repay transaction — encoded as supply(baseToken) against an outstanding borrow. Includes an approve step if needed. Pass `amount: \"max\"` for a full repay.",
+        inputSchema: prepareCompoundRepayInput.shape,
+    }, txHandler(buildCompoundRepay));
+    // ---- Module 9: Morpho Blue ----
+    server.registerTool("get_morpho_positions", {
+        description: "Fetch Morpho Blue positions for a wallet across a given list of market IDs. Each market is identified by a bytes32 id (keccak256 of its MarketParams). Returns per-market supplied/borrowed assets and collateral.",
+        inputSchema: getMorphoPositionsInput.shape,
+    }, handler(getMorphoPositions));
+    server.registerTool("prepare_morpho_supply", {
+        description: "Build an unsigned Morpho Blue supply transaction (deposits loan token for yield). Market params are resolved on-chain from the market id. Includes an approve step if needed.",
+        inputSchema: prepareMorphoSupplyInput.shape,
+    }, txHandler(buildMorphoSupply));
+    server.registerTool("prepare_morpho_withdraw", {
+        description: "Build an unsigned Morpho Blue withdraw transaction (withdraws supplied loan token). Explicit amount only — \"max\" is not supported; query your position first.",
+        inputSchema: prepareMorphoWithdrawInput.shape,
+    }, txHandler(buildMorphoWithdraw));
+    server.registerTool("prepare_morpho_borrow", {
+        description: "Build an unsigned Morpho Blue borrow transaction. Requires pre-existing collateral in the market.",
+        inputSchema: prepareMorphoBorrowInput.shape,
+    }, txHandler(buildMorphoBorrow));
+    server.registerTool("prepare_morpho_repay", {
+        description: "Build an unsigned Morpho Blue repay transaction. Includes an approve step if needed. Explicit amount only — \"max\" is not supported.",
+        inputSchema: prepareMorphoRepayInput.shape,
+    }, txHandler(buildMorphoRepay));
+    server.registerTool("prepare_morpho_supply_collateral", {
+        description: "Build an unsigned Morpho Blue supplyCollateral transaction — adds collateral to a market. Includes an approve step if needed.",
+        inputSchema: prepareMorphoSupplyCollateralInput.shape,
+    }, txHandler(buildMorphoSupplyCollateral));
+    server.registerTool("prepare_morpho_withdraw_collateral", {
+        description: "Build an unsigned Morpho Blue withdrawCollateral transaction — removes collateral from a market. Explicit amount only.",
+        inputSchema: prepareMorphoWithdrawCollateralInput.shape,
+    }, txHandler(buildMorphoWithdrawCollateral));
+    // ---- Module 10: Capability requests (agent → maintainers) ----
+    server.registerTool("request_capability", {
+        description: "File a capability request against the recon-crypto-mcp GitHub repository when the user asks for something this server cannot do " +
+            "(e.g. an unsupported protocol, chain, token, or missing tool). " +
+            "USE ONLY AFTER confirming no existing tool can accomplish the task. " +
+            "By default this returns a pre-filled GitHub issue URL — NO data is transmitted; the user must click through to submit. " +
+            "If the operator has configured RECON_FEEDBACK_ENDPOINT, it posts directly to that proxy instead. " +
+            "Rate-limited per install (30s between calls, 3/hour, 10/day, 7-day dedupe on identical summaries). " +
+            "Write clear, actionable summaries — this lands in a real issue tracker read by humans.",
+        inputSchema: requestCapabilityInput.shape,
+    }, handler(requestCapability));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("[recon-crypto-mcp] fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/modules/balances/index.d.ts

@@ -0,0 +1,20 @@
+import type { GetTokenBalanceArgs, ResolveNameArgs, ReverseResolveArgs } from "./schemas.js";
+import type { TokenAmount } from "../../types/index.js";
+/**
+ * Fetch the balance of an arbitrary token (ERC-20 by address, or the chain's native coin).
+ * Returns `{ ...TokenAmount, zero: true }` when the wallet has no balance.
+ */
+export declare function getTokenBalance(args: GetTokenBalanceArgs): Promise<TokenAmount>;
+/**
+ * ENS forward resolution: name → address. Only Ethereum mainnet ENS is supported (viem routes
+ * through the mainnet resolver even for subdomains used cross-chain).
+ */
+export declare function resolveName(args: ResolveNameArgs): Promise<{
+    name: string;
+    address: `0x${string}` | null;
+}>;
+/** ENS reverse resolution: address → primary name. Returns null if the address has no primary name set. */
+export declare function reverseResolve(args: ReverseResolveArgs): Promise<{
+    address: `0x${string}`;
+    name: string | null;
+}>;

package/dist/modules/balances/index.js

@@ -0,0 +1,49 @@
+import { getClient } from "../../data/rpc.js";
+import { erc20Abi } from "../../abis/erc20.js";
+import { makeTokenAmount } from "../../data/format.js";
+import { getTokenPrice } from "../../data/prices.js";
+import { NATIVE_SYMBOL } from "../../config/contracts.js";
+/**
+ * Fetch the balance of an arbitrary token (ERC-20 by address, or the chain's native coin).
+ * Returns `{ ...TokenAmount, zero: true }` when the wallet has no balance.
+ */
+export async function getTokenBalance(args) {
+    const wallet = args.wallet;
+    const chain = args.chain;
+    const client = getClient(chain);
+    if (args.token === "native") {
+        const [balance, price] = await Promise.all([
+            client.getBalance({ address: wallet }),
+            getTokenPrice(chain, "native"),
+        ]);
+        return makeTokenAmount(chain, "0x0000000000000000000000000000000000000000", balance, 18, NATIVE_SYMBOL[chain], price);
+    }
+    const token = args.token;
+    const [balance, decimals, symbol] = await client.multicall({
+        contracts: [
+            { address: token, abi: erc20Abi, functionName: "balanceOf", args: [wallet] },
+            { address: token, abi: erc20Abi, functionName: "decimals" },
+            { address: token, abi: erc20Abi, functionName: "symbol" },
+        ],
+        allowFailure: false,
+    });
+    const price = await getTokenPrice(chain, token);
+    return makeTokenAmount(chain, token, balance, Number(decimals), symbol, price);
+}
+/**
+ * ENS forward resolution: name → address. Only Ethereum mainnet ENS is supported (viem routes
+ * through the mainnet resolver even for subdomains used cross-chain).
+ */
+export async function resolveName(args) {
+    const client = getClient("ethereum");
+    const address = await client.getEnsAddress({ name: args.name });
+    return { name: args.name, address };
+}
+/** ENS reverse resolution: address → primary name. Returns null if the address has no primary name set. */
+export async function reverseResolve(args) {
+    const client = getClient("ethereum");
+    const address = args.address;
+    const name = await client.getEnsName({ address });
+    return { address, name };
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/balances/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/balances/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAyB;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAuB,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAuB,CAAC;IAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAEhC,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YACtC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC;SAC/B,CAAC,CAAC;QACH,OAAO,eAAe,CACpB,KAAK,EACL,4CAA6D,EAC7D,OAAO,EACP,EAAE,EACF,aAAa,CAAC,KAAK,CAAC,EACpB,KAAK,CACN,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAsB,CAAC;IAC1C,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;QACzD,SAAS,EAAE;YACT,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE;YAC5E,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE;YAC3D,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE;SAC1D;QACD,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,eAAe,CACpB,KAAK,EACL,KAAK,EACL,OAAiB,EACjB,MAAM,CAAC,QAAQ,CAAC,EAChB,MAAgB,EAChB,KAAK,CACN,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAqB;IAErB,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,2GAA2G;AAC3G,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAwB;IAExB,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAwB,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/modules/balances/schemas.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export declare const getTokenBalanceInput: z.ZodObject<{
+    wallet: z.ZodString;
+    /** "native" for the chain's native coin, otherwise an ERC-20 contract address. */
+    token: z.ZodUnion<[z.ZodLiteral<"native">, z.ZodString]>;
+    chain: z.ZodDefault<z.ZodEnum<[string, ...string[]]>>;
+}, "strip", z.ZodTypeAny, {
+    chain: string;
+    wallet: string;
+    token: string;
+}, {
+    wallet: string;
+    token: string;
+    chain?: string | undefined;
+}>;
+export declare const resolveNameInput: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export declare const reverseResolveInput: z.ZodObject<{
+    address: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    address: string;
+}, {
+    address: string;
+}>;
+export type GetTokenBalanceArgs = z.infer<typeof getTokenBalanceInput>;
+export type ResolveNameArgs = z.infer<typeof resolveNameInput>;
+export type ReverseResolveArgs = z.infer<typeof reverseResolveInput>;

package/dist/modules/balances/schemas.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { SUPPORTED_CHAINS } from "../../types/index.js";
+const chainEnum = z.enum(SUPPORTED_CHAINS);
+const walletSchema = z.string().regex(/^0x[a-fA-F0-9]{40}$/);
+const tokenSchema = z.union([
+    z.literal("native"),
+    z.string().regex(/^0x[a-fA-F0-9]{40}$/),
+]);
+export const getTokenBalanceInput = z.object({
+    wallet: walletSchema,
+    /** "native" for the chain's native coin, otherwise an ERC-20 contract address. */
+    token: tokenSchema,
+    chain: chainEnum.default("ethereum"),
+});
+export const resolveNameInput = z.object({
+    name: z.string().min(3),
+});
+export const reverseResolveInput = z.object({
+    address: walletSchema,
+});
+//# sourceMappingURL=schemas.js.map

package/dist/modules/balances/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/modules/balances/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAoD,CAAC,CAAC;AAC/E,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAC7D,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC;IAC1B,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,YAAY;IACpB,kFAAkF;IAClF,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,YAAY;CACtB,CAAC,CAAC"}

package/dist/modules/bitcoin/index.d.ts

@@ -0,0 +1,26 @@
+import type { GetBitcoinBalanceArgs, GetBitcoinPortfolioArgs } from "./schemas.js";
+export interface BitcoinBalance {
+    chain: "bitcoin";
+    address: string;
+    /** Confirmed balance in satoshis as a decimal string (JSON-safe). */
+    amountSats: string;
+    /** Unconfirmed (mempool-only) balance delta in satoshis. Can be negative for pending spends. */
+    unconfirmedSats: string;
+    /** Confirmed balance expressed in BTC (human-readable). */
+    formattedBtc: string;
+    symbol: "BTC";
+    decimals: 8;
+    priceUsd?: number;
+    valueUsd?: number;
+}
+export declare function getBitcoinBalance(args: GetBitcoinBalanceArgs): Promise<BitcoinBalance>;
+export interface BitcoinPortfolio {
+    chain: "bitcoin";
+    addresses: string[];
+    balances: BitcoinBalance[];
+    totalSats: string;
+    totalBtc: string;
+    totalUsd?: number;
+    priceUsd?: number;
+}
+export declare function getBitcoinPortfolio(args: GetBitcoinPortfolioArgs): Promise<BitcoinPortfolio>;