EVM MCP Server

1# ⛽ EVM MCP Server
2 
3> **Complete EVM JSON-RPC access in your AI workflow.** Query any EVM-compatible network (Ethereum, Polygon, Arbitrum, Optimism, BSC, and more) through any node provider. Works with Infura, Alchemy, QuickNode, local nodes, and more.
4 
5An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that provides comprehensive access to Ethereum Virtual Machine (EVM) JSON-RPC methods for AI coding environments like Cursor and Claude Desktop.
6 
7## Why Use EVM MCP?
8 
9- 🌐 **Any EVM Network** – Ethereum, Polygon, Arbitrum, Optimism, BSC, Avalanche, and more
10- 🔌 **Any Node Provider** – Infura, Alchemy, QuickNode, local nodes, or custom RPC
11- 📊 **20+ RPC Methods** – Complete access to blockchain data, transactions, and contracts
12- ⚡ **Easy Setup** – One-click install in Cursor or simple manual setup
13- 🔧 **Flexible Configuration** – Works with any JSON-RPC compatible endpoint
14 
15## Quick Start
16 
17Ready to interact with EVM blockchains? Install in seconds:
18 
19**Install in Cursor (Recommended):**
20 
21[🔗 Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=evm-mcp&config=eyJldm0tbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwiQGphbWVzYW56L2V2bS1tY3AiXX19)
22 
23**Or install manually:**
24 
25```bash
26npm install -g @jamesanz/evm-mcp
27# Or from source:
28git clone https://github.com/JamesANZ/evm-mcp.git
29cd evm-mcp && npm install && npm run build
30```
31 
32## Features
33 
34### 🔢 Blockchain Data
35- **`eth_blockNumber`** – Get latest block number
36- **`eth_getBalance`** – Get account balance
37- **`eth_getTransactionCount`** – Get transaction count (nonce)
38- **`eth_getBlockByNumber`** – Get block information
39- **`eth_getTransactionByHash`** – Get transaction details
40- **`eth_getTransactionReceipt`** – Get transaction receipt
41- **`eth_getCode`** – Get contract bytecode
42- **`eth_getStorageAt`** – Get storage value
43 
44### 🔄 Transactions
45- **`eth_call`** – Execute contract call
46- **`eth_estimateGas`** – Estimate gas for transaction
47- **`eth_sendRawTransaction`** – Send signed transaction
48- **`eth_gasPrice`** – Get current gas price
49 
50### 📊 Events & Logs
51- **`eth_getLogs`** – Get event logs
52 
53### 🌍 Network
54- **`eth_chainId`** – Get chain ID
55- **`net_version`** – Get network version
56- **`net_listening`** – Check if listening
57- **`net_peerCount`** – Get peer count
58 
59### 🌐 Web3
60- **`web3_clientVersion`** – Get client version
61- **`web3_sha3`** – Hash data with Keccak-256
62 
63## Installation
64 
65### Cursor (One-Click)
66 
67Click the install link above or use:
68 
69```
70cursor://anysphere.cursor-deeplink/mcp/install?name=evm-mcp&config=eyJldm0tbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwiQGphbWVzYW56L2V2bS1tY3AiXX19
71```
72 
73### Manual Installation
74 
75**Requirements:** Node.js 18+ and npm
76 
77```bash
78# Clone and build
79git clone https://github.com/JamesANZ/evm-mcp.git
80cd evm-mcp
81npm install
82npm run build
83 
84# Set RPC URL
85export RPC_URL="https://mainnet.infura.io/v3/YOUR_API_KEY"
86export CHAIN_ID="1"
87 
88# Run server
89npm start
90```
91 
92### Claude Desktop
93 
94Add to `claude_desktop_config.json`:
95 
96**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
97**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
98 
99```json
100{
101  "mcpServers": {
102    "evm-mcp": {
103      "command": "node",
104      "args": ["/absolute/path/to/evm-mcp/build/index.js"],
105      "env": {
106        "RPC_URL": "https://mainnet.infura.io/v3/YOUR_API_KEY",
107        "CHAIN_ID": "1"
108      }
109    }
110  }
111}
112```
113 
114Restart Claude Desktop after configuration.
115 
116## Configuration
117 
118### RPC URL Examples
119 
120```bash
121# Infura
122RPC_URL=https://mainnet.infura.io/v3/YOUR_API_KEY
123 
124# Alchemy
125RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY
126 
127# QuickNode
128RPC_URL=https://YOUR_ENDPOINT.quiknode.pro/YOUR_TOKEN/
129 
130# Public endpoints (rate limited)
131RPC_URL=https://bsc-dataseed.binance.org
132RPC_URL=https://polygon-rpc.com
133RPC_URL=https://arb1.arbitrum.io/rpc
134 
135# Local node
136RPC_URL=http://localhost:8545
137```
138 
139### Supported Networks
140 
141- **Ethereum**: Mainnet, Sepolia, Goerli
142- **Polygon**: Mainnet, Mumbai
143- **Arbitrum**: One, Sepolia
144- **Optimism**: Mainnet, Sepolia
145- **BNB Smart Chain**: Mainnet, Testnet
146- **Avalanche**: C-Chain
147- **Fantom**: Opera
148- **Any EVM-compatible chain**
149 
150## Usage Examples
151 
152### Get Latest Block Number
153Query the current block number:
154 
155```json
156{
157  "tool": "eth_blockNumber",
158  "arguments": {}
159}
160```
161 
162### Get Account Balance
163Check an address balance:
164 
165```json
166{
167  "tool": "eth_getBalance",
168  "arguments": {
169    "address": "0x742d35Cc6634C0532925a3b8D6Ac6e2F0C4C9B7C",
170    "blockNumber": "latest"
171  }
172}
173```
174 
175### Get Transaction Details
176View transaction information:
177 
178```json
179{
180  "tool": "eth_getTransactionByHash",
181  "arguments": {
182    "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
183  }
184}
185```
186 
187### Call Smart Contract
188Execute a contract call:
189 
190```json
191{
192  "tool": "eth_call",
193  "arguments": {
194    "to": "0xA0b86a33E6441c8C06DDD46C310c0eF8D9441C8F",
195    "data": "0x70a08231000000000000000000000000742d35Cc6634C0532925a3b8D6Ac6e2F0C4C9B7C"
196  }
197}
198```
199 
200### Get Event Logs
201Query contract events:
202 
203```json
204{
205  "tool": "eth_getLogs",
206  "arguments": {
207    "fromBlock": "0x1234567",
208    "toBlock": "latest",
209    "address": "0xA0b86a33E6441c8C06DDD46C310c0eF8D9441C8F",
210    "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
211  }
212}
213```
214 
215## Use Cases
216 
217- **Blockchain Analytics** – Query transaction data, balances, and contract states
218- **DeFi Applications** – Monitor token balances, transaction receipts, and smart contract calls
219- **NFT Projects** – Track transfers, metadata, and collection statistics
220- **Development Tools** – Debug transactions, estimate gas, and test smart contracts
221- **Monitoring** – Watch for specific events and transaction patterns
222- **Research** – Analyze blockchain data across multiple EVM networks
223 
224## Technical Details
225 
226**Built with:** Node.js, TypeScript, MCP SDK, Ethers.js  
227**Dependencies:** `@modelcontextprotocol/sdk`, `ethers`, `zod`  
228**Platforms:** macOS, Windows, Linux
229 
230**Environment Variables:**
231- `RPC_URL` (required): Any EVM-compatible RPC endpoint
232- `CHAIN_ID` (optional): Chain ID for the network (defaults to 1)
233 
234## Contributing
235 
236⭐ **If this project helps you, please star it on GitHub!** ⭐
237 
238Contributions welcome! Please open an issue or submit a pull request.
239 
240## License
241 
242MIT License – see [LICENSE.md](LICENSE.md) for details.
243 
244## Support
245 
246If you find this project useful, consider supporting it:
247 
248**⚡ Lightning Network**
249```
250lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa
251```
252 
253**₿ Bitcoin**: [bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp](https://mempool.space/address/bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp)
254 
255**Ξ Ethereum/EVM**: [0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f](https://etherscan.io/address/0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f)
256