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