Skip to main content
Glama

NodeFlare MCP Server

nodeflare-mcp 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).

Every tool's chain argument accepts a slug (eth, base, arb), a name (ethereum, arbitrum, bsc), or a numeric chain ID (1, 8453) — so agents don't have to know NodeFlare's internal slugs.

Related MCP server: dRPC Agent Skills

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, 2M 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, 2,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 (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

resolve_ens

ENS name → address (forward) or address → primary ENS name (reverse)

get_token_price

Current USD price of an ERC-20 (DefiLlama, keyless) — price, symbol, confidence

compare_gas

Gas price across chains in one call, cheapest first, so an agent picks where to transact

get_multichain_balances

Native + ERC-20 balances for one address across many of the 23 chains in one call (incl. young chains); pay-per-call with an x402 wallet

get_token_allowances

ERC-20 approvals a wallet has granted across chains, with revoked ones dropped and unlimited approvals flagged (heavy — key or x402)

get_wallet_report

Full "know this wallet" report: balances + USD total + top holdings + active approvals, across chains (approvals half is heavy)

check_token_safety

Risk-check an ERC-20 before trading: ownership, proxy detection, holder concentration, honeypot simulation → risk score (deep checks heavy)

simulate_transaction

Tx pre-flight: will it revert, gas used, and which tokens/ETH move (asset-change tracing is heavy)

onchain_answer

Onchain Answer Engine — plain-English question about a wallet/token → a cited verdict in one call (key or x402; no free tier)

Address arguments (get_balance, get_token_balance, eth_call) also accept ENS names — pass vitalik.eth and it's resolved to an address automatically.

get_multichain_balances can also auto-discover the tokens an address holds (discover: true, x402 wallet required). Discovered tokens are USD-priced via DefiLlama and, on price-covered chains, filtered by value: pass minUsd (default 0.01) to set the worthless-token cutoff, includeSpam: true to keep unpriced tokens, or includeDust: true to keep sub-1e-9 balances.

Prompts (any MCP client)

The server also exposes the recipes as MCP prompts, so guided workflows show up in any MCP client (Cursor, Windsurf, …), not just the Claude Code plugin: chains, balance, token, tx, logs, gas.

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • 30 pay-per-call APIs for AI agents: compliance, trade, safety, web, data. USDC on Base via x402.

  • Pay-per-call x402 gateway: agent tools, OpenAI-compatible LLM, market data, RPC, security audits.

  • Read-only on-chain intel for AI agents on Base: balances, tokens, gas, tx status. No API keys.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Nodeflare-app/nodeflare-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server