NodeFlare MCP Server
Blockchain JSON-RPC for AI agents on 23 EVM chains — Ethereum, Base, BNB Chain, Arbitrum, Optimism, Avalanche, HyperEVM, Polygon, and young chains like Robinhood Chain, Plasma, Ink, Zircuit, BOB and Soneium. Served from NodeFlare's own bare-metal nodes across 5 regions.
Quick start
{
"mcpServers": {
"nodeflare": {
"command": "npx",
"args": ["-y", "nodeflare-mcp"]
}
}
}
That's it — no API key required for standard reads (block numbers, balances, transactions, eth_call).
Install as a Claude Code plugin
This repo doubles as a Claude Code plugin marketplace. Installing the plugin wires up the MCP server and a set of slash-command recipes in one step:
claude plugin marketplace add Nodeflare-app/nodeflare-mcp
claude plugin install nodeflare
Then use the recipes below (/nodeflare:balance, /nodeflare:token, …). To unlock heavy methods, export NODEFLARE_API_KEY in your shell before starting Claude Code (free key, 3M CU/month).
Recipes
Ready-made slash commands bundled with the plugin:
| Recipe | What it does |
|---|---|
/nodeflare:chains [filter] | List supported chains, IDs and endpoint URLs |
/nodeflare:balance <address> [chain] [token…] | Native + ERC-20 balances, one chain or across the majors |
/nodeflare:token <token> [chain] [holder] | ERC-20 metadata (name/symbol/decimals/supply) + optional holder balance |
/nodeflare:tx <hash> [chain] | Fetch a transaction + receipt and explain what it did |
/nodeflare:logs <contract> [chain] [from] [to] | Fetch and summarise a contract's recent event logs |
/nodeflare:gas [chain | compare] | Current gas price on a chain, or a cheapest-first comparison |
Access tiers
The server picks its access tier from the environment:
| Env var | Tier |
|---|---|
| (none) | Free public endpoints — standard read methods, rate-limited per IP |
NODEFLARE_API_KEY | Free/paid key — heavy methods, 3,000,000 compute units/month free (get one) |
X402_PRIVATE_KEY | Pay per call with x402 — heavy methods (eth_getLogs, trace_*, debug_*) are paid from this wallet in USDC on Base, Polygon or Arbitrum, ~$0.001/call. No account needed; gas is covered by the facilitator. |
With an x402 wallet, a blocked heavy method is retried automatically as a paid call — the tool result includes "_x402": "settled via x402" when a payment settled on-chain.
{
"mcpServers": {
"nodeflare": {
"command": "npx",
"args": ["-y", "nodeflare-mcp"],
"env": { "X402_PRIVATE_KEY": "0x…" }
}
}
}
Use a dedicated agent wallet holding a small USDC balance — never your main wallet.
Tools
| Tool | Description |
|---|---|
list_chains | The 23 supported chains with chain IDs and endpoints |
get_block_number | Latest block number |
get_balance | Native-token balance of an address |
get_transaction_receipt | Transaction receipt by hash |
eth_call | Read-only contract call |
get_logs | Contract event logs (heavy — key or x402 wallet) |
rpc_call | Any JSON-RPC method on any supported chain |
get_transaction | Transaction by hash (from, to, value, input) |
get_block | Block by number/tag, optional full transactions |
get_gas_price | Current gas price + EIP-1559 priority fee |
get_token_balance | ERC-20 balance, raw + human-readable |
get_token_metadata | ERC-20 name, symbol, decimals, total supply |
Links
- NodeFlare — free API key, 3M CU/month
- x402 pay-per-request — pricing and how it works
- Docs · Status · Discord
MIT