English Français العربية

io.github.Nodeflare-app/nodeflare-mcp

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package nodeflare-mcp
Claude Code 
claude mcp add nodeflare-mcp -e 'NODEFLARE_API_KEY=<your nodeflare_api_key>' -e 'X402_PRIVATE_KEY=<your x402_private_key>' -- npx -y nodeflare-mcp@0.8.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "nodeflare-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "nodeflare-mcp@0.8.0"
            ],
            "env": {
                "NODEFLARE_API_KEY": "<your nodeflare_api_key>",
                "X402_PRIVATE_KEY": "<your x402_private_key>"
            }
        }
    }
}

متغيرات البيئة

  • NODEFLARE_API_KEY سري Optional NodeFlare API key (free at nodeflare.app) — unlocks heavy methods and higher limits
  • X402_PRIVATE_KEY سري Optional EVM private key of a wallet holding USDC on Base/Polygon/Arbitrum — heavy methods are paid per call (~$0.001) via x402

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. NodeFlare MCP Server
  2. Quick start
  3. Install as a Claude Code plugin
  4. Recipes
  5. Access tiers
  6. Tools
  7. Prompts (any MCP client)
  8. Links

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 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:

RecipeWhat 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 varTier
(none)Free public endpoints — standard read methods, rate-limited per IP
NODEFLARE_API_KEYFree/paid key — heavy methods, 2,000,000 compute units/month free (get one)
X402_PRIVATE_KEYPay 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

ToolDescription
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
compare_gasGas price across chains in one call, cheapest first, so an agent picks where to transact
get_multichain_balancesNative + 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_allowancesERC-20 approvals a wallet has granted across chains, with revoked ones dropped and unlimited approvals flagged (heavy — key or x402)
get_wallet_reportFull "know this wallet" report: balances + USD total + top holdings + active approvals, across chains (approvals half is heavy)
check_token_safetyRisk-check an ERC-20 before trading: ownership, proxy detection, holder concentration, honeypot simulation → risk score (deep checks heavy)
simulate_transactionTx pre-flight: will it revert, gas used, and which tokens/ETH move (asset-change tracing is heavy)
onchain_answerOnchain 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

الأسئلة الشائعة

ما هو io.github.Nodeflare-app/nodeflare-mcp؟

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

كيف أثبّت io.github.Nodeflare-app/nodeflare-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add nodeflare-mcp -e 'NODEFLARE_API_KEY=<your nodeflare_api_key>' -e 'X402_PRIVATE_KEY=<your x402_private_key>' -- npx -y nodeflare-mcp@0.8.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Nodeflare-app/nodeflare-mcp إلى مفتاح API؟

نعم. يتطلب NODEFLARE_API_KEY, X402_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.Nodeflare-app/nodeflare-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Nodeflare-app/nodeflare-mcp؟

ينشره Nodeflare-app. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.