
How to add EVM MCP Server to Claude Desktop
Interact with 60+ EVM chains: balances, transfers, contracts, ENS, and ABI fetching. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 15, 2026 ยท 380โ ยท stdio ยท apikey
Claude Desktop config for EVM MCP Server
npx -y @mcpdotdirect/evm-mcp-server{
"mcpServers": {
"evm-mcp-server": {
"command": "npx",
"args": [
"-y",
"@mcpdotdirect/evm-mcp-server"
],
"env": {
"EVM_PRIVATE_KEY": "<your-evm-private-key-optional>",
"ETHERSCAN_API_KEY": "<your-etherscan-api-key>"
}
}
}
}Setup steps
- 1Open Claude Desktop โ Settings โ Developer โ Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the EVM MCP Server config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm EVM MCP Server's tools appear under the ๐ tools menu.
Before you start
- Bun 1.0.0+ (recommended) or Node.js 20.0.0+
- Optional: an Etherscan API key (`ETHERSCAN_API_KEY`) for automatic ABI fetching
- For write operations/transfers: a wallet via `EVM_PRIVATE_KEY` or `EVM_MNEMONIC` (with optional `EVM_ACCOUNT_INDEX`) โ read-only tools need no key
- An MCP-compatible client (Claude Desktop, Cursor, etc.)
What EVM MCP Server can do in Claude Desktop
get_supported_networksList all supported EVM chains
get_balanceGet native token balance for an address or ENS name
get_token_balanceGet an ERC-20 token balance
resolve_ens_nameResolve an ENS name to an address
get_contract_abiFetch a verified contract's ABI from a block explorer
read_contractCall a read-only contract method
write_contractSend a state-changing contract transaction
multicallBatch multiple contract reads into one RPC call
Security
Providing EVM_PRIVATE_KEY or EVM_MNEMONIC lets the server sign and broadcast transactions that move real crypto; use a dedicated low-value wallet and omit the key entirely for read-only use. Never paste a mainnet seed phrase you also use elsewhere.
EVM MCP Server + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the EVM MCP Server config there under the "mcpServers" key and restart the client.
Is EVM MCP Server safe to use with Claude Desktop?
Providing EVM_PRIVATE_KEY or EVM_MNEMONIC lets the server sign and broadcast transactions that move real crypto; use a dedicated low-value wallet and omit the key entirely for read-only use. Never paste a mainnet seed phrase you also use elsewhere.
How many chains does it support?
60+ EVM networks: 34 mainnets (Ethereum, Optimism, Arbitrum, Base, Polygon, Avalanche, BSC, zkSync, etc.) and 26 testnets.
Do I need a private key?
Only for write/transfer operations. Read-only tools (balances, contract reads, ENS, ABI fetching) work without any wallet credentials.
Can it run as a remote/HTTP server?
Yes. It runs over stdio by default, or in HTTP mode with an SSE endpoint (e.g. http://localhost:3001/sse) using the `--http` flag for web applications.