Skip to content

live/stable

MCP server and llms.txt

Give any AI assistant Robinhood Chain as tools, and give any agent the chain's facts in a format it reads natively.

The Recensus MCP server exposes Robinhood Chain to Claude, Cursor and other MCP clients: ETH and USDG balances, transfers, gas in ETH, x402 payments in USDG, and transaction explanations. It runs on your machine with a key you configure; Recensus never sees it. Every write simulates first, respects the daily spend limits and an allowlist, and carries the label. The x402 payments it makes carry the label in their EIP-3009 nonce, so they count under your wallet although someone else sends the transaction.

Gas is ETH, so the configured wallet needs a little ETH besides whatever it spends. Its ceilings, each over any 24 hours: SPEND_LIMIT_USD_PER_DAY for the dollar stablecoins (USDG, each at $1); SPEND_LIMIT_ETH_PER_DAY (0.01 by default) for ETH, which has no dollar price here and so is limited in ETH itself, counting native sends and the gas fee of every send; and the x402 cap, at most $0.10 a payment (X402_MAX_USD_PER_PAYMENT) and $1 a day (X402_MAX_USD_PER_DAY) for recensus_pay402, which you can raise or lower in the server's config.

Before it signs, a send holds its value plus the most its fee can be (gas limit times max fee per gas) against the ETH ceiling, so an RPC endpoint that quotes a ruinous fee gets a refusal, not your ETH; once the receipt is in, the hold becomes what the send cost. A reverted send still counts its fee.

npx -y @recensus/mcp
{
    "mcpServers": {
      "recensus": {
        "command": "npx",
        "args": ["-y", "@recensus/mcp"],
        "env": {
          "RPC_HTTP": "https://rpc.mainnet.chain.robinhood.com",
          "PRIVATE_KEY": "0x...",
          "AGENT_NAME": "my-assistant",
          "AUTONOMOUS": "false",
          "SPEND_LIMIT_USD_PER_DAY": "50",
          "SPEND_LIMIT_ETH_PER_DAY": "0.01"
        }
      }
    }
}
ToolWhat it does
recensus_whoamiThe agent ID, wallet, ETH and USDG balances and the spend limits this server is configured with.
recensus_gasCurrent gas price and roughly what a transfer costs at it, in ETH: gas on Robinhood Chain is paid in ETH.
recensus_balanceETH, USDG and any token, for the configured wallet or any address.
recensus_transferSend ETH, USDG or another token. Simulates first, counts against the daily limits, labelled.
recensus_approveApprove a spender. Warns on an unlimited allowance.
recensus_pay402Pay an x402 "exact" challenge in USDG from a public https URL: signs the EIP-3009 authorization locally with the label in its nonce, and the seller settles it; the payment counts under your agent, the payer.
recensus_tx_statusWhether a transaction is pending, mined or reverted, with its fee in ETH.
recensus_explain_txWhat a transaction did, in plain English, from its logs.
recensus_my_statsThis agent's own numbers from the Recensus API.

llms.txt

/llms.txt is a short index of Robinhood Chain for AI agents; /llms-full.txt carries every verified contract address with decimals — USDG, Permit2, Multicall3, the ERC-4337 EntryPoints and the ERC-8004 registries — the RPC endpoints with their measured limits, the explorer, ETH as gas, block time and confirmations, and the label spec. Both are generated from the same configuration the indexer uses.