evmcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@evmcpwhat's the ETH balance of vitalik.eth on Base?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
evmcp
EVM + MCP — give your AI assistant blockchain superpowers.
MCP server providing real-time access to on-chain data across Base, Optimism, Avalanche, Celo, and Arbitrum, with companion smart contracts deployed on-chain for batch queries and cross-chain data.
How it Works
EVMCP implements the Model Context Protocol (MCP), a standard that lets AI assistants call external tools. When connected, your AI assistant gains 28 read-only blockchain tools it can invoke to query balances, decode transactions, compare gas prices, and more across five EVM chains.
What sets EVMCP apart is its companion smart contracts — four Solidity contracts deployed on Avalanche and Celo that enable batch queries via Multicall3, an on-chain tool registry, event aggregation, and cross-chain balance caching. The MCP server reads from these contracts; all write operations are performed separately by an admin CLI.
Related MCP server: Bink MCP Server
Quick Start
With Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"evmcp": {
"command": "npx",
"args": ["-y", "evmcp"],
"env": { "ALCHEMY_API_KEY": "your_key_here" }
}
}
}With Claude Code
claude mcp add evmcp -- npx -y evmcpSupported Chains
Chain | Chain ID | Native Token | Companion Contracts |
Base | 8453 | ETH | Not yet deployed |
Optimism | 10 | ETH | Not yet deployed |
Avalanche C-Chain | 43114 | AVAX | Deployed |
Celo | 42220 | CELO | Deployed |
Arbitrum One | 42161 | ETH | Not yet deployed |
Ethereum mainnet (chain ID 1) is also supported for ENS resolution only.
Tools (29 total)
Balance (3)
Tool | Description |
| Get the native token balance (ETH/AVAX/CELO) of an address on a specific chain |
| Get the ERC20 token balance of an address on a specific chain |
| Get the native token balance of an address across all 5 supported chains in parallel |
Block (3)
Tool | Description |
| Get a block by its hash on a specific chain |
| Get a block by its number on a specific chain, or pass "latest" for the most recent block |
| Get the latest block number, timestamp, and base fee for a specific chain |
Transaction (3)
Tool | Description |
| Get a transaction by its hash on a specific chain |
| Get the receipt for a transaction including status, gasUsed, and logs |
| Decode a transaction's function call using a provided ABI |
Contract (3)
Tool | Description |
| Call a read-only function on a smart contract with a provided ABI |
| Check if an address has contract code deployed, with bytecode length and hash |
| Read the raw value of a storage slot at a specific address |
Token (2)
Tool | Description |
| Get ERC20 token metadata including name, symbol, decimals, and total supply |
| Get the ERC20 token allowance granted by an owner to a spender |
Gas (3)
Tool | Description |
| Get current gas price and EIP-1559 fee data for a specific chain |
| Estimate gas for a transaction on a specific chain |
| Compare current gas prices across all 5 supported chains |
ENS (2)
Tool | Description |
| Resolve an ENS name (e.g. vitalik.eth) to an Ethereum address via Ethereum L1 |
| Reverse lookup an address to its ENS name via Ethereum L1 |
Events (2)
Tool | Description |
| Get event logs emitted by a contract on a specific chain |
| Decode a raw event log using a provided ABI |
Chain and Health (3)
Tool | Description |
| Get chain name, chain ID, current block number, block time, and native symbol |
| Check if an address has contract code deployed on all 5 supported chains |
| Test connectivity to all 6 RPC endpoints (Ethereum, Base, Optimism, Avalanche, Celo, Arbitrum) |
Batch (1)
Tool | Description |
| Execute multiple read calls in a single RPC request using Multicall3 |
Cross-Chain (2)
Tool | Description |
| Compare native token balances for an address across all 5 chains |
| Check transaction counts for an address across all 5 chains |
Registry (1)
Tool | Description |
| Read registered tool metadata from the on-chain MCPRegistry companion contract |
Optimizer (1)
Tool | Description |
| Recommends the cheapest chain for a transaction, accounting for L1 data fees on Base/Optimism/Arbitrum |
Resources (4)
URI Pattern | Description | Cache TTL |
| Current block height and gas price for a chain | 12s |
| Base fee, gas price, and priority fee in gwei | 12s |
| Popular token addresses and decimals (hardcoded for v1) | 1 hour |
| All supported chains with IDs, symbols, and companion contract addresses | Static |
Supported chain IDs for templated resources: 8453 (Base), 10 (Optimism), 43114 (Avalanche), 42220 (Celo), 42161 (Arbitrum).
Prompts (4)
Prompt | Arguments | Description |
|
| Multi-chain balance and activity analysis of a wallet |
|
| Basic inspection and audit workflow for a smart contract |
| (none) | Compare gas costs, speed, and characteristics across all chains |
|
| Decode, analyze, and trace a transaction in detail |
Companion Contracts
Four Solidity contracts are deployed on Avalanche and Celo. The MCP server reads from these contracts to provide batch queries, on-chain tool metadata, and cross-chain data. Base and Optimism deployments are planned.
Avalanche C-Chain (43114)
Contract | Address |
MCPRegistry |
|
BatchQuery |
|
EventAggregator |
|
CrossChainCache |
|
Celo (42220)
Contract | Address |
MCPRegistry |
|
BatchQuery |
|
EventAggregator |
|
CrossChainCache |
|
Contract Descriptions
MCPRegistry -- On-chain metadata for all EVMCP tools (names, descriptions, versions). Owner-only writes.
BatchQuery -- Optimized batch reads via Multicall3. Includes multi-balance, multi-contract-check, and multi-token-balance helpers.
EventAggregator -- Caches event count summaries per contract. Updated by the admin CLI.
CrossChainCache -- Stores balance snapshots for cross-chain queries. Updated by the admin CLI.
Environment Variables
Variable | Required | Description |
| Yes* | Alchemy API key (covers all chains) |
| No* | Override RPC URL for Base |
| No* | Override RPC URL for Optimism |
| No* | Override RPC URL for Avalanche |
| No* | Override RPC URL for Celo |
| No* | Override RPC URL for Arbitrum |
| No | Override RPC URL for ENS resolution |
| No | Cache TTL in seconds (default: 15) |
| No | Max cache entries (default: 1000) |
| No | debug, info, warn, or error (default: info) |
| No | Use testnet chains (default: false) |
| TRANSPORT | No | stdio (default) or http for Streamable HTTP transport |
| HTTP_PORT | No | Port for HTTP transport (default: 3402) |
| X402_ENABLED | No | Enable x402 payment gating on HTTP transport |
| X402_PAYEE_ADDRESS | No** | USDC receive address on Base |
| X402_FACILITATOR_URL | No | x402 facilitator URL (has default) |
*Provide either ALCHEMY_API_KEY or all five individual chain RPC URLs.
**Required when X402_ENABLED=true.
Development
pnpm install
pnpm build
pnpm inspect # MCP Inspector UI at localhost:6274
pnpm test # Unit tests
pnpm typecheck # Type check
pnpm lint # ESLintLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides tools for querying onchain data across 12+ blockchain networks, including token balances, transaction analysis, and smart contract security auditing. It enables users to interact with multiple EVM-compatible chains and perform deep contract evaluations through natural language interfaces.1

Bink MCP Serverofficial
FlicenseNot gradedqualityDmaintenanceEnables AI agents to perform blockchain operations like wallet management, token info, DeFi swaps, cross-chain bridging, and price checking across Ethereum, BNB Chain, and Solana.
Noves MCP Serverofficial
AlicenseBqualityDmaintenanceEnables AI assistants to access and explain blockchain data across 100+ networks using natural language, without requiring authentication.923MIT- AlicenseAqualityCmaintenanceEnables AI agents to fetch live multi-chain portfolio, token info, gas prices, and token prices across Ethereum, Base, Polygon, Arbitrum, and Optimism with a single call. No API key required.4MIT
Related MCP Connectors
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Read-only on-chain intel for AI agents on Base: balances, tokens, gas, tx status. No API keys.
Provide AI agents and automation tools with contextual access to blockchain data including balance…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/siriuslattice/evmcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server