Nodeflare Mcp

io.github.Nodeflare-app由 GitHub 帳號 Nodeflare-app 發布v0.8.0更新於 Oct 24, 2026

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

已驗證STDIO僅桌面金融開發者工具

概覽

AI 產生的概覽

針對 23 條 EVM 鏈的唯讀區塊鏈 JSON-RPC 存取，讓助理查詢餘額、交易、日誌、Gas 與代幣資料。

可以做什麼
提供涵蓋 23 條 EVM 鏈的 JSON-RPC 工具：list_chains、get_block_number、get_balance、get_transaction、get_transaction_receipt、get_block、eth_call、rpc_call、get_gas_price、compare_gas、get_token_balance、get_token_metadata、get_token_price、resolve_ens 與 get_multichain_balances。較重的工具包括 get_logs、get_token_allowances、get_wallet_report、check_token_safety、simulate_transaction 與 onchain_answer。另附 MCP 提示詞與 Claude Code 斜線命令配方。
適用情境
當助理需要鏈上資料而不想自建節點時適用：查詢餘額或代幣持倉、檢視交易或合約日誌、比較各鏈 Gas，或在交易前檢查代幣與交易。
執行需求
透過 npx 在本機執行（需要 Node.js）。標準讀取不需金鑰。重型方法需要 NODEFLARE_API_KEY 或 X402_PRIVATE_KEY；後者是持有 Base、Polygon 或 Arbitrum 上 USDC 的 EVM 錢包私鑰。需要連線至 NodeFlare 端點與 DefiLlama。
安裝前請注意
X402_PRIVATE_KEY 是錢包私鑰，會授權按次自動支付 USDC（約 $0.001/次）；README 建議使用餘額很少的專用代理錢包，切勿使用主錢包。NODEFLARE_API_KEY 是機密憑證。查詢會傳送至 NodeFlare 節點，代幣價格會傳送至 DefiLlama。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Nodeflare Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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

json
{  "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:

bash
claude plugin marketplace add Nodeflare-app/nodeflare-mcpclaude 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.

json
{  "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.

Links

MIT

來源：README.md，提交 82999f5

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.8.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分