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

Related MCP server: gpu-bridge-mcp-server

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

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

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

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