EVM

v1.0.0Databasesstable

Provides comprehensive access to Ethereum Virtual Machine (EVM) JSON-RPC methods for querying blockchain data, executing smart contract calls, and interacting with any EVM-compatible network including Ethereum, Polygon, Arbitrum, and more. Enables us

agentblockchainethereumevmmcp
Share:
376
Stars
0
Downloads
0
Weekly
0/5

What is EVM?

EVM is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides comprehensive access to ethereum virtual machine (evm) json-rpc methods for querying blockchain data, executing smart contract calls, and interacting with any evm-compatible network including...

Provides comprehensive access to Ethereum Virtual Machine (EVM) JSON-RPC methods for querying blockchain data, executing smart contract calls, and interacting with any EVM-compatible network including Ethereum, Polygon, Arbitrum, and more. Enables us

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Provides comprehensive access to Ethereum Virtual Machine (E

Use Cases

Query Ethereum, Polygon, Arbitrum, and other EVM-compatible networks.
Execute smart contract calls and interact with blockchain data.
mcpdotdirect

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx evm-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use EVM

The EVM MCP server provides AI agents with comprehensive access to Ethereum Virtual Machine blockchain networks through 25 tools covering wallet operations, ENS name resolution, block and transaction queries, native and ERC-20/ERC-721/ERC-1155 token interactions, smart contract ABI fetching and calls, multicall batching, NFT metadata, and EIP-712 message signing. It supports 34 mainnets and 26 testnets including Ethereum, Polygon, Arbitrum, Base, Optimism, Avalanche, BSC, zkSync, and more — all from a single server instance. All tools that accept address parameters also accept ENS names, making it natural to query by human-readable identity. An optional Etherscan API key unlocks automatic ABI fetching across all supported networks.

Prerequisites

  • Node.js 20.0.0+ or Bun 1.0.0+
  • npx available on your PATH (comes with Node.js)
  • Optional: EVM_PRIVATE_KEY or EVM_MNEMONIC environment variable for write operations (token transfers, contract writes, signing)
  • Optional: ETHERSCAN_API_KEY for automatic smart contract ABI fetching
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Test the server with npx

Run the server once with npx to verify it starts without errors. No installation is required for read-only operations.

npx @mcpdotdirect/evm-mcp-server
2

Set up environment variables for write operations

For token transfers, contract writes, and message signing, provide a private key or mnemonic. Never commit these to source control.

export EVM_PRIVATE_KEY=0xabc123...  # hex private key
# OR
export EVM_MNEMONIC="word1 word2 ... word12"  # BIP-39 seed phrase
export EVM_ACCOUNT_INDEX=0  # optional HD wallet index
3

Set up Etherscan API key for ABI fetching

Add an Etherscan API key to enable automatic ABI fetching when interacting with verified smart contracts.

export ETHERSCAN_API_KEY=your_api_key_here
4

Add the server to your MCP client

Configure your MCP client to run the server via npx, passing environment variables for any write capabilities you need.

5

Or run in HTTP mode for network access

Use the --http flag to start the server in HTTP/SSE mode if you need to connect from a remote client.

npx @mcpdotdirect/evm-mcp-server --http

EVM Examples

Client configuration

Claude Desktop configuration for the EVM MCP server with optional Etherscan API key. Add private key only if you need write operations.

{
  "mcpServers": {
    "evm": {
      "command": "npx",
      "args": ["-y", "@mcpdotdirect/evm-mcp-server"],
      "env": {
        "ETHERSCAN_API_KEY": "your_etherscan_api_key",
        "EVM_PRIVATE_KEY": "0xyour_private_key_here"
      }
    }
  }
}

Prompts to try

Example blockchain queries and operations you can perform through natural language once the EVM server is connected.

- "What is the ETH balance of vitalik.eth on Ethereum mainnet?"
- "Get the current gas price on Polygon"
- "Fetch the USDC balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Arbitrum"
- "Look up the transaction hash 0xabc... on Ethereum and explain what it did"
- "Resolve the ENS name 'uniswap.eth' to its Ethereum address"
- "What NFTs does 0x1234...abcd own on Ethereum?"

Troubleshooting EVM

Write operations fail with 'no signer configured' error

Set either EVM_PRIVATE_KEY (hex-encoded, starting with 0x) or EVM_MNEMONIC (12 or 24 word BIP-39 phrase) in the env block of your MCP client configuration or as a shell environment variable before starting the server.

Smart contract ABI fetching returns 'ABI not found'

Set ETHERSCAN_API_KEY in your environment. Without it, ABI fetching is unavailable. Also verify the contract is deployed and verified on the target network — unverified contracts cannot have their ABI fetched automatically.

Queries to a specific network fail or return errors

The server uses public RPC endpoints by default. Some networks may have rate limits or temporary outages. Check that the network name you're specifying matches the server's supported network list (e.g. 'ethereum', 'polygon', 'arbitrum', 'base', 'optimism').

Frequently Asked Questions about EVM

What is EVM?

EVM is a Model Context Protocol (MCP) server that provides comprehensive access to ethereum virtual machine (evm) json-rpc methods for querying blockchain data, executing smart contract calls, and interacting with any evm-compatible network including ethereum, polygon, arbitrum, and more. enables us It connects AI assistants to external tools and data sources through a standardized interface.

How do I install EVM?

Follow the installation instructions on the EVM GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with EVM?

EVM works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is EVM free to use?

Yes, EVM is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "evm-mcp-server": { "command": "npx", "args": ["-y", "evm-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use EVM?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides