Nodeflare MCP Server

Blockchain JSON-RPC on 23 EVM chains for AI agents - free tier, API key, or x402 pay-per-call.

Local serverstdio

What is the Nodeflare MCP server?

Connect Nodeflare to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Blockchain JSON-RPC on 23 EVM chains for AI agents - free tier, API key, or x402 pay-per-call. The nodeflare mcp server is what makes that connection.

What the server does

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.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • list_chains — The 23 supported chains with chain IDs and endpoints
  • get_block_number — Latest block number (decimal + hex)
  • get_balance — Native-token balance — raw wei + human-readable amount in the chain's currency
  • 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

Credentials and setup notes

Configuration is passed through the environment: X402_PRIVATE_KEY, NODEFLARE_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Where it fits

Plenty of monitoring and observability servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Nodeflare's toolset — list_chains, get_block_number, get_balance and 11 more — is a fair guide to whether it matches your workflow. It is maintained by Nodeflare-app; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Nodeflare.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
list_chainsThe 23 supported chains with chain IDs and endpoints
get_block_numberLatest block number (decimal + hex)
get_balanceNative-token balance — raw wei + human-readable amount in the chain's currency
get_transaction_receiptTransaction receipt by hash
eth_callRead-only contract call
get_logsContract event logs (heavy — key or x402 wallet)
rpc_callAny JSON-RPC method on any supported chain
get_transactionTransaction by hash (from, to, value, input)
get_blockBlock by number/tag, optional full transactions
get_gas_priceCurrent gas price + EIP-1559 priority fee
get_token_balanceERC-20 balance, raw + human-readable
get_token_metadataERC-20 name, symbol, decimals, total supply
resolve_ensENS name → address (forward) or address → primary ENS name (reverse)
get_token_priceCurrent USD price of an ERC-20 (DefiLlama, keyless) — price, symbol, confidence

How to install the Nodeflare MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
X402_PRIVATE_KEYCredential the server authenticates with.Yes
NODEFLARE_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Nodeflare to list chains.
  • Use Nodeflare to get block number.
  • Use Nodeflare to get balance.

Frequently asked questions

It connects Nodeflare to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (list_chains, get_block_number, get_balance, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Nodeflare directly.