evmcp

EVM + MCP — give your AI assistant blockchain superpowers.

MCP server providing real-time access to on-chain data across Base, Optimism, Avalanche, Celo, and Arbitrum, with companion smart contracts deployed on-chain for batch queries and cross-chain data.

How it Works

EVMCP implements the Model Context Protocol (MCP), a standard that lets AI assistants call external tools. When connected, your AI assistant gains 28 read-only blockchain tools it can invoke to query balances, decode transactions, compare gas prices, and more across five EVM chains.

What sets EVMCP apart is its companion smart contracts — four Solidity contracts deployed on Avalanche and Celo that enable batch queries via Multicall3, an on-chain tool registry, event aggregation, and cross-chain balance caching. The MCP server reads from these contracts; all write operations are performed separately by an admin CLI.

Quick Start

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "evmcp": {
      "command": "npx",
      "args": ["-y", "evmcp"],
      "env": { "ALCHEMY_API_KEY": "your_key_here" }
    }
  }
}

With Claude Code

claude mcp add evmcp -- npx -y evmcp

Supported Chains

Chain	Chain ID	Native Token	Companion Contracts
Base	8453	ETH	Not yet deployed
Optimism	10	ETH	Not yet deployed
Avalanche C-Chain	43114	AVAX	Deployed
Celo	42220	CELO	Deployed
Arbitrum One	42161	ETH	Not yet deployed

Ethereum mainnet (chain ID 1) is also supported for ENS resolution only.

Tools (29 total)

Balance (3)

Tool	Description
getBalance	Get the native token balance (ETH/AVAX/CELO) of an address on a specific chain
getTokenBalance	Get the ERC20 token balance of an address on a specific chain
getMultiChainBalance	Get the native token balance of an address across all 5 supported chains in parallel

Block (3)

Tool	Description
getBlock	Get a block by its hash on a specific chain
getBlockByNumber	Get a block by its number on a specific chain, or pass "latest" for the most recent block
getLatestBlock	Get the latest block number, timestamp, and base fee for a specific chain

Transaction (3)

Tool	Description
getTransaction	Get a transaction by its hash on a specific chain
getTransactionReceipt	Get the receipt for a transaction including status, gasUsed, and logs
decodeTransaction	Decode a transaction's function call using a provided ABI

Contract (3)

Tool	Description
readContract	Call a read-only function on a smart contract with a provided ABI
getContractCode	Check if an address has contract code deployed, with bytecode length and hash
getStorageAt	Read the raw value of a storage slot at a specific address

Token (2)

Tool	Description
getERC20Info	Get ERC20 token metadata including name, symbol, decimals, and total supply
getTokenAllowance	Get the ERC20 token allowance granted by an owner to a spender

Gas (3)

Tool	Description
getGasPrice	Get current gas price and EIP-1559 fee data for a specific chain
estimateGas	Estimate gas for a transaction on a specific chain
compareGasAcrossChains	Compare current gas prices across all 5 supported chains

ENS (2)

Tool	Description
resolveENS	Resolve an ENS name (e.g. vitalik.eth) to an Ethereum address via Ethereum L1
lookupAddress	Reverse lookup an address to its ENS name via Ethereum L1

Events (2)

Tool	Description
`getContractEven

... View full README on GitHub