EVM MCP Server

Overview

The MCP EVM Server leverages the Model Context Protocol to provide blockchain services to AI agents. It supports a wide range of services including:

• Reading blockchain state (balances, transactions, blocks, etc.)
• Interacting with smart contracts
• Transferring tokens (native, ERC20, ERC721, ERC1155)
• Querying token metadata and balances
• Chain-specific services across 30+ EVM networks
• ENS name resolution for all address parameters

Features# Blockchain Data Access

• Multi-chain support for 30+ EVM-compatible networks
• Chain information including blockNumber, chainId, and RPCs
• Block data access by number, hash, or latest
• Transaction details and receipts with decoded logs
• Address balances for native tokens and all token standards
• ENS resolution for human-readable Ethereum addresses

Token services

• ERC20 Tokens
• NFTs (ERC721)
• Multi-tokens (ERC1155)

Smart Contract Interactions

• Read contract state through view/pure functions
• Write services with private key signing

Comprehensive Transaction Support

• Native token transfers across all supported networks
• Gas estimation for transaction planning

Supported Networks# Mainnets

• Ethereum (ETH)
• Optimism (OP)
• Arbitrum (ARB)
• ...

Testnets

• Sepolia
• Optimism Sepolia
• Arbitrum Sepolia
• ...

Prerequisites

• Bun 1.0.0 or higher
• Node.js 18.0.0 or higher

Installation

git clone https://github.com/mcpdotdirect/mcp-evm-server.git
cd mcp-evm-server\n\n# Install dependencies with Bun
bun install\n\n# Or with npm
npm install

Server Configuration

The server uses the following default configuration:

• Default Chain ID: 1 (Ethereum Mainnet)
• Server Port: 3001
• Server Host: 0.0.0.0

Usage# Using npx

You can run the MCP EVM Server directly without installation using npx:

npx @mcpdotdirect/evm-mcp-server\n\n# Run the server in HTTP mode
npx @mcpdotdirect/evm-mcp-server --http

License

This project is licensed under the terms of the MIT License.