evm-mcp-server
installs/mo · npmstarsforks
How to install evm-mcp-server?
mcpdotdirect/evm-mcp-server
$git clone https://github.com/mcpdotdirect/evm-mcp-serverA 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 tool
README.md
| 1 | # EVM MCP Server |
| 2 | |
| 3 |  |
| 4 |  |
| 5 |  |
| 6 |  |
| 7 |  |
| 8 | |
| 9 | 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. |
| 10 | |
| 11 | ## 📋 Contents |
| 12 | |
| 13 | - [Overview](#overview) |
| 14 | - [Features](#features) |
| 15 | - [Supported Networks](#supported-networks) |
| 16 | - [Prerequisites](#prerequisites) |
| 17 | - [Installation](#installation) |
| 18 | - [Configuration](#configuration) |
| 19 | - [Environment Variables](#environment-variables) |
| 20 | - [Server Configuration](#server-configuration) |
| 21 | - [Usage](#usage) |
| 22 | - [API Reference](#api-reference) |
| 23 | - [Tools](#tools) |
| 24 | - [Prompts](#prompts) |
| 25 | - [Resources](#resources) |
| 26 | - [Security Considerations](#security-considerations) |
| 27 | - [Project Structure](#project-structure) |
| 28 | - [Development](#development) |
| 29 | - [License](#license) |
| 30 | |
| 31 | ## 🔭 Overview |
| 32 | |
| 33 | The MCP EVM Server leverages the Model Context Protocol to provide blockchain services to AI agents. It supports a wide range of services including: |
| 34 | |
| 35 | - Reading blockchain state (balances, transactions, blocks, etc.) |
| 36 | - Interacting with smart contracts with **automatic ABI fetching** from block explorers |
| 37 | - Transferring tokens (native, ERC20, ERC721, ERC1155) |
| 38 | - Querying token metadata and balances |
| 39 | - Chain-specific services across 60+ EVM networks (34 mainnets + 26 testnets) |
| 40 | - **ENS name resolution** for all address parameters (use human-readable names like 'vitalik.eth' instead of addresses) |
| 41 | - **AI-friendly prompts** that guide agents through complex workflows |
| 42 | |
| 43 | 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. |
| 44 | |
| 45 | ## ✨ Features |
| 46 | |
| 47 | ### Blockchain Data Access |
| 48 | |
| 49 | - **Multi-chain support** for 60+ EVM-compatible networks (34 mainnets + 26 testnets) |
| 50 | - **Chain information** including blockNumber, chainId, and RPCs |
| 51 | - **Block data** access by number, hash, or latest |
| 52 | - **Transaction details** and receipts with decoded logs |
| 53 | - **Address balances** for native tokens and all token standards |
| 54 | - **ENS resolution** for human-readable Ethereum addresses (use 'vitalik.eth' instead of '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045') |
| 55 | |
| 56 | ### Token services |
| 57 | |
| 58 | - **ERC20 Tokens** |
| 59 | |
| 60 | - Get token metadata (name, symbol, decimals, supply) |
| 61 | - Check token balances |
| 62 | - Transfer tokens between addresses |
| 63 | - Approve spending allowances |
| 64 | |
| 65 | - **NFTs (ERC721)** |
| 66 | |
| 67 | - Get collection and token metadata |
| 68 | - Verify token ownership |
| 69 | - Transfer NFTs between addresses |
| 70 | - Retrieve token URIs and count holdings |
| 71 | |
| 72 | - **Multi-tokens (ERC1155)** |
| 73 | - Get token balances and metadata |
| 74 | - Transfer tokens with quantity |
| 75 | - Access token URIs |
| 76 | |
| 77 | ### Smart Contract Interactions |
| 78 | |
| 79 | - **Read contract state** through view/pure functions |
| 80 | - **Write to contracts** - Execute any state-changing function with automatic ABI fetching |
| 81 | - **Contract verification** to distinguish from EOAs |
| 82 | - **Event logs** retrieval and filtering |
| 83 | - **Automatic ABI fetching** from Etherscan v2 API across all 60+ networks (no need to know ABIs in advance) |
| 84 | - **ABI parsing and validation** with function discovery |
| 85 | |
| 86 | ### Comprehensive Transaction Support |
| 87 | |
| 88 | - **Flexible Wallet Support** - Configure with Private Key or Mnemonic (BIP-39) with HD path support |
| 89 | - **Native token transfers** across all supported networks |
| 90 | - **Gas estimation** for transaction planning |
| 91 | - **Transaction status** |
People who liked this also viewed
6 picksType
- aibtc-mcp-serverBitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.MCP ServersJul 2026
- web3-research-mcpDeep Research for crypto - free & fully localMCP ServersJul 2026
- dexpaprika-mcpDexPaprika MCP server for real-time crypto token data, DEX trading activity, and DeFi analytics across multiple blockchains.MCP ServersJul 2026
- mcp-serversA collection of MCP servers to allow LLMs to use the qiskit,qiskit-ibm-runtime library, qiskit-ibm-transpiler, qiskit-code-assistant service library and othersMCP ServersJul 2026
- algorand-mcpAlgorand Local Model Context Protocol (Server & Client)MCP ServersJun 2026
- mcp-server-ccxtHigh-performance CCXT MCP server for cryptocurrency exchange integrationMCP ServersJun 2025
