EVMCP

Name: EVMCP
Author: SiriusLattice

Local

github.com/SiriusLatticeFinance0Updated 29w ago

Repository

About EVMCP

EVMCP is an MCP server that gives AI assistants read-only access to live blockchain data across EVM networks. It combines query tools with companion smart contracts for batch reads and cross-chain data.

Key features

01Read blockchain data across five EVM chains
02Query balances, transactions, contracts, and gas
03Batch reads through Multicall3
04Cross-chain balance and activity queries
05Chain resources and analysis prompts

Use cases

01Comparing wallet balances across chains
02Inspecting and decoding a transaction
03Checking contract data and event logs
04Comparing gas costs across networks

MCP support

EVMCP exposes read-only blockchain tools, resources, and prompts to MCP clients. It supports STDIO or Streamable HTTP transport; companion contracts provide batch querying, registry metadata, event aggregation, and cross-chain data.

#blockchain #web3 #ethereum #base #optimism #avalanche #celo #evm #cross-chain

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

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

Run commandnpx -y evmcp

Environment variables to set

ALCHEMY_API_KEYSecretAlchemy API key for RPC access

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmevmcp0.1.3stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
chain	enum	Yes	Target blockchainbase \| optimism \| avalanche \| celo
address	string	Yes

Details

From the project README

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
`getContractEvents`	Get event logs emitted by a contract on a specific chain
`decodeEventLog`	Decode a raw event log using a provided ABI

Chain and Health (3)

Tool	Description
`getChainInfo`	Get chain name, chain ID, current block number, block time, and native symbol
`isContractDeployed`	Check if an address has contract code deployed on all 5 supported chains
`healthCheck`	Test connectivity to all 6 RPC endpoints (Ethereum, Base, Optimism, Avalanche, Celo, Arbitrum)

Batch (1)

Tool	Description
`batchQuery`	Execute multiple read calls in a single RPC request using Multicall3

Cross-Chain (2)

Tool	Description
`compareBalances`	Compare native token balances for an address across all 5 chains
`crossChainActivity`	Check transaction counts for an address across all 5 chains

Registry (1)

Tool	Description
`queryRegistry`	Read registered tool metadata from the on-chain MCPRegistry companion contract

Optimizer (1)

Tool	Description
`gasOptimizer`	Recommends the cheapest chain for a transaction, accounting for L1 data fees on Base/Optimism/Arbitrum

Resources (4)

URI Pattern	Description	Cache TTL
`chain://{chainId}/status`	Current block height and gas price for a chain	12s
`chain://{chainId}/gas`	Base fee, gas price, and priority fee in gwei	12s
`chain://{chainId}/tokens/popular`	Popular token addresses and decimals (hardcoded for v1)	1 hour
`evmcp://chains`	All supported chains with IDs, symbols, and companion contract addresses	Static

Supported chain IDs for templated resources: 8453 (Base), 10 (Optimism), 43114 (Avalanche), 42220 (Celo), 42161 (Arbitrum).

Prompts (4)

Prompt	Arguments	Description
`analyze-wallet`	`address`	Multi-chain balance and activity analysis of a wallet
`audit-contract`	`contractAddress`, `chain`	Basic inspection and audit workflow for a smart contract
`compare-chains`	(none)	Compare gas costs, speed, and characteristics across all chains
`investigate-tx`	`txHash`, `chain`	Decode, analyze, and trace a transaction in detail

Companion Contracts

Four Solidity contracts are deployed on Avalanche and Celo. The MCP server reads from these contracts to provide batch queries, on-chain tool metadata, and cross-chain data. Base and Optimism deployments are planned.

Avalanche C-Chain (43114)

Contract	Address
MCPRegistry	`0x62402b65bfb4Fd022285A6FC2F26d8caEEc3D055`
BatchQuery	`0xfDc19e0617AdF1811A68Aa1575409F3769f39491`
EventAggregator	`0xECE24a53A28F088351EC2Da258f78479e81A8007`
CrossChainCache	`0x0899a6Ef23c6B39A4D9B877B219645B89209A670`

Celo (42220)

Contract	Address
MCPRegistry	`0x62402b65bfb4Fd022285A6FC2F26d8caEEc3D055`
BatchQuery	`0xfDc19e0617AdF1811A68Aa1575409F3769f39491`
EventAggregator	`0xECE24a53A28F088351EC2Da258f78479e81A8007`
CrossChainCache	`0x0899a6Ef23c6B39A4D9B877B219645B89209A670`

Contract Descriptions

MCPRegistry -- On-chain metadata for all EVMCP tools (names, descriptions, versions). Owner-only writes.
BatchQuery -- Optimized batch reads via Multicall3. Includes multi-balance, multi-contract-check, and multi-token-balance helpers.
EventAggregator -- Caches event count summaries per contract. Updated by the admin CLI.
CrossChainCache -- Stores balance snapshots for cross-chain queries. Updated by the admin CLI.

Environment Variables

Variable	Required	Description
`ALCHEMY_API_KEY`	Yes*	Alchemy API key (covers all chains)
`BASE_RPC_URL`	No*	Override RPC URL for Base
`OPTIMISM_RPC_URL`	No*	Override RPC URL for Optimism
`AVALANCHE_RPC_URL`	No*	Override RPC URL for Avalanche
`CELO_RPC_URL`	No*	Override RPC URL for Celo
`ARBITRUM_RPC_URL`	No*	Override RPC URL for Arbitrum
`ETHEREUM_RPC_URL`	No	Override RPC URL for ENS resolution
`CACHE_TTL_SECONDS`	No	Cache TTL in seconds (default: 15)
`CACHE_MAX_ENTRIES`	No	Max cache entries (default: 1000)
`LOG_LEVEL`	No	debug, info, warn, or error (default: info)
`USE_TESTNETS`	No	Use testnet chains (default: false)

*Provide either ALCHEMY_API_KEY or all five individual chain RPC URLs. **Required when X402_ENABLED=true.

Development

pnpm install
pnpm build
pnpm inspect          # MCP Inspector UI at localhost:6274
pnpm test             # Unit tests
pnpm typecheck        # Type check
pnpm lint             # ESLint

License

MIT

Comments

Markdown supported

Details

Author: SiriusLattice
Language: node
Version: 0.1.3
Transports: stdio
Listed on: Apr 3, 2026
Last updated: 29w ago
Official Registry: io.github.siriuslattice/evmcp

Report

Similar servers

Finance

CCXT

ccxt.com

44.6k

Official CCXT MCP server for market data and trading across 100+ exchanges and prediction markets

basebalance.cloud — x402 RPC & MCP gateway

basebalance.cloud

7.6k

USDC-gated Base JSON-RPC: free 10 req/min, $0.50 per 10k. Failover, cache, /mcp, ledger

Tradingview Mcp Server

tradingmcp.ai

5.2k

TradingMCP puts a market analyst inside your AI assistant. Paste one URL into Claude, ChatGPT, Cursor, VS Code or any MCP client and ask in plain language: screen for breakouts, run a multi-timeframe analysis, backtest a

EdgarTools

github.com/dgunning

2.8k

Open-source SEC EDGAR toolkit. 11 tools and 7 research prompts covering every major filing type — 10-K, 10-Q, 8-K, Form 4 insider trades, 13F institutional holdings, Form D private placements, Form ADV investment advisers, DEF 14A proxy statements, SC 13D/G ownership, and NPORT.

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.

EVMCP

About EVMCP

Key features

Use cases

MCP support

Configuration

Tools

Details

evmcp

How it Works

Quick Start

With Claude Desktop

With Claude Code

Supported Chains

Tools (29 total)

Balance (3)

Block (3)

Transaction (3)

Contract (3)

Token (2)

Gas (3)

ENS (2)

Events (2)

Chain and Health (3)

Batch (1)

Cross-Chain (2)

Registry (1)

Optimizer (1)

Resources (4)

Prompts (4)

Companion Contracts

Avalanche C-Chain (43114)

Celo (42220)

Contract Descriptions

Environment Variables

Development

License

Comments

New to MCP?

What is MCP (Model Context Protocol)?

How do MCP servers differ from clients?

Should I use a local or a remote server?

How do I install a server in Claude, Cursor and others?

Are listed projects reviewed? What does “Verified” mean?

My project is listed. How do I claim it?