# Chain reads (x402)

> Chain reads (x402) is a paid MCP server for crypto and web3. Pay-per-call EVM chain reads (balances, gas, blocks, logs, ENS) for AI agents via x402. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://store.agentexchange.work
- **MCP Registry name:** work.agentexchange/chain-reads
- **Categories:** [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-19

## About

The MCP server is served from the store's own domain and exposes 15 read-only EVM chain tools. The registry entry lists balances, gas and fees, blocks, transactions, logs and ENS lookups, so an agent can query chain state without holding an account or API key.

Payment happens per tool call using x402, with USDC on Base as the settlement asset according to the store page. The connection is a streamable-http remote endpoint, so no local package install is needed.

The server suits developers building agents that need on-chain data on demand and want to avoid managing subscriptions. The store page also lists unrelated third-party x402 services in a separate directory, which are not part of this server.

## Features

- **Balances and token data:** Reads account balances on EVM chains for agents that need wallet state.
- **Gas and fee queries:** Returns gas and fee information to help agents estimate transaction costs.
- **Block and transaction lookups:** Fetches blocks and transactions by reference for on-chain inspection.
- **Event log reads:** Queries contract logs so agents can check emitted events.
- **ENS resolution:** Resolves ENS names as part of chain reads.
- **Per-call x402 payment:** Each tool call is paid individually with no account or key required.

## Good for

- Letting an agent check a wallet balance before initiating a payment
- Estimating gas and fees before sending a transaction
- Looking up transaction status or block details during on-chain analysis
- Resolving ENS names inside an agent workflow
- Pulling contract event logs for monitoring or reporting

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http chain-reads https://store.agentexchange.work/chain/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://store.agentexchange.work/chain/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "chain-reads": {
      "url": "https://store.agentexchange.work/chain/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "chain-reads": {
      "type": "http",
      "url": "https://store.agentexchange.work/chain/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "chain-reads": {
      "serverUrl": "https://store.agentexchange.work/chain/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://store.agentexchange.work/chain/mcp
```

Enter a Name (for example "Chain reads (x402)"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "chain-reads": {
      "type": "http",
      "url": "https://store.agentexchange.work/chain/mcp"
    }
  }
}
```

## Tools

- `chain_native_balance`: $0.003 via x402: the core on-chain RPC read — any address's native coin balance (ETH/POL/xDAI) with live USD value and outgoing transaction count, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The high-frequency balance check wallet-tracking, settlement and trading agents poll constantly. Live from Blockscout; 6 chains vs onesource's Ethereum-only.
- `chain_block_header`: $0.005 via x402: the full header of any block — timestamp and age, transaction count, gas used vs limit with a utilization ratio and congested flag, base fee in gwei, miner and parent hash. /chain/block-number says WHERE the chain is; this says WHEN that block happened and how contested it was. Accepts a height or latest/finalized/safe. Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis.
- `chain_event_logs`: $0.005 via x402: raw event logs by contract address and/or indexed topics over a block range (eth_getLogs) — the indexing primitive. Defaults to a 25-block window and narrows automatically when a node refuses on result size, and every cap or narrowing that bit is named in the response instead of silently applied. Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis.
- `chain_fee_history`: $0.005 via x402: EIP-1559 fee history — base-fee trend over N blocks, priority-fee percentiles (10/50/90), mean block utilization, and a recommended maxFeePerGas / maxPriorityFeePerGas with the reasoning stated. A single gas number cannot tell you whether fees are rising; this can. Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis.
- `chain_confirmations`: $0.005 via x402: did this transaction land, how deep is it buried, and is it safe to treat as FINAL on this chain. Returns status, block, tip, confirmations, gas used, fee paid and log count, compared against the chain's own finality threshold (Ethereum 64, Polygon 128, OP-stack 60). A success with two confirmations is not a settled payment. Also distinguishes 'no receipt yet' from 'failed' — conf
- `chain_gas_price`: $0.002 via x402: live network gas prices (slow/average/fast, in gwei) for any chain — the pre-transaction read every trading, sniping and settlement agent makes before sending a tx to size the fee. Across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. Live from Blockscout; one paid call instead of running your own RPC.
- `chain_estimate_gas`: $0.005 via x402: estimate the gas a transaction will use (eth_estimateGas) across 6 chains — the pre-send read tx-building, trading and settlement agents make to size gas and avoid out-of-gas reverts. Pass to (+ optional from/value/data).
- `chain_transaction_status`: $0.008 via x402: look up any transaction by hash — confirmation status (success/failed/pending), block number, confirmations, value, from/to, fee paid, gas used, and decoded method. The read every settlement, trading and payment agent polls after sending a tx to confirm it landed. Across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. Live from Blockscout; one paid call instead of running you
- `chain_transaction_explain`: $0.005 via x402: decode any transaction by hash into a plain-English explanation — what actually happened (a swap, transfer, approval, mint, or contract call), who the actors are, and the full list of asset changes (every native coin and token in/out with symbol, amount and direction), plus status, fee and the decoded method. The read agents make to UNDERSTAND a tx, not just confirm it landed: for
- `chain_ens_resolve`: $0.005 via x402: resolve ENS in either direction on Ethereum — pass an ENS name (vitalik.eth) to get its 0x address, or pass a 0x address to get its primary ENS name (and avatar when set). The identity read every wallet, payment and UX agent makes to verify who it's sending to, or to display a human-readable name instead of a raw hex address. Live ENS registry; one paid call instead of running you
- `get_chain_erc20_balance`: Any wallet's balance of any ERC-20 token (USDC, USDT, DAI, or any contract) via balanceOf, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The token-balance read wallet-tracking, copy-trade, treasury and trading agents poll constantly — the most-called RPC read after native balance. Live public RPC; 6 chains vs onesource's Ethereum-only coverage.
- `get_chain_code`: Is an address a smart contract or a regular wallet (EOA)? Returns whether deployed bytecode exists and its size via eth_getCode, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The safety/identity read wallet, payment and trading agents make before interacting with an address. Live public RPC; one paid call.
- `get_chain_block_number`: The current chain tip (latest block height) via eth_blockNumber, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The freshness read settlement, indexing and trading agents poll to know where the chain is. Live public RPC; one paid call.
- `get_chain_allowance`: How much of an ERC-20 token a spender is approved to move from an owner's wallet, via allowance, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The approval read every DeFi, swap and trading agent makes before (and after) a transaction to know if an approve is needed. Live public RPC; one paid call.
- `get_chain_nonce`: An address's transaction count (nonce) via eth_getTransactionCount — the next nonce to use and total outgoing transactions, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The read settlement and trading agents make to build and sequence transactions. Live public RPC; one paid call.

## FAQ

### Does it require an account or API key?

The store page says pay-per-call works with no account and no key; the agent pays in USDC on Base via x402.

### How is the server connected?

The registry entry lists a streamable-http remote at store.agentexchange.work/chain/mcp and no local packages.

### How many tools does it expose?

The registry entry says 15 tools.

### Is Chain reads (x402) free?

No. Chain reads (x402) is a paid product.

### How do I add Chain reads (x402) to Claude Code?

Run this command in your terminal: claude mcp add --transport http chain-reads https://store.agentexchange.work/chain/mcp

### What are the best alternatives to Chain reads (x402)?

The closest alternatives to Chain reads (x402) are LensExtract x402 On-Chain Data, Agent Data Tools: Full list (every tool as its own definition), WarpPay402 MCP Gateway, Industrial Platform Transaction Watch and Industrial Platform Market Data.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 20 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [LensExtract x402 On-Chain Data](https://ai-powered.com/mcp/lensextract-x402-on-chain-data): LensExtract x402 On-Chain Data is an open-source MCP server for crypto and web3.
- [Agent Data Tools: Full list (every tool as its own definition)](https://ai-powered.com/mcp/agent-data-tools-full-list-every-tool-as-its-own-definition): Agent Data Tools: Full list (every tool as its own definition) is a freemium MCP server for developer tools.
- [WarpPay402 MCP Gateway](https://ai-powered.com/mcp/warppay402-mcp-gateway): WarpPay402 MCP Gateway is a paid MCP server for web search and scraping.
- [Industrial Platform Transaction Watch](https://ai-powered.com/mcp/industrial-platform-transaction-watch): Industrial Platform Transaction Watch is a freemium MCP server for crypto and web3.
- [Industrial Platform Market Data](https://ai-powered.com/mcp/industrial-platform-market-data): Industrial Platform Market Data is a free MCP server for finance and payments.
- [Edge Signals](https://ai-powered.com/mcp/edge-signals): Edge Signals is a paid MCP server for crypto and web3.
- [APEX DeFi, DefiLlama, DEX & EVM Audit MCP](https://ai-powered.com/mcp/apex-defi-defillama-dex-and-evm-audit-mcp): APEX DeFi, DefiLlama, DEX & EVM Audit MCP is a freemium MCP server for finance and payments.
- [HOT x402 Quotes](https://ai-powered.com/mcp/hot-x402-quotes-2): HOT x402 Quotes is an MCP server for crypto and web3.

---
Source: https://ai-powered.com/mcp/chain-reads-x402
