Read EVM contracts from your Claude, your code, an n8n workflow, or a REST client

One URL, any EVM chain, any contract. MCP for AI agents, a clean REST API for everything else, and an n8n node for your workflows.

Is vitalik still approved on Uniswap?

Yes — vitalik.eth has an unlimited allowance on the Uniswap V3 SwapRouter.

usdc.allowance(vitalik, router) 1 contract · 38ms

Start building Read docs →

Free to start — no credit card

Everything you reach for, in one expression.

Read any EVM contract without wiring providers, ABIs, or decoders by hand.

Any contract

Read state by address. No ABI files, ever.

usdc.balanceOf(vitalik)

→ 2,847.19

Proxy-aware

EIP-1967, transparent, beacon — resolved automatically.

proxy 0xA0b86a…EB48

impl 0x43506…8C9D

Typed results

BigInt, address, struct — decoded and ready.

{
  "result": "2847.193021",
  "type": "uint256",
  "chain": "evm_ethereum"
}

Cross-protocol in one call

Aave, Uniswap, Curve in a single query — independent reads auto-batched into one Multicall3 round.

q({
  health: formatUnits(
    aave.getUserAccountData(me).healthFactor, 18),
  position: uniswap.positions(solInt(42)),
})

Drop it in your agent

MCP for Claude, Cursor, VS Code, Windsurf. REST for everything else.

claude mcp add evmquery \
  --transport http \
  https://api.evmquery.com/mcp

One line of config. Any EVM chain.

Install in your MCP client or call the REST API — get typed onchain data back.

For

1. Install

claude mcp add evmquery \ --transport http \ https://api.evmquery.com/mcp

2. Ask

You: How much USDC do I hold across chains?

evmquery: $12,430 on Ethereum, $3,220 on Base, $1,980 on Arbitrum.

q("usdc.balanceOf(me) on [ethereum, base, arbitrum]")

48ms · 3 chains · typed result

Request

curl -X POST https://api.evmquery.com/api/v1/query \
  -H "x-api-key: $KEY" \
  -d '{"chain":"evm_ethereum",
       "expression":"usdc.balanceOf(vitalik)"}'

Response

{
  "result": "2847.193021",
  "chain": "evm_ethereum",
  "latency_ms": 38
}

Frequently asked questions

Ethereum, Base, and BNB Smart Chain today. We’re actively adding more EVM-compatible chains.

Yes. The free plan includes 2,000 credits per month — plenty for development and early production use. No credit card required to get started.

Rate limits are applied per API key. Auto-batching means a single expression touching multiple contracts counts as one request. Need higher throughput? Paid plans are coming soon.

Median response time is under 50ms for single-contract calls. Multi-contract expressions with auto-batching typically resolve in under 200ms. We cache ABI lookups so repeated queries are even faster.

For MCP connections, evmquery uses OIDC — your client handles sign-in automatically. For the REST API, requests are authenticated with an API key transmitted over HTTPS. You can generate and rotate keys from the dashboard.

No. evmquery auto-resolves ABIs for verified contracts. For unverified contracts, you can supply an ABI in the schema field of your query.

evmquery works with any client that supports the Model Context Protocol. We’ve tested with Claude Code, Cursor, VS Code, Windsurf, and Zed. Setup is a single URL — no plugins or SDKs to install. Your client handles sign-in via OIDC automatically.

Yes. Every query reads from the latest block at execution time — there is no caching layer between you and the chain. Response metadata includes the exact block number so you always know what you’re looking at.

Give your AI agents onchain superpowers.

Free tier included. No credit card. Set up in under a minute.

Start building Read docs