EVM MCP Server

EVM MCP Server

mcpdotdirect
GitHubnpm

About

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

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 hex addresses)

Token Services

  • ERC20 Tokens: Get metadata, check balances, transfer tokens, approve spending allowances
  • NFTs (ERC721): Get collection and token metadata, verify ownership, transfer NFTs, retrieve token URIs
  • Multi-tokens (ERC1155): Get token balances and metadata, transfer tokens with quantity

Smart Contract Interactions

  • Read contract state through view/pure functions
  • Execute state-changing functions with automatic ABI fetching
  • Contract verification to distinguish from EOAs
  • Event logs retrieval and filtering
  • Automatic ABI fetching from Etherscan v2 API across all networks (no need to know ABIs in advance)
  • Multicall support for batching multiple reads in a single RPC call

Transaction Support

  • Flexible wallet support 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

  • Personal message signing for authentication and verification
  • EIP-712 typed data signing for gasless transactions and meta-transactions
  • SIWE (Sign-In With Ethereum) support
  • Permit signatures for gasless token operations
  • Meta-transaction support for relay services

AI-Guided Workflows

Includes 10 AI-friendly prompts that guide agents through complex workflows:

  • Transaction preparation and execution
  • Wallet analysis and holdings review
  • Smart contract exploration with ABI fetching
  • Contract interaction guidance
  • Network information and comparisons
  • Approval auditing and management
  • Error diagnosis and troubleshooting

Supported Networks

Mainnets

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

Testnets

Sepolia, Optimism Sepolia, Arbitrum Sepolia, Base Sepolia, Polygon Amoy, Avalanche Fuji, BSC Testnet, zkSync Sepolia, Linea Sepolia, Scroll Sepolia, Mantle Sepolia, Manta Sepolia, Blast Sepolia, Fraxtal Testnet, Mode Testnet, Metis Sepolia, Kroma Sepolia, Zora Sepolia, Celo Alfajores, Goerli, Holesky, Flow Testnet, Filecoin Calibration, Lumia Testnet.

Usage Notes

  • All tools that accept Ethereum addresses also support ENS names (e.g., 'vitalik.eth')
  • Automatic ABI fetching eliminates the need to know contract ABIs in advance
  • Use stdio mode for CLI tools or HTTP mode with SSE for web applications
  • Configure wallet using either EVM_PRIVATE_KEY or EVM_MNEMONIC for write operations
  • Optional ETHERSCAN_API_KEY enables ABI fetching from block explorers

This server runs through your single 1Server connection. No extra config required.

0Installs
376Stars

Categories

BlockchainAPIWeb3