Use when the user needs raw blockchain JSON-RPC — contract reads, native balances, blocks, transactions, logs, gas estimates — across 40 chains through one gateway, with no node and no API key.
- GitHub stars
- 390
Install
/plugin install rpc@blockrun-mcpRun it inside Claude Code after adding the marketplace with /plugin marketplace add BlockRunAI/blockrun-mcp.
Contents
Discovered from sourceSkills 1
Multi-chain RPC — every supported chain, one tool
blockrun_rpc POSTs a standard JSON-RPC 2.0 body to /v1/rpc/{network}. Flat $0.0030 per call ($0.002 base + the $0.001 transaction fee). A JSON-RPC batch array charges per element but pays the flat fee only once — $0.002 × n + $0.001, so a batch of 3 costs $0.0070 where three separate calls cost $0.0090. Batch whenever you can. Settlement in USDC via x402. Responses are cached briefly server-side for identical read calls (X-Cache: HIT is free of upstream latency but still billed).
When to use which tool
| Question | Tool |
|---|---|
| "What's ETH trading at?" | blockrun_price (free) |
| "PEPE/WETH pool liquidity?" | blockrun_dex (free) |
| "What's this wallet holding?" | blockrun_rpc (labels: no tool since Surf was retired 2026-09-06) |
"Call balanceOf(0x...) on this ERC-20" | blockrun_rpc |
| "Latest block / tx receipt / event logs / gas price" | blockrun_rpc |
| "Solana account info / slot / signatures" | blockrun_rpc |
Networks
EVM (use eth_* methods):
| Key | Chain | Key | Chain | |
|---|---|---|---|---|
ethereum | Ethereum | zksync | zkSync Era | |
base | Base | berachain | Berachain | |
arbitrum | Arbitrum One | unichain | Unichain | |
arbitrum-nova | Arbitrum Nova | monad | Monad | |
optimism | Optimism | chiliz | Chiliz | |
polygon | Polygon | moonbeam | Moonbeam | |
bsc | BNB Smart Chain | aurora | Aurora | |
avalanche | Avalanche C-Chain | flare | Flare | |
fantom | Fantom | oasis | Oasis Sapphire | |
cronos | Cronos | kaia | Kaia (Klaytn) | |
celo | Celo | sonic | Sonic | |
gnosis | Gnosis | xdc | XDC Network | |
abstract | Abstract | hyperevm | HyperEVM | |
plume | Plume | ronin | Ronin | |
rootstock | Rootstock (RSK) |
Non-EVM (chain-native methods):
| Key | Chain | Method family |
|---|---|---|
solana | Solana | getSlot, getBalance, getAccountInfo, getSignaturesForAddress |
bitcoin | Bitcoin | getblockchaininfo, getblockcount, getrawtransaction |
litecoin / dogecoin / bitcoin-cash / zcash | UTXO chains | Bitcoin-style RPC |
near | NEAR | status, query |
sui | Sui | sui_getLatestCheckpointSequenceNumber, suix_getBalance |
ripple | XRP Ledger | account_info, ledger |
polkadot / kusama | Substrate | chain_getHeader, state_getStorage |
Unknown-but-wellformed slugs pass through to the Tatum gateway untouched — newly added chains work without an MCP update. A bad slug returns HTTP 400 with the supported list (no charge).
Recipes
ERC-20 balance (eth_call):
blockrun_rpc({
network: "base",
method: "eth_call",
params: [{
to: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // USDC on Base
data: "0x70a08231000000000000000000000000<ADDRESS_NO_0x_PADDED_TO_32B>"
}, "latest"]
})
Native balance: method: "eth_getBalance", params: ["0x...", "latest"]
Tx receipt: method: "eth_getTransactionReceipt", params: ["0x<txhash>"]
Event logs: method: "eth_getLogs", params: [{ fromBlock, toBlock, address, topics }] — keep ranges small; huge ranges are rejected upstream (no charge).
Gas: method: "eth_gasPrice" / eth_estimateGas
Solana token account: network: "solana", method: "getTokenAccountsByOwner", params: ["<owner>", {"mint": "<mint>"}, {"encoding": "jsonParsed"}]
Batch (charged per element, flat fee paid once — 3 calls = $0.0070, vs $0.0090 sent separately):
blockrun_rpc({ network: "ethereum", body: [
{ jsonrpc: "2.0", id: 1, method: "eth_blockNumber" },
{ jsonrpc: "2.0", id: 2, method: "eth_gasPrice" },
{ jsonrpc: "2.0", id: 3, method: "eth_chainId" }
]})
Failure semantics
- Upstream timeout / 5xx → no charge, retry safe.
- Malformed body / bad network → HTTP 400, no charge.
- JSON-RPC-level errors (e.g. revert on
eth_call) come back insideresult.error— the call is charged (the node did the work).
Sponsors
Details
- Marketplace
- BlockRunAI/blockrun-mcp
- Source
- skills/rpc
- Category
- Community
