{
  "markdown": "# NodeFlare MCP Server\n\n[![nodeflare-mcp MCP server](https://glama.ai/mcp/servers/Nodeflare-app/nodeflare-mcp/badges/card.svg)](https://glama.ai/mcp/servers/Nodeflare-app/nodeflare-mcp)\n\n\nBlockchain 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](https://nodeflare.app)'s own bare-metal nodes across 5 regions.\n\n## Quick start\n\n```json\n{\n  \"mcpServers\": {\n    \"nodeflare\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"nodeflare-mcp\"]\n    }\n  }\n}\n```\n\nThat's it — no API key required for standard reads (block numbers, balances, transactions, `eth_call`).\n\nEvery 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.\n\n## Install as a Claude Code plugin\n\nThis repo doubles as a [Claude Code](https://claude.com/claude-code) plugin marketplace. Installing the plugin wires up the MCP server **and** a set of slash-command recipes in one step:\n\n```bash\nclaude plugin marketplace add Nodeflare-app/nodeflare-mcp\nclaude plugin install nodeflare\n```\n\nThen 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](https://nodeflare.app)).\n\n## Recipes\n\nReady-made slash commands bundled with the plugin:\n\n| Recipe | What it does |\n|---|---|\n| `/nodeflare:chains [filter]` | List supported chains, IDs and endpoint URLs |\n| `/nodeflare:balance <address> [chain] [token…]` | Native + ERC-20 balances, one chain or across the majors |\n| `/nodeflare:token <token> [chain] [holder]` | ERC-20 metadata (name/symbol/decimals/supply) + optional holder balance |\n| `/nodeflare:tx <hash> [chain]` | Fetch a transaction + receipt and explain what it did |\n| `/nodeflare:logs <contract> [chain] [from] [to]` | Fetch and summarise a contract's recent event logs |\n| `/nodeflare:gas [chain \\| compare]` | Current gas price on a chain, or a cheapest-first comparison |\n\n## Access tiers\n\nThe server picks its access tier from the environment:\n\n| Env var | Tier |\n|---|---|\n| *(none)* | Free public endpoints — standard read methods, rate-limited per IP |\n| `NODEFLARE_API_KEY` | Free/paid key — heavy methods, 2,000,000 compute units/month free ([get one](https://nodeflare.app)) |\n| `X402_PRIVATE_KEY` | **Pay per call with [x402](https://nodeflare.app/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. |\n\nWith 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.\n\n```json\n{\n  \"mcpServers\": {\n    \"nodeflare\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"nodeflare-mcp\"],\n      \"env\": { \"X402_PRIVATE_KEY\": \"0x…\" }\n    }\n  }\n}\n```\n\n> Use a dedicated agent wallet holding a small USDC balance — never your main wallet.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `list_chains` | The 23 supported chains with chain IDs and endpoints |\n| `get_block_number` | Latest block number (decimal + hex) |\n| `get_balance` | Native-token balance — raw wei + human-readable amount in the chain's currency |\n| `get_transaction_receipt` | Transaction receipt by hash |\n| `eth_call` | Read-only contract call |\n| `get_logs` | Contract event logs (heavy — key or x402 wallet) |\n| `rpc_call` | Any JSON-RPC method on any supported chain |\n| `get_transaction` | Transaction by hash (from, to, value, input) |\n| `get_block` | Block by number/tag, optional full transactions |\n| `get_gas_price` | Current gas price + EIP-1559 priority fee |\n| `get_token_balance` | ERC-20 balance, raw + human-readable |\n| `get_token_metadata` | ERC-20 name, symbol, decimals, total supply |\n| `resolve_ens` | ENS name → address (forward) or address → primary ENS name (reverse) |\n| `get_token_price` | Current USD price of an ERC-20 (DefiLlama, keyless) — price, symbol, confidence |\n| `compare_gas` | Gas price across chains in one call, cheapest first, so an agent picks where to transact |\n| `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 |\n| `get_token_allowances` | ERC-20 approvals a wallet has granted across chains, with revoked ones dropped and unlimited approvals flagged (heavy — key or x402) |\n| `get_wallet_report` | Full \"know this wallet\" report: balances + USD total + top holdings + active approvals, across chains (approvals half is heavy) |\n| `check_token_safety` | Risk-check an ERC-20 before trading: ownership, proxy detection, holder concentration, honeypot simulation → risk score (deep checks heavy) |\n| `simulate_transaction` | Tx pre-flight: will it revert, gas used, and which tokens/ETH move (asset-change tracing is heavy) |\n| `onchain_answer` | Onchain Answer Engine — plain-English question about a wallet/token → a cited verdict in one call (key or x402; no free tier) |\n\nAddress arguments (`get_balance`, `get_token_balance`, `eth_call`) also accept **ENS names** — pass `vitalik.eth` and it's resolved to an address automatically.\n\n`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.\n\n## Prompts (any MCP client)\n\nThe 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`.\n\n## Links\n\n- [NodeFlare](https://nodeflare.app) — free API key, 2M CU/month\n- [x402 pay-per-request](https://nodeflare.app/x402) — pricing and how it works\n- [Docs](https://nodeflare.app/docs) · [Status](https://nodeflare.app/status) · [Discord](https://discord.gg/ameHnRy2D6)\n\nMIT\n",
  "bytes": 6358,
  "sha": "1745b3f8011f2e6b406fd1639797126e2939417c39b929bea07fff0e0d9c1583",
  "repo_slug": "nodeflare-app/nodeflare-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nodeflare_app_nodeflare_mcp_49077d7e/readme"
}