EVM Blockchain MCP server

The EVM MCP Server provides a comprehensive interface for AI agents to interact with multiple Ethereum-compatible blockchain networks (30+). It enables chain interactions, token operations, and smart contract interactions through a standardized protocol with ENS name support across all address parameters.

Installation

Prerequisites

• Bun 1.0.0 or higher
• Node.js 18.0.0 or higher (if not using Bun)

Setup

# Clone the repository
git clone https://github.com/mcpdotdirect/mcp-evm-server.git
cd mcp-evm-server

# Install dependencies with Bun
bun install

# Or with npm
npm install

Running the Server

Quick Start with npx

You can run the server directly without installation:

# Run in stdio mode (for CLI tools)
npx @mcpdotdirect/evm-mcp-server

# Run in HTTP mode (for web applications)
npx @mcpdotdirect/evm-mcp-server --http

Running Locally

For stdio mode (CLI tools integration):

# Start the stdio server
bun start

# Development mode with auto-reload
bun dev

For HTTP server with SSE (web applications):

# Start the HTTP server
bun start:http

# Development mode with auto-reload
bun dev:http

Connecting to the Server

Cursor Integration

To connect from Cursor:

1. Open Cursor and go to Settings
2. Navigate to "Features"
3. Scroll to "MCP Servers" section
4. Click "Add new MCP server"
5. Enter details:
   • Server name: evm-mcp-server
   • Type: command
   • Command: npx @mcpdotdirect/evm-mcp-server
6. Click "Save"

Using mcp.json Configuration

Create an .cursor/mcp.json file in your project root:

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

HTTP Mode with SSE

For web applications using Server-Sent Events:

{
  "mcpServers": {
    "evm-mcp-sse": {
      "url": "http://localhost:3001/sse"
    }
  }
}

Claude CLI Connection

# Add the MCP server
claude mcp add evm-mcp-server npx @mcpdotdirect/evm-mcp-server

# Start Claude with the MCP server enabled
claude

Usage Examples

Getting a Token Balance with ENS

const mcp = new McpClient("http://localhost:3000");

const result = await mcp.invokeTool("get-token-balance", {
  tokenAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC on Ethereum
  ownerAddress: "vitalik.eth", // ENS name instead of address
  network: "ethereum"
});

console.log(result);
// {
//   tokenAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
//   owner: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
//   network: "ethereum",
//   raw: "1000000000",
//   formatted: "1000",
//   symbol: "USDC",
//   decimals: 6
// }

Resolving an ENS Name

const mcp = new McpClient("http://localhost:3000");

const result = await mcp.invokeTool("resolve-ens", {
  ensName: "vitalik.eth",
  network: "ethereum"
});

console.log(result);
// {
//   ensName: "vitalik.eth",
//   normalizedName: "vitalik.eth",
//   resolvedAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
//   network: "ethereum"
// }

Supported Networks

Mainnets

• Ethereum, Optimism, Arbitrum, Arbitrum Nova, Base, Polygon, Polygon zkEVM
• Avalanche, Binance Smart Chain, zkSync Era, Linea, Celo, Gnosis
• Fantom, Filecoin, Moonbeam, Moonriver, Cronos, Scroll, Mantle, Manta
• Blast, Fraxtal, Mode, Metis, Kroma, Zora, Aurora, Canto, Flow, Lumia

Testnets

• Sepolia, Optimism Sepolia, Arbitrum Sepolia, Base Sepolia, Polygon Amoy
• And many more test networks for all major chains

Available Tools

Token Operations

NFT Operations

ERC1155 Operations

Blockchain Operations

Resource URIs

The server also provides blockchain data through resource URIs:

Blockchain Resources

Token Resources

Security Considerations

• Private keys are used only for transaction signing and never stored
• Implement additional authentication for production use
• Use HTTPS for the HTTP server in production
• Consider adding rate limiting to prevent abuse

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.