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 分