evm-mcp

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.

AnMCP (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.

npm install -g @jamesanz/evm-mcp # Or from source: git clone https://github.com/JamesANZ/evm-mcp.git cd evm-mcp && npm install && npm run build

cursor://anysphere.cursor-deeplink/mcp/install?name=evm-mcp&config=eyJldm0tbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwiQGphbWVzYW56L2V2bS1tY3AiXX19

# Clone and build git clone https://github.com/JamesANZ/evm-mcp.git cd evm-mcp npm install npm run build # Set provider API keys export INFURA_API_KEY="your-infura-api-key" export DEFAULT_NETWORK="ethereum" export DEFAULT_PROVIDER="infura" # Run server npm start

{ "mcpServers": { "evm-mcp": { "command": "node", "args": ["/absolute/path/to/evm-mcp/build/index.js"], "env": { "INFURA_API_KEY": "your-infura-api-key", "DEFAULT_NETWORK": "ethereum", "DEFAULT_PROVIDER": "infura", "RPC_PROVIDER_ORDER": "infura,alchemy" } } } }

Restart Claude Desktop after configuration.

*At least one provider API key, custom provider, or custom network withrpcUrlis required.

Set an API key and the server builds RPC URLs automatically for supported networks:

{ "INFURA_API_KEY": "your-infura-key", "DEFAULT_NETWORK": "ethereum", "DEFAULT_PROVIDER": "infura", "RPC_PROVIDER_ORDER": "infura,alchemy" }

Each RPC tool accepts an optionalnetworkparameter (slug, name, or chain ID). When omitted,DEFAULT_NETWORKis used.

{ "tool": "eth_chainId", "arguments": { "network": "polygon" } }

Uselist_supported_networksto discover configured networks and providers.

Register any RPC provider by supplying a base URL template and network-specific URLs:

"CUSTOM_PROVIDERS": "[{\"slug\":\"quicknode\",\"apiKeyEnv\":\"QUICKNODE_API_KEY\",\"baseUrl\":\"https://rpc.example.com/v1/{apiKey}\",\"networkUrls\":{\"ethereum\":\"https://eth.quiknode.pro/{apiKey}/\",\"polygon\":\"https://polygon.quiknode.pro/{apiKey}/\"}}]"

- AbsolutenetworkUrlsvalues are used directly (with{apiKey}substitution).
- Relativepaths (starting with/) are appended tobaseUrl.

"CUSTOM_NETWORKS": "[{\"name\":\"HyperEVM\",\"slug\":\"hyperevm\",\"chainId\":999,\"rpcUrl\":\"https://rpc.hyperliquid.xyz/evm\"}]"

Or route through a provider by settingproviderand adding the network slug to that provider'snetworkUrls.

Register tokens and contracts by name so tools accept aliases likeUSDCinstead of raw hex addresses. Each entry is scoped to a network:

"KNOWN_ADDRESSES": "[{\"name\":\"USDC\",\"address\":\"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\"network\":\"ethereum\",\"type\":\"token\",\"decimals\":6,\"aliases\":[\"usd-coin\"]}]"

Wheneth_getBalanceis called with a token alias, the server uses the first configured wallet inWALLET_ADDRESSESas the token holder.

Register personal wallets and contracts by alias so you can say "check my personal wallet" instead of pasting hex:

"WALLET_ADDRESSES": "[{\"name\":\"my-wallet\",\"address\":\"0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f\",\"aliases\":[\"personal\",\"my wallet\"],\"description\":\"Main EOA\"}]"

Address aliases work ineth_getBalance,eth_getCode,eth_call,eth_getLogs, and other tools that accept address parameters. Uselist_known_addressesto discover configured aliases.

- "RPC_URL": "https://mainnet.infura.io/v3/KEY" - "CHAIN_ID": "1" + "INFURA_API_KEY": "KEY" + "DEFAULT_NETWORK": "ethereum" + "DEFAULT_PROVIDER": "infura"

Configuration changes require restarting the MCP server.

- Ethereum: Mainnet, Sepolia
- Polygon: Mainnet, Amoy
- Arbitrum: One, Sepolia
- Optimism: Mainnet, Sepolia
- BNB Smart Chain: Mainnet, Testnet
- Avalanche: C-Chain
- Base: Mainnet, Sepolia
- Any EVM-compatible chainviaCUSTOM_NETWORKS

{ "tool": "eth_blockNumber", "arguments": {} }

Check an address balance using a hex address or configured alias:

{ "tool": "eth_getBalance", "arguments": { "address": "personal", "blockNumber": "latest" } }

{ "tool": "eth_getTransactionByHash", "arguments": { "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef" } }

{ "tool": "eth_call", "arguments": { "to": "0xA0b86a33E6441c8C06DDD46C310c0eF8D9441C8F", "data": "0x70a08231000000000000000000000000742d35Cc6634C0532925a3b8D6Ac6e2F0C4C9B7C" } }

{ "tool": "eth_getLogs", "arguments": { "fromBlock": "0x1234567", "toBlock": "latest", "address": "0xA0b86a33E6441c8C06DDD46C310c0eF8D9441C8F", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef" ] } }

- Blockchain Analytics– Query transaction data, balances, and contract states
- DeFi Applications– Monitor token balances, transaction receipts, and smart contract calls
- NFT Projects– Track transfers, metadata, and collection statistics
- Development Tools– Debug transactions, estimate gas, and test smart contracts
- Monitoring– Watch for specific events and transaction patterns
- Research– Analyze blockchain data across multiple EVM networks

Built with:Node.js, TypeScript, MCP SDK, Ethers.js
Dependencies:@modelcontextprotocol/sdk,ethers,zod
Platforms:macOS, Windows, Linux

Environment Variables:SeeConfigurationabove.

MIT License – seeLICENSE.mdfor details.

lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa

₿ Bitcoin:bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp

Ξ Ethereum/EVM:0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f

MCP server for Klever blockchain smart contract development, on-chain data exploration, and VM interaction. Public remote server available at https://mcp.klever.org/mcp.

Read/write to over 2k blockchains, enabling data querying, contract analysis/deployment, and transaction execution, powered by Thirdweb.

A comprehensive toolkit for Ethereum blockchain analysis directly within Claude AI.

Provides blockchain services for over 30 EVM-compatible networks through a unified interface.

A lightweight MCP server for Solidity development using the Foundry toolchain (Forge, Cast, and Anvil).

Interact with Ethereum-compatible smart contracts using their ABI.

Interact with the Monad testnet, query blockchain data, and engage with the CoinflipGame smart contract.

An MCP server for Solana development providing basic RPC methods and helpful prompts.

An MCP server providing access to various Starknet RPC methods.

An MCP server for interacting with the Tatara blockchain ecosystem. Requires configuration for the Tatara RPC endpoint and a wallet private key.