The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Evm MCP listing page.
Complete EVM JSON-RPC access in your AI workflow. Query any EVM-compatible network (Ethereum, Polygon, Arbitrum, Optimism, BSC, and more) through any node provider. Works with Infura, Alchemy, QuickNode, local nodes, and more.
An MCP (Model Context Protocol) server that provides comprehensive access to Ethereum Virtual Machine (EVM) JSON-RPC methods for AI coding environments like Cursor and Claude Desktop.
Ready to interact with EVM blockchains? Install in seconds:
Install in Cursor (Recommended):
Or install manually:
eth_blockNumber – Get latest block numbereth_getBalance – Get account balanceeth_getTransactionCount – Get transaction count (nonce)eth_getBlockByNumber – Get block informationeth_getTransactionByHash – Get transaction detailseth_getTransactionReceipt – Get transaction receipteth_getCode – Get contract bytecodeeth_getStorageAt – Get storage valueeth_call – Execute contract calleth_estimateGas – Estimate gas for transactioneth_sendRawTransaction – Send signed transactioneth_gasPrice – Get current gas priceCraft transactions in natural language and simulate them against forked/overridden EVM state. Reports whether a transaction would succeed or revert, the revert reason in plain English, estimated gas, and balance/state changes. Supports address aliases and ENS names (e.g. alice.eth). By default the sender is funded with virtual ETH so a simulation can run "from" any address; set fund: false to use real balances.
simulate_native_transfer – Simulate sending native currency (e.g. "Transfer 100 ETH from A to B")simulate_erc20_transfer – Simulate an ERC20 transfer with human amounts (e.g. "Transfer 10 USDC to alice.eth from fun.eth")simulate_contract_call – Encode a function signature + args and simulate the callsimulate_transaction – Simulate a raw transaction (from/to/value/data)encode_function_data – Encode calldata from a human-readable signature (pure helper, no RPC)These tools only use
eth_call,eth_estimateGas, anddebug_traceCall(when the provider supports it). They never sign or send a real transaction. Real state diffs are used whendebug_traceCallis available; otherwise changes are inferred from the decoded intent.
eth_getLogs – Get event logslist_supported_networks – List configured networks and providerslist_known_addresses – List configured wallet aliases and known token/contract addresseseth_chainId – Get chain IDnet_version – Get network versionnet_listening – Check if listeningnet_peerCount – Get peer countweb3_clientVersion – Get client versionweb3_sha3 – Hash data with Keccak-256Click the install link above or use:
Requirements: Node.js 18+ and npm
Add to claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop after configuration.
| Variable | Required | Description |
|---|---|---|
INFURA_API_KEY | One of* | Infura project API key (built-in preset) |
ALCHEMY_API_KEY | One of* | Alchemy app API key (built-in preset) |
DEFAULT_NETWORK | No | Default chain slug or chain ID (default: ethereum) |
DEFAULT_PROVIDER | No | Provider slug to prefer (infura, alchemy, or custom) |
RPC_PROVIDER_ORDER | No | Comma-separated provider fallback order (default: infura,alchemy) |
CUSTOM_PROVIDERS | One of* | JSON array of user-defined providers |
CUSTOM_NETWORKS | One of* | JSON array of user-defined networks |
KNOWN_ADDRESSES | No | JSON array of known tokens/contracts (network-scoped) |
WALLET_ADDRESSES | No | JSON array of personal wallet and contract aliases |
*At least one provider API key, custom provider, or custom network with rpcUrl is required.
Set an API key and the server builds RPC URLs automatically for supported networks:
Each RPC tool accepts an optional network parameter (slug, name, or chain ID). When omitted, DEFAULT_NETWORK is used.
Use list_supported_networks to discover configured networks and providers.
CUSTOM_PROVIDERS)Register any RPC provider by supplying a base URL template and network-specific URLs:
networkUrls values are used directly (with {apiKey} substitution)./) are appended to baseUrl.CUSTOM_NETWORKS)Register arbitrary chains by name:
Or route through a provider by setting provider and adding the network slug to that provider's networkUrls.
KNOWN_ADDRESSES)Register tokens and contracts by name so tools accept aliases like USDC instead of raw hex addresses. Each entry is scoped to a network:
| Field | Required | Description |
|---|---|---|
name | yes | Primary lookup key |
address | yes | Checksummed contract address |
network | yes | Chain slug, name, chain ID, or network alias |
type | no | token or contract (default: contract) |
decimals | no | Token decimals for formatted balances |
aliases | no | Extra lookup keys |
When eth_getBalance is called with a token alias, the server uses the first configured wallet in WALLET_ADDRESSES as the token holder.
WALLET_ADDRESSES)Register personal wallets and contracts by alias so you can say "check my personal wallet" instead of pasting hex:
| Field | Required | Description |
|---|---|---|
name | yes | Primary lookup key |
address | yes | Wallet or contract address |
network | no | Scope alias to one chain (default: all chains) |
aliases | no | Extra lookup keys |
description | no | Human-readable note |
Address aliases work in eth_getBalance, eth_getCode, eth_call, eth_getLogs, and other tools that accept address parameters. Use list_known_addresses to discover configured aliases.
Configuration changes require restarting the MCP server.
CUSTOM_NETWORKSQuery the current block number:
Check an address balance using a hex address or configured alias:
View transaction information:
Execute a contract call:
Query contract events:
Built with: Node.js, TypeScript, MCP SDK, Ethers.js
Dependencies: @modelcontextprotocol/sdk, ethers, zod
Platforms: macOS, Windows, Linux
Environment Variables: See Configuration above.
⭐ If this project helps you, please star it on GitHub! ⭐
Contributions welcome! Please open an issue or submit a pull request.
MIT License – see LICENSE.md for details.
If you find this project useful, consider supporting it:
⚡ Lightning Network
₿ Bitcoin: bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp
Ξ Ethereum/EVM: 0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f