Nodeflare MCP

What Nodeflare-app/nodeflare-mcp MCP server does

Nodeflare-app/nodeflare-mcp MCP server gives an MCP client access to blockchain data and JSON-RPC operations across 23 EVM-compatible networks. Supported networks include Ethereum, Base, BNB Chain, Arbitrum, Optimism, Avalanche, HyperEVM, Polygon, Robinhood Chain, Plasma, Ink, Zircuit, BOB, and Soneium. The list_chains tool returns supported chain names, numeric IDs, and endpoint URLs.

The server covers both basic reads and higher-level analysis. Agents can retrieve blocks, transactions, receipts, native balances, ERC-20 balances and metadata, gas prices, contract call results, event logs, ENS records, and current token prices from DefiLlama. It also provides multi-chain balance checks, allowance reviews, wallet reports, token safety checks, transaction simulation, and cited answers to plain-English wallet or token questions.

How it works

Nodeflare-app/nodeflare-mcp MCP server is launched as a local stdio process. Each tool accepts a chain as a short slug, a network name, or a numeric chain ID. Address parameters for balance and contract-related tools can also use ENS names, which the server resolves automatically.

Standard read methods work without an API key, subject to public endpoint rate limits. Heavy requests, including logs, tracing, debugging, some allowance and safety checks, and related analysis, can use NODEFLARE_API_KEY. The README states that a free key includes 2,000,000 compute units per month. Alternatively, setting X402_PRIVATE_KEY enables pay-per-call settlement in USDC on Base, Polygon, or Arbitrum; the documentation advises using a separate agent wallet with a small balance.

Setup and configuration

Run the server with:

{
  "mcpServers": {
    "nodeflare": {
      "command": "npx",
      "args": ["-y", "nodeflare-mcp"]
    }
  }
}

No environment variable is needed for standard reads. Add NODEFLARE_API_KEY when the agent needs key-authorized heavy methods. Add X402_PRIVATE_KEY when it should pay for eligible requests automatically. The repository also describes a Claude Code plugin installation that registers the MCP server and slash-command recipes, but that is separate from the direct npx setup.

Tools and capabilities

Nodeflare-app/nodeflare-mcp MCP server exposes tools for:

• Chain discovery, latest block numbers, blocks, transactions, and receipts.
• Native and ERC-20 balances, token metadata, token prices, and ENS resolution.
• Read-only eth_call requests and arbitrary JSON-RPC methods through rpc_call.
• Gas price lookup and cheapest-first comparison across chains.
• Contract event logs, with heavy access requirements.
• Multi-chain balances, optional token discovery, allowances, and wallet summaries.
• Token risk checks covering ownership, proxies, holder concentration, and honeypot simulation.
• Transaction pre-flight simulation, including revert status, gas use, and asset movements.
• Plain-English onchain questions that return a cited verdict.

Multi-chain token discovery requires an x402 wallet. Its filtering options include minimum USD value, spam inclusion, and dust inclusion. The bundled MCP prompts cover chains, balances, tokens, transactions, logs, and gas workflows.