aeX402 — Cross-Chain DeFi MCP: LINQ, AMM, Bridge, AI

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Agent MCP for DeFi: cross-chain LINQ fan-out, AMM quotes/swaps, bridge, AI. Solana+EVM. Free+x402.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "aeX402 — Cross-Chain DeFi MCP: LINQ, AMM, Bridge, AI": {
      "url": "https://rpc.aex402.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (33)

• solana_getBalance

  Get SOL balance for a wallet address (in lamports). Divide by 1e9 for SOL.

  Parameters:

  • address (required) — string — Solana wallet address (base58)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_getAccountInfo

  Get raw account info (owner, lamports, data) for any Solana address.

  Parameters:

  • address (required) — string — Account address (base58)
  • encoding — string — Data encoding: base64 (default) or jsonParsed

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_getTokenAccountsByOwner

  Get all SPL token accounts owned by a wallet. Returns mint, balance, decimals for each token.

  Parameters:

  • owner (required) — string — Wallet address (base58)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_getTransaction

  Get full transaction details by signature, including instructions, logs, and status.

  Parameters:

  • signature (required) — string — Transaction signature (base58)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_getLatestBlockhash

  Get latest blockhash for transaction building. Returns blockhash + lastValidBlockHeight.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_getSignaturesForAddress

  Get recent transaction signatures for an address. Returns up to 20 most recent.

  Parameters:

  • address (required) — string — Account address (base58)
  • limit — number — Max signatures to return (default 20, max 1000)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_sendTransaction

  Submit a signed transaction to the network. Returns transaction signature.

  Parameters:

  • transaction (required) — string — Base64-encoded signed transaction

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_getSlot

  Get the current slot number.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• aex402_listPools

  List all AeX402 AMM pools on Solana. Returns pool addresses with basic info (mints, balances, fee, amp). Pools are 1024-byte accounts owned by program 3AMM53MsJZy2Jvf7PeHHga3bsGjWV4TSaYz29WUtcdje.

  Parameters:

  • minTvl — number — Minimum TVL in lamports to filter (default 0)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• aex402_getPool

  Get detailed AeX402 pool info: token mints, balances, fee, amplification, LP supply, analytics (OHLCV candles), circuit breaker status.

  Parameters:

  • address (required) — string — Pool account address (base58)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• aex402_quote

  Get a swap quote from an AeX402 pool. Calculates expected output, price impact, and fees without executing.

  Parameters:

  • pool (required) — string — Pool account address (base58)
  • inputMint (required) — string — Input token mint address
  • amount (required) — number — Input amount in atomic units (lamports/smallest unit)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• aex402_rh_pool

  Get the live state of the aeX402 AMM on Robinhood Chain (EVM 4663) — the diamond-contract port of the Solana AMM. The AMM is the set of GRADUATED launchpad coins whose pools are seeded in-diamond on the canonical launchpad (0xED2F); this enumerates them live by scanning VPoolGraduated events + reading each pool's reserves, so it tracks reality as coins graduate. Returns graduatedPools[] (poolId, token, reserves, TVL), graduatedPoolCount, and status ("live" | "no-graduated-pools" | "unknown"), plus the legacy standalone 0xA1F6 USDG/WETH pool (legacy-drained). Distinct from the chain's Uniswap-fork DEX. No inputs.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• launch_token

  Launch a memecoin on the aeX402 launchpad on Robinhood Chain (EVM 4663) for a FIXED pump.fun-style bonding curve (1B supply, starts 0.0001 USDG, graduates at 10,000 USDG raised, quoted in USDG). You supply only identity — name + ticker (+ optional description/image/links). DEFAULT (custodial): the aeX402 backend SIGNS + SUBMITS the createVPool tx for you, so a claude.ai user with NO WALLET can launch in one call; returns {ok,status,txHash,vpId}. Optionally pass `creator` (a 0x address) to record as the coin owner. Pass build:true instead to get an UNSIGNED tx {to,value,data} to submit yourself (non-custodial — that requires `creator` and makes you the on-chain creator). A custodial call SIMULATES first, so a failure burns no gas: status "gated" means createVPool reverts in simulation (cause not determined — likeliest are the ticker still being claimed by a bonding coin or this vpId being taken; see `detail`/`revertData`), and status "unreachable" means the chain could not be reached, which is retryable. The launchpad is NOT chain-gated: createVPool simulates clean from an arbitrary sender (measured 2026-09-25).

  Parameters:

  • name (required) — string — Token name, 1..32 bytes (e.g. "Fork Meme")
  • ticker (required) — string — Ticker / symbol, 1..16 bytes (e.g. "FMEME")
  • pad — string — OPTIONAL aeX402 launchpad slug the coin is launched on. Its vpId then starts with that pad's tag, so the pad lists it. Applies on BOTH the custodial (default) and build:true paths
  • build — boolean — If true, return an UNSIGNED tx to submit yourself (non-custodial) instead of the backend launching for you. Default false.
  • image — string — Image URL (https:// or ipfs:// only) — off-chain metadata
  • links — array — Up to 3 links (https:// or ipfs:// only) — off-chain metadata
  • creator — string — OPTIONAL 0x EVM address recorded as the coin owner (and seeds the vpId). REQUIRED only when build:true (then it is the self-signing on-chain creator).
  • description — string — Short description (<=256 chars) — off-chain metadata

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_buildTransfer

  Build a SOL or SPL token transfer instruction. Returns instruction JSON (programId, keys, data) for client-side TX construction and signing.

  Parameters:

  • from (required) — string — Sender wallet address (base58)
  • to (required) — string — Recipient address (base58)
  • amount (required) — number — Amount in atomic units (lamports for SOL, smallest unit for SPL)
  • mint — string — SPL token mint address. Omit for native SOL transfer.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• aex402_buildSwap

  Build an AeX402 AMM swap action. Fetches live pool state, computes output with slippage protection, returns all instruction parameters and account addresses for client signing.

  Parameters:

  • pool (required) — string — Pool account address (base58)
  • inputMint (required) — string — Input token mint address
  • amount (required) — number — Input amount in atomic units
  • userWallet (required) — string — User wallet address (for account derivation)
  • slippageBps — number — Max slippage in basis points (default 50 = 0.5%)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• agent_delegate

  Delegate a task to an independent specialist AI agent session. The delegate runs with full tool access and returns its response. Useful for breaking complex tasks into subtasks. Max depth: 3.

  Parameters:

  • message (required) — string — Task or question for the delegate agent
  • role — string — Role for new agent (e.g. "Solana pool analyst", "route optimizer"). Ignored if resuming session.
  • model — string — Model ID or alias (default: gpt-4o-mini)
  • session — string — Existing session ID to resume, or omit to create new session

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ai_chat

  Send a chat completion request to the aeX402 AI Router. Free tier: 3 calls/day. Paid: deducts credits based on token usage.

  Parameters:

  • messages (required) — array — Chat messages array [{role: "user"|"system"|"assistant", content: "..."}]
  • model — string — Model ID or alias: gpt-4o-mini (default), gpt-4o, claude-sonnet, claude-haiku, llama-70b, llama-8b, gemini-flash
  • max_tokens — number — Maximum tokens to generate (model-dependent default)
  • temperature — number — Sampling temperature (0-2)
  • reasoning_effort — string — low | medium | high — ask a reasoning-capable model to think harder. The chain-of-thought comes back in the tool result _meta ("com.aex402/reasoning").

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_rpc

  Call ANY Solana-compatible JSON-RPC method by name — full RPC surface beyond the typed solana_* tools (getProgramAccounts, getBlock, getEpochInfo, simulateTransaction, ...). Defaults to Solana mainnet; pass network:slonana to query Slonana (rpc.slonana.com), which additionally exposes RPC methods no other network has: getAlpenglowHealth (consensus migration status), getBridgeStatus, getAexchanRelays, getValidatorStats, quote. (listSvmNetworks/enableSvmNetwork/disableSvmNetwork/setNetworkRpcUrl also exist but are inert API-compat stubs — listSvmNetworks always reports one hardcoded network and the enable/disable/set calls ignore their arguments and return true; verified in source, not live network-management controls.) For tools that exist ONLY on Slonana's MCP server with no RPC-method equivalent (the aea_* agent registry), use mcp_call instead.

  Parameters:

  • method (required) — string — Solana RPC method name, e.g. getEpochInfo
  • params — array — Positional params array (method-specific). Omit for no params.
  • network — string — solana (default/mainnet-beta) or slonana

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• mcp_call

  Call a tool on another MCP server this RPC federates with, for tools that have no equivalent in solana_rpc/evm_rpc (no underlying JSON-RPC method — e.g. Slonana's aea_list_services/aea_resolve agent registry). Known servers: slonana. Call that server's tools/list first if you don't know its tool names.

  Parameters:

  • server (required) — string — Federated server name. One of: slonana
  • tool — string — Tool name on that server, e.g. aea_list_services. Omit both tool and arguments to list that server's tools instead.
  • arguments — object — Arguments for the tool call, per that server's own schema.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• evm_rpc

  Call ANY EVM JSON-RPC method on a supported chain — eth_getBalance, eth_call, eth_blockNumber, eth_sendRawTransaction, eth_getLogs, ... Chains: robinhood (4663) / robinhood-testnet (46630), hyperevm (999), ethereum (1), base (8453), stable (988), plasma (9745), tempo (4217), codex (81224), arc (5042, Circle mainnet).

  Parameters:

  • method (required) — string — EVM RPC method name, e.g. eth_getBalance
  • params — array — Positional params array (method-specific). Omit for no params.
  • network — string — Chain slug: robinhood (default; legacy mainnet alias accepted), robinhood-testnet, hyperevm, ethereum/eth, base, stable/tether, plasma, tempo, codex, or arc (Circle mainnet)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• mcp_linq

  Primary LINQ-style MCP workflow tool. Run one bounded MCP call: fan out up to 32 READ-ONLY tool calls across chains, then compose the combined result with fluent chains like results.selectMany(...).where(...).groupBy(...).orderByDesc(...).take(...), JSON pipeline steps, or reducers. Use mcp_linq when you want one aggregate answer instead of N tool calls.

  Parameters:

  • calls (required) — array — Read-only MCP tool calls to run. Each call has {id?, tool, args?, pick?}. pick is a dot path into that call output; [] flattens arrays.
  • linq — string — LINQ-like query string compiled into pipeline steps. Supports fluent dot chaining and query clauses. .where()/.map()/.select() bodies AND .orderBy()/.orderByDesc()/.distinctBy()/.groupBy() keys are all real expressions — ternaries, &&/||, comparisons, arithmetic, member/index access, object/array literals, and a small method whitelist (.includes/.startsWith/.endsWith/.toLowerCase/.toUpperCase/.trim/.slice/.indexOf/.split/.join, Math.min/max/round/floor/ceil/abs, String()/Number()/Boolean()) all work, e.g. results.map(r => r.ok ? ({chain: r.id, height: r.output}) : ({chain: r.id, height: -1})), or ranking by a COMPUTED score: results.where(r => r.ok).orderByDesc(r => r.output.volume24h * r.output.priceChangePct).take(10) — the ranking key is not limited to a bare field. Fluent example: results.selectMany(r => r.output.programs[]).where(p => p.type in ("token","canonical-token")).groupBy(p => p._chain, assets=count(), activity=sum(activity)).orderByDesc(assets).take(5). Clause example: from results[] | expand output.programs[] | where type in ("token","canonical-token") | group by _chain as chain select assets=count(), activity=sum(activity) | order by assets desc | take 5.
  • reduce — object — Named reductions to compute from subcall outputs. Example: {"total":{"op":"sum","path":"results[].picked"},"top":{"op":"top","path":"results[]","sortBy":"picked","limit":5}}.
  • pipeline — array — LINQ-style chained transforms over the raw batch result. Each step feeds the next. Ops: from, expand, where, select/project, groupBy, orderBy/sort, take/limit, skip, distinct, count, sum, avg, min, max, first, top. Example: [{"op":"from","path":"results[]"},{"op":"expand","path":"output.programs[]"},{"op":"where","path":"type","in":["token","canonical-token"]},{"op":"groupBy","by":"_chain","as":"chain","aggregates":{"tokens":{"op":"count"},"activity":{"op":"sum","path":"activity"}}},{"op":"orderBy","path":"tokens","dir":"desc"},{"op":"take","count":5}].
  • concurrency — number — Parallelism for subcalls (default 8, max 12).
  • ignoreFailures — boolean — When reduce/pipeline/linq is used, a failed subcall is normally still reported in `failures` alongside the aggregate result, since a `.where(ok)`-style query would otherwise make it invisible. Set true to suppress that and get back only {reductions?, result?} — use when you already expect some chains/calls to fail and only want whatever succeeded. Defaults to false (failures still shown) because silently dropping an error is a real information loss, not just an efficiency choice — this one is opt-in on purpose.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• bridge_quote

  Bridge/swap ANY asset across ANY chain via LI.FI (the engine behind Jumper) — e.g. Arbitrum USDC → Robinhood Chain (4663) USDG, or bridge into ETH for gas. Returns the best route (estimated output, fees, bridge used, duration) PLUS an unsigned transactionRequest (to/data/value/gasLimit) that the CALLER signs and submits on the fromChain — no keys are held here. Chains by id or key (1 Ethereum, 42161 Arbitrum, 8453 Base, 10 Optimism, 137 Polygon, 999 HyperEVM, 4663 Robinhood Chain). Tokens by symbol or 0x address.

  Parameters:

  • fromChain (required) — string — Source chain id or key, e.g. 42161 or ARB
  • toChain (required) — string — Destination chain id or key, e.g. 4663 (Robinhood Chain)
  • fromToken (required) — string — Source token symbol or 0x address, e.g. USDC
  • toToken (required) — string — Destination token symbol or 0x address, e.g. USDG or ETH
  • fromAmount (required) — string — Amount in the source token's smallest unit (e.g. 1000000 = 1 USDC at 6 decimals)
  • fromAddress (required) — string — Sender 0x address on the source chain
  • toAddress — string — Recipient on the destination chain (defaults to fromAddress)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• bridge_status

  Track a cross-chain bridge submitted via bridge_quote — returns DONE / PENDING / FAILED plus the receiving-chain tx once it completes. Pass the source-chain tx hash (and the bridge tool from the quote for a faster lookup).

  Parameters:

  • txHash (required) — string — Source-chain transaction hash from submitting the bridge tx
  • bridge — string — The bridge tool from bridge_quote (e.g. across, stargate) — optional
  • toChain — string — Destination chain id/key (optional)
  • fromChain — string — Source chain id/key (optional)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hl_info

  Query the Hyperliquid Info API — the perps/spot order-book data layer (read-only, no auth). The 'type' field selects the query: meta (perps universe + leverage), l2Book (order book for a coin), allMids (mid prices), clearinghouseState (a user's positions/margin), spotMeta, meta+assetCtxs (mark/funding/OI), candleSnapshot, and more. For type:metaAndAssetCtxs specifically: the raw response is TWO PARALLEL top-level arrays (universe names, asset contexts) correlated only by array position — do not try to read/scan it directly for '200+ coins' style questions (funding-rate outliers, biggest open interest, highest volume). Pass rankBy instead: it joins the two arrays server-side, sorts, and returns only the top N — the correct way to answer 'what has the highest/most extreme funding/OI/volume right now'.

  Parameters:

  • type (required) — string — Info request type, e.g. meta, l2Book, allMids, clearinghouseState, metaAndAssetCtxs
  • dir — string — rankBy only: asc | desc (default desc — highest rankBy value first)
  • coin — string — Coin symbol for l2Book/candleSnapshot (e.g. BTC, ETH)
  • user — string — 0x address for user-scoped queries (clearinghouseState, openOrders, userFills)
  • limit — number — rankBy only: how many ranked rows to return (default 20, max 100)
  • rankBy — string — type:metaAndAssetCtxs ONLY. One of funding | fundingAbs | openInterest | volume. Joins each coin's name to its funding/OI/volume, drops delisted coins, sorts, and returns {ranked, rankBy, dir, totalCoins} instead of the raw two-array response. Use fundingAbs for "biggest funding outlier either direction" (ranks by |funding|); use funding for "most positive/most negative" specifically (with dir).
  • endTime — number — candleSnapshot only: end time epoch ms (default: now)
  • interval — string — candleSnapshot only: candle interval, e.g. 1m,5m,15m,1h,4h,1d
  • startTime — number — candleSnapshot only: start time epoch ms (default: endTime minus 500 intervals)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• api_get

  GET any public read endpoint of rpc.aex402.com: /health, /credits?wallet=, /pumpfun?limit=, /pumpfun/tuple?mint=, /security/<pool>, /market/list, /sniper/leaderboard, /sniper/bets?id=, /settlement/<sig>, /settlements/<wallet>, /ai/models, /ai/stats, /leaderboard, /openapi.json, /llms.txt, /rh/pools (Robinhood), /hl/pools (HyperEVM), /base/pools (Base Uniswap v3), /eth/pools (Ethereum Uniswap v3), /arb/pools (Arbitrum Uniswap v3)

  Parameters:

  • path (required) — string — Endpoint path including query string, e.g. /security/9Wq.. or /pumpfun?limit=5

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• discover_programs

  Discover on-chain programs/contracts across every chain this RPC supports (Solana, Slonana SVM, Robinhood, HyperEVM, Ethereum, Base, Stable, Plasma, Tempo, Codex). Returns a curated seed MERGED with programs/contracts AUTO-DISCOVERED from recent block activity (refreshed hourly) — each carries an `activity` count of recent invocations/calls; entries with type "discovered" were seen live on-chain but not yet named. Use this to learn what is actually active on-chain right now, then describe_program to introspect any specific address.

  Parameters:

  • chain — string — Filter to one chain: solana | slonana | robinhood | hyperevm | ethereum | base | stable | plasma | tempo | codex. Omit or "all" for every chain.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• describe_program

  Introspect ANY specific program/contract address on a chain. Solana/Slonana: returns executable, owner, data size, and whether it is a known program. EVM: RPC-verified facts (is-contract, code size, ERC-20 name/symbol/decimals, EIP-1967 proxy → implementation) PLUS Blockscout explorer enrichment when available.

  Parameters:

  • chain (required) — string — solana | slonana | robinhood | hyperevm | ethereum | base | stable | plasma | tempo | codex
  • address (required) — string — Program id (base58, Solana/Slonana) or contract address (0x…, EVM)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• reconstruct_abi

  Reconstruct a PARTIAL function/event interface for an EVM contract on a supported EVM chain from its BYTECODE — no source or verification needed. Extracts PUSH4 function selectors + recent event topic0 hashes and resolves the ones public signature DBs (openchain/4byte) know to human signatures. Works on UNVERIFIED contracts because bytecode is ground truth, but it is NOT a full ABI: novel/proprietary selectors DBs have never seen stay unresolved (decompile for those). Use it to understand what an unknown contract does before trusting behavior-based guesses.

  Parameters:

  • chain (required) — string — robinhood | hyperevm | ethereum | base | stable | plasma | tempo | codex
  • address (required) — string — EVM contract address (0x…). For a proxy, pass the implementation for the real logic.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_tokens

  Search the live token/NFT census for Robinhood Chain (4663) and HyperEVM (999) by symbol or name. Returns matching tokens with address, standard (erc20/erc721/erc1155), decimals, holders, market cap, and — for HyperEVM canonical tokens — live spot price + 24h volume. The census is refreshed hourly (canonical tokens from Hyperliquid spotMeta, top tokens from Blockscout, spam-filtered). Use this instead of discover_programs when you want a specific asset (e.g. "USDC on hyperevm", "stablecoins on robinhood") rather than the whole list.

  Parameters:

  • chain — string — robinhood | hyperevm. Omit to search both.
  • limit — number — Max results (default 20).
  • query — string — Symbol or name substring, case-insensitive (e.g. "usdc", "hype"). Omit to list the top of the census.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• discovery_health

  Report the freshness and health of the cross-chain program/token discovery pipeline: when the hourly cron last ran, how many programs/tokens each chain scan produced, and which scans failed. Use this to check whether discover_programs / search_tokens data is current before relying on it.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• payment_help

  How to pay for API access (x402 micropayments) — the complete self-serve guide for agents: current prices, every accepted asset/chain (USDC/USDT/SOL/ANSEM on Solana, ETH/USDG on Robinhood Chain, USDC/HYPE on HyperEVM), the merchant addresses, step-by-step topup → session-token → API-key flow, and how to attach credentials to MCP calls. This tool is FREE and NEVER rate-limited — call it when you hit a 402 / rate limit to convert into a paid session ($0.01 minimum buys 100 calls, no signup).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search

  Search the aeX402 universe by keyword: tokens (Robinhood Chain + HyperEVM census), known programs/contracts (Solana, Robinhood, HyperEVM, Slonana), and live AeX402 AMM pools. Returns a result list; pass a result id to the fetch tool for full detail. Use the specialist tools (search_tokens, discover_programs, aex402_listPools) when you already know the entity type.

  Parameters:

  • query (required) — string — Keyword: token symbol/name ("usdg"), program name ("pump.fun"), contract address, or pool address.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• fetch

  Fetch the full document for one search result id (from the search tool). Accepts token:<chain>:<address>, program:<chain>:<address>, or pool:<address>. Returns the entity detail (on-chain state for pools, census entry for tokens, registry/introspection for programs) as a document.

  Parameters:

  • id (required) — string — A search result id, e.g. "pool:G5d3qFZq..." or "token:robinhood:0x5fc5..." or "program:solana:3AMM53..."

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.