Evmcp

Name: Evmcp
Author: siriuslattice

by siriuslatticecommunityv0.1.3

An MCP server that exposes read-only blockchain tools for querying balances, transactions, contracts, gas, ENS, and cross-chain data across Base, Optimism, Avalanche, Celo, and Arbitrum. It also uses companion on-chain contracts on Avalanche and Celo to support batch queries, registry lookups, event aggregation, and cross-chain balance caching.

From the registry: Multi-chain EVM blockchain data with companion smart contracts

GitHub Repository

Install & configure

Prerequisites

required
Alchemy API key
Sign up at Alchemy for an API key (covers all chains), or provide individual RPC URLs
https://www.alchemy.com

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `evmcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Alchemy API key** — Sign up at Alchemy for an API key (covers all chains), or provide individual RPC URLs (https://www.alchemy.com)

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","evmcp"]
- required environment variables:
  - `ALCHEMY_API_KEY`: Alchemy API key (covers all chains). Alternatively set individual RPC URLs (example: `<your-alchemy-api-key>`)
- optional environment variables:
  - `BASE_RPC_URL`: Override RPC URL for Base
  - `OPTIMISM_RPC_URL`: Override RPC URL for Optimism
  - `AVALANCHE_RPC_URL`: Override RPC URL for Avalanche
  - `CELO_RPC_URL`: Override RPC URL for Celo
  - `ARBITRUM_RPC_URL`: Override RPC URL for Arbitrum
  - `ETHEREUM_RPC_URL`: Override RPC URL for ENS resolution
  - `CACHE_TTL_SECONDS`: Cache TTL in seconds (example: `15`)
  - `CACHE_MAX_ENTRIES`: Max cache entries (example: `1000`)
  - `LOG_LEVEL`: Log level (example: `info`)
  - `USE_TESTNETS`: Use testnet chains (example: `false`)
  - `TRANSPORT`: Transport: stdio (default) or http (example: `stdio`)
  - `HTTP_PORT`: HTTP transport port (example: `3402`)

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Tools (29)

getBalance

Get the native token balance 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 supported chains in parallel

getBlock

Get a block by its hash on a specific chain

getBlockByNumber

Get a block by its number on a specific chain or latest block

getLatestBlock

Get the latest block number, timestamp, and base fee for a specific chain

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

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

getERC20Info

Environment variables

ALCHEMY_API_KEYrequiredAlchemy API key used for chain RPC access across all chains

Packages

evmcp

npmv0.1.3transport: stdio

Details

Language: TypeScript
License: MIT
Released: Apr 3, 2026
Last commit: Apr 9, 2026
Registry name: io.github.siriuslattice/evmcp

Related Servers

Edgartools

Open-source SEC EDGAR toolkit — 11 tools, 7 prompts, every filing type. No API key required.

2.6k

edgar.tools SEC Intelligence

SEC filing intelligence — insider sentiment, material events, financial ratios, disclosure search.