solana_getBalance

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

Parameters1

address

string

required

Solana wallet address (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Solana wallet address (base58)"
    }
  },
  "required": [
    "address"
  ]
}

solana_getAccountInfo

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

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Account address (base58)"
    },
    "encoding": {
      "type": "string",
      "description": "Data encoding: base64 (default) or jsonParsed",
      "default": "base64"
    }
  },
  "required": [
    "address"
  ]
}

solana_getTokenAccountsByOwner

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

Parameters1

owner

string

required

Wallet address (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string",
      "description": "Wallet address (base58)"
    }
  },
  "required": [
    "owner"
  ]
}

solana_getTransaction

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

Parameters1

signature

string

required

Transaction signature (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "signature": {
      "type": "string",
      "description": "Transaction signature (base58)"
    }
  },
  "required": [
    "signature"
  ]
}

solana_getLatestBlockhash

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

solana_getSignaturesForAddress

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

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Account address (base58)"
    },
    "limit": {
      "type": "number",
      "description": "Max signatures to return (default 20, max 1000)",
      "default": 20
    }
  },
  "required": [
    "address"
  ]
}

solana_sendTransaction

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

Parameters1

transaction

string

required

Base64-encoded signed transaction

Raw schema

{
  "type": "object",
  "properties": {
    "transaction": {
      "type": "string",
      "description": "Base64-encoded signed transaction"
    }
  },
  "required": [
    "transaction"
  ]
}

solana_getSlot

Get the current slot number.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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.

Parameters1

minTvl

number

optional

Minimum TVL in lamports to filter (default 0)

Raw schema

{
  "type": "object",
  "properties": {
    "minTvl": {
      "type": "number",
      "description": "Minimum TVL in lamports to filter (default 0)",
      "default": 0
    }
  }
}

aex402_getPool

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

Parameters1

address

string

required

Pool account address (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Pool account address (base58)"
    }
  },
  "required": [
    "address"
  ]
}

aex402_quote

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

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "pool": {
      "type": "string",
      "description": "Pool account address (base58)"
    },
    "inputMint": {
      "type": "string",
      "description": "Input token mint address"
    },
    "amount": {
      "type": "number",
      "description": "Input amount in atomic units (lamports/smallest unit)"
    }
  },
  "required": [
    "pool",
    "inputMint",
    "amount"
  ]
}

aex402_rh_pool

Get the live state of the aeX402 AMM deployed on Robinhood Chain (EVM 4663) — the diamond-contract port of the Solana AMM. Returns the USDG/WETH pool reserves, spot price, LP supply, and fee, read live via eth_call. This is the aeX402 AMM on RH (distinct from the chain's Uniswap-fork DEX). No inputs.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

solana_buildTransfer

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

Parameters4

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

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Sender wallet address (base58)"
    },
    "to": {
      "type": "string",
      "description": "Recipient address (base58)"
    },
    "amount": {
      "type": "number",
      "description": "Amount in atomic units (lamports for SOL, smallest unit for SPL)"
    },
    "mint": {
      "type": "string",
      "description": "SPL token mint address. Omit for native SOL transfer."
    }
  },
  "required": [
    "from",
    "to",
    "amount"
  ]
}

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.

Parameters5

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

Raw schema

{
  "type": "object",
  "properties": {
    "pool": {
      "type": "string",
      "description": "Pool account address (base58)"
    },
    "inputMint": {
      "type": "string",
      "description": "Input token mint address"
    },
    "amount": {
      "type": "number",
      "description": "Input amount in atomic units"
    },
    "slippageBps": {
      "type": "number",
      "description": "Max slippage in basis points (default 50 = 0.5%)"
    },
    "userWallet": {
      "type": "string",
      "description": "User wallet address (for account derivation)"
    }
  },
  "required": [
    "pool",
    "inputMint",
    "amount",
    "userWallet"
  ]
}

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.

Parameters4

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

Raw schema

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

ai_chat

Send a chat completion request to an AI model (GPT-4o, Claude, Llama, Gemini). Uses OpenRouter. Free tier: 3 calls/day. Paid: deducts credits based on token usage.

Parameters5

model	string	optional	Model ID or alias: gpt-4o-mini (default), gpt-4o, claude-sonnet, claude-haiku, llama-70b, llama-8b, gemini-flash
messages	array	required	Chat messages array [{role: "user"\|"system"\|"assistant", content: "..."}]
max_tokens	number	optional	Maximum tokens to generate (model-dependent default)
temperature	number	optional	Sampling temperature (0-2)
reasoning_effort	string	optional	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").

Raw schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Model ID or alias: gpt-4o-mini (default), gpt-4o, claude-sonnet, claude-haiku, llama-70b, llama-8b, gemini-flash"
    },
    "messages": {
      "type": "array",
      "description": "Chat messages array [{role: \"user\"|\"system\"|\"assistant\", content: \"...\"}]",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "description": "Message role: system, user, or assistant"
          },
          "content": {
            "type": "string",
            "description": "Message content"
          }
        },
        "required": [
          "role",
          "content"
        ]
      }
    },
    "max_tokens": {
      "type": "number",
      "description": "Maximum tokens to generate (model-dependent default)"
    },
    "temperature": {
      "type": "number",
      "description": "Sampling temperature (0-2)"
    },
    "reasoning_effort": {
      "type": "string",
      "description": "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\")."
    }
  },
  "required": [
    "messages"
  ]
}

solana_rpc

Call ANY Solana JSON-RPC method by name — full RPC surface beyond the typed solana_* tools (getProgramAccounts, getBlock, getEpochInfo, simulateTransaction, ...).

Parameters2

method	string	required	Solana RPC method name, e.g. getEpochInfo
params	array	optional	Positional params array (method-specific). Omit for no params.

Raw schema

{
  "type": "object",
  "properties": {
    "method": {
      "type": "string",
      "description": "Solana RPC method name, e.g. getEpochInfo"
    },
    "params": {
      "type": "array",
      "description": "Positional params array (method-specific). Omit for no params."
    }
  },
  "required": [
    "method"
  ]
}

evm_rpc

Call ANY EVM JSON-RPC method on a supported chain — eth_getBalance, eth_call, eth_blockNumber, eth_sendRawTransaction, eth_getLogs, ... Chains: robinhood-chain mainnet (4663) / testnet (46630), hyperevm (999, Hyperliquid L1 EVM).

Parameters3

method	string	required	EVM RPC method name, e.g. eth_getBalance
params	array	optional	Positional params array (method-specific). Omit for no params.
network	string	optional	Chain slug: mainnet (Robinhood, default), testnet (Robinhood testnet), or hyperevm (HyperEVM 999)

Raw schema

{
  "type": "object",
  "properties": {
    "method": {
      "type": "string",
      "description": "EVM RPC method name, e.g. eth_getBalance"
    },
    "params": {
      "type": "array",
      "description": "Positional params array (method-specific). Omit for no params."
    },
    "network": {
      "type": "string",
      "description": "Chain slug: mainnet (Robinhood, default), testnet (Robinhood testnet), or hyperevm (HyperEVM 999)",
      "default": "mainnet"
    }
  },
  "required": [
    "method"
  ]
}

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.

Parameters7

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

Raw schema

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

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).

Parameters4

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

Raw schema

{
  "type": "object",
  "properties": {
    "txHash": {
      "type": "string",
      "description": "Source-chain transaction hash from submitting the bridge tx"
    },
    "bridge": {
      "type": "string",
      "description": "The bridge tool from bridge_quote (e.g. across, stargate) — optional"
    },
    "fromChain": {
      "type": "string",
      "description": "Source chain id/key (optional)"
    },
    "toChain": {
      "type": "string",
      "description": "Destination chain id/key (optional)"
    }
  },
  "required": [
    "txHash"
  ]
}

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.

Parameters3

type	string	required	Info request type, e.g. meta, l2Book, allMids, clearinghouseState, metaAndAssetCtxs
coin	string	optional	Coin symbol for l2Book/candleSnapshot (e.g. BTC, ETH)
user	string	optional	0x address for user-scoped queries (clearinghouseState, openOrders, userFills)

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Info request type, e.g. meta, l2Book, allMids, clearinghouseState, metaAndAssetCtxs"
    },
    "coin": {
      "type": "string",
      "description": "Coin symbol for l2Book/candleSnapshot (e.g. BTC, ETH)"
    },
    "user": {
      "type": "string",
      "description": "0x address for user-scoped queries (clearinghouseState, openOrders, userFills)"
    }
  },
  "required": [
    "type"
  ]
}

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

Parameters1

path

string

required

Endpoint path including query string, e.g. /security/9Wq.. or /pumpfun?limit=5

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path including query string, e.g. /security/9Wq.. or /pumpfun?limit=5"
    }
  },
  "required": [
    "path"
  ]
}

discover_programs

Discover on-chain programs/contracts across every chain this RPC supports (Solana, Slonana SVM, Robinhood Chain EVM 4663, HyperEVM 999). Returns a curated seed (DEXes, token programs, launchpads, stablecoins) MERGED with programs 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.

Parameters1

chain

string

optional

Filter to one chain: solana | slonana | robinhood | hyperevm. Omit or "all" for every chain.

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "description": "Filter to one chain: solana | slonana | robinhood | hyperevm. Omit or \"all\" for every chain.",
      "default": "all"
    }
  }
}

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 (Robinhood/HyperEVM): RPC-verified facts (is-contract, code size, ERC-20 name/symbol/decimals, EIP-1967 proxy → implementation) PLUS Blockscout explorer enrichment (verified-source flag, contract name, token holders/market cap, resolved proxy) when available.

Parameters2

chain	string	required	solana \| slonana \| robinhood \| hyperevm
address	string	required	Program id (base58, Solana/Slonana) or contract address (0x…, EVM)

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "description": "solana | slonana | robinhood | hyperevm"
    },
    "address": {
      "type": "string",
      "description": "Program id (base58, Solana/Slonana) or contract address (0x…, EVM)"
    }
  },
  "required": [
    "chain",
    "address"
  ]
}

reconstruct_abi

Reconstruct a function/event interface for ANY EVM contract (Robinhood 4663 / HyperEVM 999) from its BYTECODE — no source or verification needed. Extracts PUSH4 function selectors + recent event topic0 hashes and resolves them to human signatures via public signature databases (openchain/4byte). Works on UNVERIFIED contracts because bytecode is ground truth. Use this to understand what an unknown contract actually does before trusting behavior-based guesses. Novel/unresolved selectors are the contract's proprietary logic (decompile for those).

Parameters2

chain	string	required	robinhood \| hyperevm
address	string	required	EVM contract address (0x…). For a proxy, pass the implementation for the real logic.

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "description": "robinhood | hyperevm"
    },
    "address": {
      "type": "string",
      "description": "EVM contract address (0x…). For a proxy, pass the implementation for the real logic."
    }
  },
  "required": [
    "chain",
    "address"
  ]
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Symbol or name substring, case-insensitive (e.g. \"usdc\", \"hype\"). Omit to list the top of the census."
    },
    "chain": {
      "type": "string",
      "description": "robinhood | hyperevm. Omit to search both."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 20).",
      "default": 20
    }
  }
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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 on Solana, ETH/USDG on Robinhood Chain, USDC 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).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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.

Parameters1

query

string

required

Keyword: token symbol/name ("usdg"), program name ("pump.fun"), contract address, or pool address.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keyword: token symbol/name (\"usdg\"), program name (\"pump.fun\"), contract address, or pool address."
    }
  },
  "required": [
    "query"
  ]
}

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.

Parameters1

id

string

required

A search result id, e.g. "pool:G5d3qFZq..." or "token:robinhood:0x5fc5..." or "program:solana:3AMM53..."

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A search result id, e.g. \"pool:G5d3qFZq...\" or \"token:robinhood:0x5fc5...\" or \"program:solana:3AMM53...\""
    }
  },
  "required": [
    "id"
  ]
}

aeX402 RPC (Solana + Robinhood Chain)

com.aex402/rpc (Model Context Protocol) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

solana_getBalance

solana_getAccountInfo

solana_getTokenAccountsByOwner

solana_getTransaction

solana_getLatestBlockhash

solana_getSignaturesForAddress

solana_sendTransaction

solana_getSlot

aex402_listPools

aex402_getPool

aex402_quote

aex402_rh_pool

solana_buildTransfer

aex402_buildSwap

agent_delegate

ai_chat

solana_rpc

evm_rpc

bridge_quote

bridge_status

hl_info

api_get

discover_programs

describe_program

reconstruct_abi

search_tokens

discovery_health

payment_help

search

fetch

Install

Remote endpoint