EVM MCP Server

A comprehensive Model Context Protocol (MCP) server that provides blockchain services across 60+ EVM-compatible networks. This server enables AI agents to interact with Ethereum, Optimism, Arbitrum, Base, Polygon, and many other EVM chains with a unified interface through 22 tools and 10 AI-guided prompts.

📋 Contents

• Overview
• Features
• Supported Networks
• Prerequisites
• Installation
• Configuration
  • Environment Variables
  • Server Configuration
• Usage
• API Reference
  • Tools
  • Prompts
  • Resources
• Security Considerations
• Project Structure
• Development
• License

🔭 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 with automatic ABI fetching from block explorers
• Transferring tokens (native, ERC20, ERC721, ERC1155)
• Querying token metadata and balances
• Chain-specific services across 60+ EVM networks (34 mainnets + 26 testnets)
• ENS name resolution for all address parameters (use human-readable names like 'vitalik.eth' instead of addresses)
• AI-friendly prompts that guide agents through complex workflows

All services are exposed through a consistent interface of MCP tools, resources, and prompts, making it easy for AI agents to discover and use blockchain functionality. Every tool that accepts Ethereum addresses also supports ENS names, automatically resolving them to addresses behind the scenes. The server includes intelligent ABI fetching, eliminating the need to know contract ABIs in advance.

✨ Features

Blockchain Data Access

• Multi-chain support for 60+ EVM-compatible networks (34 mainnets + 26 testnets)
• 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 (use 'vitalik.eth' instead of '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')

Token services

• ERC20 Tokens

  • Get token metadata (name, symbol, decimals, supply)
  • Check token balances
  • Transfer tokens between addresses
  • Approve spending allowances

• NFTs (ERC721)

  • Get collection and token metadata
  • Verify token ownership
  • Transfer NFTs between addresses
  • Retrieve token URIs and count holdings

• Multi-tokens (ERC1155)

  • Get token balances and metadata
  • Transfer tokens with quantity
  • Access token URIs

Smart Contract Interactions

• Read contract state through view/pure functions
• Write to contracts - Execute any state-changing function with automatic ABI fetching
• Contract verification to distinguish from EOAs
• Event logs retrieval and filtering
• Automatic ABI fetching from Etherscan v2 API across all 60+ networks (no need to know ABIs in advance)
• ABI parsing and validation with function discovery

Comprehensive Transaction Support

• Flexible Wallet Support - Configure with Private Key or Mnemonic (BIP-39) with HD path support
• Native token transfers across all supported networks
• Gas estimation for transaction planning
• Transaction status

... View full README on GitHub