evm-mcp-server

# 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](#overview) - [Features](#features) - [Supported Networks](#supported-networks) - [Prerequisites](#prerequisites) - [Installation](#installation) - [Configuration](#configuration) - [Environment Variables](#environment-variables) - [Server Configuration](#server-configuration) - [Usage](#usage) - [API Reference](#api-reference) - [Tools](#tools) - [Prompts](#prompts) - [Resources](#resources) - [Security Considerations](#security-considerations) - [Project Structure](#project-structure) - [Development](#development) - [License](#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** and receipt information - **Error handling** with descriptive messages ### Message Signing Capabilities - **Personal Message Signing** - Sign arbitrary messages for authentication and verification - **EIP-712 Typed Data Signing** - Sign structured data for gasless transactions and meta-transactions - **SIWE Support** - Enable Sign-In With Ethereum authentication flows - **Permit Signatures** - Create off-chain approvals for gasless token operations - **Meta-Transaction Support** - Sign transaction data for relay services and gasless transfers ### AI-Guided Workflows (Prompts) - **Transaction preparation** - Guidance for planning and executing transfers - **Wallet analysis** - Tools for analyzing wallet activity and holdings - **Smart contract exploration** - Interactive ABI fetching and contract analysis - **Contract interaction** - Safe execution of write operations on smart contracts - **Network information** - Learning about EVM networks and comparisons - **Approval auditing** -