Nodeflare MCP server
io.github.Nodeflare-app/nodeflare-mcp·v0.8.0·1 starsBlockchain JSON-RPC on 23 EVM chains for AI agents - free tier, API key, or x402 pay-per-call.
1 stars52 downloads/wk
Reviews
Write oneNobody has reviewed Nodeflare yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Nodeflare tools (21, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
check_token_safetyRisk-check an ERC-20 before trading it: metadata, contract + ownership status, upgradeable-proxy detection, holder concentration, and a transfer/honeypot simulation → risk signals + a score. The deep checks (concentration, honeypot) are heavy: needs NODEFLARE_API_KEY or X402_PRIVATE_KEY. Works on young chains (Zircuit, Robinhood, Plasma, Ink) that big indexers leave empty.
compare_gasCompare current gas price ACROSS chains in one call — gwei per chain, cheapest first, so an agent can pick where to transact. Defaults to the majors (eth, base, arb, op, bnb, polygon); pass chains to override.
eth_callwrite actionExecute a read-only contract call (eth_call) and return the raw result.
get_balanceGet the native-token balance of an address — raw wei plus a human-readable amount in the chain's native currency. The address may be an ENS name (e.g. 'vitalik.eth').
get_blockGet a block by number or tag (e.g. 'latest', 'finalized', or a hex number). Set fullTransactions to include full tx objects instead of hashes.
get_block_numberGet the latest block number on a chain (decimal and hex).
get_gas_priceGet current gas pricing on a chain: base gas price and the suggested priority fee (EIP-1559), both in wei (hex).
get_logsFetch contract event logs (eth_getLogs). Heavy method: needs NODEFLARE_API_KEY or an x402 wallet (X402_PRIVATE_KEY) — costs ~$0.001 via x402.
get_multichain_balancesGet native + ERC-20 token balances for one address across many of the 23 EVM chains in a SINGLE call — including young chains (Robinhood, Plasma, Ink) that Alchemy/Moralis omit. With an x402 wallet (X402_PRIVATE_KEY) this is paid per request (~$0.0003/chain); otherwise it uses the free public tier.
get_token_allowancesERC-20 approvals a wallet has granted (what it approved and for how much) across many of the 23 EVM chains in ONE call — including young chains (Robinhood, Plasma, Ink) that revoke.cash-style tools skip. Scans Approval logs, reads the live allowance, drops revoked ones, flags unlimited approvals. Heavy: needs NODEFLARE_API_KEY or X402_PRIVATE_KEY.
get_token_balanceGet an ERC-20 token balance for an address, returned both raw and human-readable (uses the token's decimals and symbol).
get_token_metadataGet ERC-20 token metadata: name, symbol, decimals and total supply (raw + human-readable).
get_token_priceCurrent USD price of an ERC-20 token from DefiLlama (free, keyless): price + symbol + confidence, or null for unlisted/thin-market tokens. Well-covered chains only (eth, base, bnb, arb, op, avax, polygon, linea, mantle, sonic, unichain, sei, cronos).
get_transactionGet a transaction by its hash (from, to, value, input, block, gas).
get_transaction_receiptGet the receipt of a transaction by hash (status, logs, gas used).
get_wallet_reportThe full agent-ready 'know this wallet' report in ONE call: native + ERC-20 balances (USD-priced), a rolled-up total + top holdings, AND the active token approvals (revoke risk) across many of the 23 EVM chains — including young chains big indexers skip. The approvals half is heavy: needs NODEFLARE_API_KEY or X402_PRIVATE_KEY (balances/USD come back either way).
list_chainsList the 23 EVM chains NodeFlare serves, with chain IDs and endpoint URLs.
onchain_answerOnchain Answer Engine: ask a plain-English question about any wallet or token across the 23 EVM chains and get back a CITED verdict in one call — 'is token 0x… on <chain> a scam?', 'what does wallet 0x… hold?'. NodeFlare plans the on-chain lookups, runs them on its own nodes, and synthesizes a sourced answer. Paid: needs NODEFLARE_API_KEY or X402_PRIVATE_KEY (no free anonymous tier — it runs on a
resolve_ensResolve an ENS name to an address (forward), or a 0x-address to its primary ENS name (reverse). ENS is read from Ethereum mainnet.
rpc_callMake any JSON-RPC call on any supported chain. Heavy methods (eth_getLogs, trace_*, debug_*) need NODEFLARE_API_KEY or an x402 wallet.
simulate_transactionTransaction pre-flight on one chain: will this tx revert (and why), how much gas, and which tokens/ETH move? The asset-change tracing is heavy: needs NODEFLARE_API_KEY or X402_PRIVATE_KEY (revert/gas come back either way). Built for agents checking a tx before broadcasting.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 54 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
How Nodeflare compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 77/100
- higher than 50% of 48,255 servers
- Tools
- 21
- the typical server has 7
- Tools that change things
- 5%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 52
- more than 43% of 12,191 servers with a package
What its tools let an agent do: 20 read · 1 change
Install Nodeflare in Claude Code, Cursor or VS Code
Runs npx -y nodeflare-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add nodeflare-mcp -- npx -y nodeflare-mcp
What the publisher says
From the Nodeflare repository's README, as published. We do not edit it. Read it on GitHub
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).
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.
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 nodeflareThen use the recipes below (/nodeflare:balance, /nodeflare:token, …). To unlock heavy methods, export NODEFLAREAPIKEY in your shell before starting Claude Code (free key, 2M CU/month).
Recipes
Ready-made slash commands bundled with the plugin:
Access tiers
The server picks its access tier from the environment:
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
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Nodeflare: common questions
- Is Nodeflare MCP server safe?
- Mostly: it is graded B (77/100). Read the Nodeflare safety report
- How do I install Nodeflare?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Nodeflare need an API key?
- Yes. The registry entry asks for
NODEFLARE_API_KEY,X402_PRIVATE_KEY. - Is Nodeflare maintained?
- The last commit was 95 days ago (2026-08-01). The latest release is v0.8.0.
- How does Nodeflare compare with other MCP servers?
- safety score 77/100 (higher than 50% of 48,255 servers); tools 21 (the typical server has 7); tools that change things 5% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.