TollNode

Base wallet balance API and MCP for AI agents

TollNode gives Claude, Cursor or any AI agent the ETH and USDC balance of any Base address, read live from the chain with the block it was read at, from $0.003 per lookup.

Ask in plain words, like 'does this wallet hold at least 5 USDC on Base', and get a yes or no with the numbers.

No subscription · Sign-up optional · From $0.003 per call · Charged only when it works · No account needed

Claude Code

Does 0x7a3c...8a1c hold any USDC or ETH on Base?

TollNode · base-wallet-balance$0.003 · 1 lookup · 1 s

FieldValue
ETH0
USDC0
ChainBase
Block57,885,638

Real result.

Works in Claude Code, Cursor, Codex, VS Code and any MCP agent.

What your agent gets from a balance check

Every result is structured JSON your agent can sort, filter, summarize or turn into a spreadsheet.

What people ask their AI to do with it

Use it as a Base wallet balance MCP server in Claude, Cursor or Codex

Connect once. Then just ask.

Paste this into Claude Code, Cursor or Codex. It connects TollNode and gives your agent a small wallet. Add a few dollars of USDC and you're done.

terminal
npx agentcash add https://tollnode.com

Copy for your AI agent

Paste this into your agent so it knows what this node does and how to call it.

prompt
You can use TollNode's Base wallet balance node. Call POST https://tollnode.com/api/v1/nodes/base-wallet-balance with address (required). The price is one flat price per call, charged only when it returns a result. Over MCP, call the "base-wallet-balance" tool; use list_models to see prices. Return results as tables when I ask for lists.

Price

$0.003

per lookup

Charged only when a call returns a result. Failed or empty calls cost $0.

Base wallet balance without running your own tools

FAQ

Is this an official chain API?
No. TollNode reads the Base chain itself and returns the balance as plain data. There is no account or RPC key to set up.
Can I use it as a Base wallet balance MCP server in Claude?
Yes. Add https://tollnode.com/mcp in Claude Code, Claude Desktop or Cursor, and the "base-wallet-balance" tool appears with its fields and price.
Which tokens does it cover?
ETH and USDC on Base only. Other chains, other tokens and transaction history are not covered.
Can it move funds?
No. It only reads balances. It never holds or sends money.
What do I send?
A Base (EVM) address: 0x followed by 40 hex characters.
What if nothing comes back?
You're not charged. TollNode only collects payment when a usable result is returned, and your agent can try a different input.
How do I pay for Base wallet balance?
Your agent sends the request, gets an HTTP 402 with the exact price (from $0.003 per call), signs a USDC payment on Base and retries. Or use an account balance with an API key. Either way you are charged only when a result comes back.
What does the Base wallet balance response look like?
Structured JSON, with the fields listed in the cards above. Your agent can sort it, filter it, summarize it or turn it into a table or spreadsheet.

Ready in a minute

Connect your AI
For developers: endpoint, inputs and an example response

POST https://tollnode.com/api/v1/nodes/base-wallet-balance

Input

FieldTypeNotes
address*stringA Base (EVM) address, 0x followed by 40 hex characters

Example response

{
  "eth": "0",
  "usdc": "0",
  "block": 57885638,
  "chain": "Base",
  "address": "0x7a3c9e1b5d2f4a6c8e0b1d3f5a7c9e2b4d6f8a1c",
  "usdcContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Also described in the OpenAPI file and llms.txt. Setup for every app: Agents & MCP.