# Nodeflare-app/nodeflare-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/Nodeflare-app/nodeflare-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 451  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/nodeflare-app-nodeflare-mcp

## Description
Pay-per-request JSON-RPC on 23 EVM chains (Ethereum, Base, Arbitrum, plus young chains Robinhood Chain, Plasma, Ink, Zircuit) from independent bare-metal nodes. Free reads with no key; heavy methods (ethgetLogs, trace, debug) via a free API key or x402 USDC pay-per-call on Base/Polygon/Arbitrum. In the official MCP Registry. npx -y nodeflare-mcp

## Tools
Capabilities this server exposes over MCP:

- **list_chains** — The 23 supported chains with chain IDs and endpoints
- **get_block_number** — Latest block number (decimal + hex)
- **get_balance** — Native-token balance — raw wei + human-readable amount in the chain's currency
- **get_transaction_receipt** — Transaction receipt by hash
- **eth_call** — Read-only contract call
- **get_logs** — Contract event logs (heavy — key or x402 wallet)
- **rpc_call** — Any JSON-RPC method on any supported chain
- **get_transaction** — Transaction by hash (from, to, value, input)
- **get_block** — Block by number/tag, optional full transactions
- **get_gas_price** — Current gas price + EIP-1559 priority fee
- **get_token_balance** — ERC-20 balance, raw + human-readable
- **get_token_metadata** — ERC-20 name, symbol, decimals, total supply
- **resolve_ens** — ENS name → address (forward) or address → primary ENS name (reverse)
- **get_token_price** — Current USD price of an ERC-20 (DefiLlama, keyless) — price, symbol, confidence
- **compare_gas** — Gas price across chains in one call, cheapest first, so an agent picks where to transact
- **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
- **get_token_allowances** — ERC-20 approvals a wallet has granted across chains, with revoked ones dropped and unlimited approvals flagged (heavy — key or x402)
- **get_wallet_report** — Full "know this wallet" report: balances + USD total + top holdings + active approvals, across chains (approvals half is heavy)
- **check_token_safety** — Risk-check an ERC-20 before trading: ownership, proxy detection, holder concentration, honeypot simulation → risk score (deep checks heavy)
- **simulate_transaction** — Tx pre-flight: will it revert, gas used, and which tokens/ETH move (asset-change tracing is heavy)
- **onchain_answer** — Onchain Answer Engine — plain-English question about a wallet/token → a cited verdict in one call (key or x402; no free tier)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "nodeflare-mcp": {
    "command": "npx",
    "args": ["-y","nodeflare-mcp"]
  }
}
```

## Documentation

## What Nodeflare-app/nodeflare-mcp MCP server does

Nodeflare-app/nodeflare-mcp MCP server gives an MCP client access to blockchain data and JSON-RPC operations across 23 EVM-compatible networks. Supported networks include Ethereum, Base, BNB Chain, Arbitrum, Optimism, Avalanche, HyperEVM, Polygon, Robinhood Chain, Plasma, Ink, Zircuit, BOB, and Soneium. The `list_chains` tool returns supported chain names, numeric IDs, and endpoint URLs.

The server covers both basic reads and higher-level analysis. Agents can retrieve blocks, transactions, receipts, native balances, ERC-20 balances and metadata, gas prices, contract call results, event logs, ENS records, and current token prices from DefiLlama. It also provides multi-chain balance checks, allowance reviews, wallet reports, token safety checks, transaction simulation, and cited answers to plain-English wallet or token questions.

## How it works

Nodeflare-app/nodeflare-mcp MCP server is launched as a local stdio process. Each tool accepts a chain as a short slug, a network name, or a numeric chain ID. Address parameters for balance and contract-related tools can also use ENS names, which the server resolves automatically.

Standard read methods work without an API key, subject to public endpoint rate limits. Heavy requests, including logs, tracing, debugging, some allowance and safety checks, and related analysis, can use `NODEFLARE_API_KEY`. The README states that a free key includes 2,000,000 compute units per month. Alternatively, setting `X402_PRIVATE_KEY` enables pay-per-call settlement in USDC on Base, Polygon, or Arbitrum; the documentation advises using a separate agent wallet with a small balance.

## Setup and configuration

Run the server with:

```json
{
  "mcpServers": {
    "nodeflare": {
      "command": "npx",
      "args": ["-y", "nodeflare-mcp"]
    }
  }
}
```

No environment variable is needed for standard reads. Add `NODEFLARE_API_KEY` when the agent needs key-authorized heavy methods. Add `X402_PRIVATE_KEY` when it should pay for eligible requests automatically. The repository also describes a Claude Code plugin installation that registers the MCP server and slash-command recipes, but that is separate from the direct npx setup.

## Tools and capabilities

Nodeflare-app/nodeflare-mcp MCP server exposes tools for:

- Chain discovery, latest block numbers, blocks, transactions, and receipts.
- Native and ERC-20 balances, token metadata, token prices, and ENS resolution.
- Read-only `eth_call` requests and arbitrary JSON-RPC methods through `rpc_call`.
- Gas price lookup and cheapest-first comparison across chains.
- Contract event logs, with heavy access requirements.
- Multi-chain balances, optional token discovery, allowances, and wallet summaries.
- Token risk checks covering ownership, proxies, holder concentration, and honeypot simulation.
- Transaction pre-flight simulation, including revert status, gas use, and asset movements.
- Plain-English onchain questions that return a cited verdict.

Multi-chain token discovery requires an x402 wallet. Its filtering options include minimum USD value, spam inclusion, and dust inclusion. The bundled MCP prompts cover chains, balances, tokens, transactions, logs, and gas workflows.

_Full upstream README: https://allmcps.com/mcp/nodeflare-app-nodeflare-mcp/readme_