This EVM MCP Server provides comprehensive access to Ethereum Virtual Machine blockchain data through JSON-RPC methods, enabling blockchain analytics, smart contract interactions, and network monitoring across any EVM-compatible chain.

Core Capabilities:

Blockchain Data Queries: Retrieve latest block numbers, detailed block information, transaction details by hash, transaction receipts, account balances at any block height, transaction counts (nonces), contract bytecode, and storage values at specific positions.

Smart Contract Interactions: Execute read-only contract calls (eth_call), estimate gas costs (eth_estimateGas), and send pre-signed raw transactions (eth_sendRawTransaction).

Event & Log Monitoring: Query historical event logs (eth_getLogs) with flexible filtering by block range, contract addresses, and event topics/signatures.

Network Information: Access current gas prices, chain IDs, network versions, client versions, listening status, and peer counts.

Utility Functions: Compute Keccak-256 hashes (web3_sha3) and support multiple block references (latest, earliest, pending, specific numbers).

Universal Compatibility: Works with Ethereum (Mainnet, Sepolia, Goerli), Polygon, Arbitrum, Optimism, BNB Smart Chain, Avalanche, Fantom, and any custom EVM network. Compatible with Infura, Alchemy, QuickNode, local nodes (Geth, Erigon), public RPC endpoints, and any JSON-RPC provider. Configurable via RPC_URL and CHAIN_ID environment variables.

Supports Alchemy as an RPC node provider for accessing Ethereum and other EVM-compatible blockchain networks, enabling blockchain queries and operations through Alchemy's infrastructure.

Supports BNB Smart Chain (Binance Smart Chain) mainnet and testnet networks for blockchain operations and data queries through EVM JSON-RPC methods.

Provides comprehensive access to Ethereum Virtual Machine (EVM) JSON-RPC methods for querying blockchain data, checking balances, executing contract calls, estimating gas, retrieving transaction information, and monitoring network events across any EVM-compatible network.

Enables interaction with Fantom Opera blockchain network through EVM-compatible JSON-RPC methods for accessing blockchain data and executing operations.

Provides access to Optimism Layer 2 blockchain networks through EVM-compatible JSON-RPC methods for blockchain data queries and transaction operations.

Enables interaction with Polygon blockchain networks (mainnet and testnet) through EVM JSON-RPC methods for querying transactions, balances, smart contracts, and network data.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@EVM MCP Server check the balance of 0x742d35Cc6634C0532925a3b8D6Ac6e2F0C4C9B7C"

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.

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"
 }
 }
 }
}

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

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

"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}/\"}}]"

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

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

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

{
 "tool": "eth_getBalance",
 "arguments": {
 "address": "0x742d35Cc6634C0532925a3b8D6Ac6e2F0C4C9B7C",
 "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"
 ]
 }
}

lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa