basebalance.cloud — x402 RPC & MCP gateway: Base RPC
Paid JSON-RPC to Base over MCP: 10 requests per minute free, then $0.50 per 10k. Comes with failover, cache and a ledger.
claude mcp add --transport http basebalance https://basebalance.cloud/mcpWhat basebalance.cloud — x402 RPC & MCP gateway does
The server exposes Base JSON-RPC to your agent through MCP. The free tier covers 10 requests per minute; beyond that you pay in USDC at $0.50 per 10k requests. Failover between nodes, response caching and a usage ledger are built in.
It connects over HTTP transport at https://basebalance.cloud/mcp. In Claude that is one command: claude mcp add --transport http basebalance https://basebalance.cloud/mcp. Cursor and GitHub Copilot take a JSON config entry in their MCP settings file.
Payment runs in USDC, so a funded wallet is needed before the first paid request. Without it you get the free 10 requests per minute and nothing past that. Worth knowing if your agent fires many Base calls in a row.
What it helps with
- read Base chain state from an agent without running your own node
- stay inside the free 10 requests per minute on small jobs
- survive one RPC node going down thanks to failover
- track USDC spend through the ledger
- wire Base JSON-RPC into Cursor or Copilot with one config block
Example prompts for the agent
- Connect the basebalance MCP server and show me the current Base block number
- Query the balance of
0x...on Base through basebalance - How many requests have I spent according to the basebalance ledger?
How to install basebalance.cloud — x402 RPC & MCP gateway
Platform CLI: remote server
claude mcp add --transport http basebalance https://basebalance.cloud/mcpPlatform CLI: remote server
codex mcp add basebalancecloud-x402-rpc-mcp-gateway --url https://basebalance.cloud/mcpConfig file
{
"mcpServers": {
"basebalancecloud-x402-rpc-mcp-gateway": {
"url": "https://basebalance.cloud/mcp"
}
}
}Config file
{
"servers": {
"basebalancecloud-x402-rpc-mcp-gateway": {
"type": "http",
"url": "https://basebalance.cloud/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http basebalancecloud-x402-rpc-mcp-gateway https://basebalance.cloud/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about basebalance.cloud — x402 RPC & MCP gateway
How do I install basebalance.cloud in Claude Code?
Run claude mcp add --transport http basebalance https://basebalance.cloud/mcp. The server connects over HTTP transport and the Base RPC tools become available to the agent.
What does basebalance.cloud do?
It serves Base JSON-RPC over MCP with a free tier of 10 requests per minute and $0.50 per 10k after that. Failover, caching and a spend ledger are included.
Do I need a wallet for it to work?
The free 10 requests per minute need no payment. Paid calls require a USDC balance, otherwise requests past the limit will not go through.
