> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.chainstack.com/feedback

```json
{
  "path": "/docs/evm-mcp-server",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# EVM MCP server

> Query balances, read contracts, and interact with Ethereum and EVM-compatible blockchains through the EVM MCP server for AI-assisted development.

<Warning>
  **Deprecated.** Use the unified [Chainstack MCP server](/docs/chainstack-mcp-server) at `https://mcp.chainstack.com/mcp` instead. It provides node deployment, documentation search, and platform management in a single remote server — no local setup required.
</Warning>

The **EVM MCP server** is part of Chainstack's RPC Nodes MCP server suite, providing AI models with direct access to Ethereum and EVM-compatible blockchain networks. This server enables real-time blockchain interactions, smart contract calls, and comprehensive blockchain data queries.

## Repository

The EVM MCP server is available in the [chainstacklabs/rpc-nodes-mcp](https://github.com/chainstacklabs/rpc-nodes-mcp) repository, which contains both EVM and Solana blockchain interaction capabilities.

## Supported networks

The EVM MCP server supports all EVM-compatible networks available on Chainstack, including:

* **Ethereum** (Mainnet, Sepolia)
* **Polygon** (Mainnet, Amoy testnet)
* **BNB Smart Chain** (Mainnet, testnet)
* **Arbitrum** (One, Sepolia)
* **Optimism** (Mainnet, Sepolia)
* **Base** (Mainnet, Sepolia)
* **Avalanche** C-Chain
* **And many more** EVM-compatible networks

## Available functions

The EVM MCP server provides comprehensive blockchain interaction capabilities:

### Network information

* **Get supported blockchains** - Retrieve list of available networks
* **Get client version** - Check node client information
* **Get network version** - Retrieve network ID
* **Get chain ID** - Fetch the chain identifier

### Block operations

* **Get latest block number** - Retrieve current block height
* **Get block by number/hash** - Fetch complete block information
* **Get block transaction count** - Count transactions in a block
* **Get block receipts** - Retrieve all transaction receipts for a block

### Account and balance queries

* **Get account balance** - Check ETH/native token balance
* **Get transaction count** - Retrieve account nonce
* **Get contract code** - Fetch smart contract bytecode
* **Get storage values** - Read contract storage slots

### Transaction operations

* **Get transaction by hash** - Retrieve transaction details
* **Get transaction receipt** - Fetch transaction execution results
* **Estimate gas** - Calculate gas requirements for transactions
* **Get gas price** - Retrieve current gas pricing
* **Get fee history** - Analyze historical fee data

### Smart contract interactions

* **Call contract methods** - Execute read-only contract calls
* **Simulate transactions** - Test transactions without execution
* **Get event logs** - Query contract event emissions
* **Get proofs** - Retrieve Merkle proofs for accounts and storage

### Advanced features

* **Debug transaction traces** - Detailed execution analysis
* **Trace calls and blocks** - Comprehensive execution tracing
* **State overrides** - Simulate with modified blockchain state
* **Batch requests** - Execute multiple calls efficiently

## Use cases

The EVM MCP server enables AI applications to:

### DeFi and trading analysis

* **Monitor token balances** and portfolio values
* **Track transaction flows** and trading patterns
* **Analyze gas usage** and optimization opportunities
* **Query DeFi protocol states** and liquidity metrics

### Smart contract development

* **Test contract interactions** before deployment
* **Debug transaction failures** with detailed traces
* **Simulate complex scenarios** with state overrides
* **Validate contract behavior** across different conditions

### Blockchain analytics

* **Extract event data** from smart contracts
* **Analyze block composition** and network activity
* **Track address interactions** and transaction patterns
* **Generate reports** on blockchain metrics

### Real-time monitoring

* **Watch for specific events** or transactions
* **Monitor contract state changes** in real-time
* **Track network congestion** and gas price trends
* **Alert on important blockchain events**

## Integration with AI models

See the [RPC nodes MCP README file](https://github.com/chainstacklabs/rpc-nodes-mcp/blob/main/README.md) for more information on how to integrate the EVM MCP server with AI models.

The EVM MCP server seamlessly integrates with popular AI development environments:

### Cursor

Configure the server in your [Cursor settings](https://docs.cursor.com/context/model-context-protocol) to access Chainstack's knowledge base directly within your conversations.

### Claude Desktop

Configure the server in your [Claude Desktop settings](https://modelcontextprotocol.io/quickstart/user) to access Chainstack's knowledge base directly within your conversations.

### Claude Code

Configure the server in your [Claude Code settings](https://docs.anthropic.com/en/docs/claude-code/mcp) to access Chainstack's knowledge base directly within your conversations.

### Custom AI applications

Use the MCP protocol to integrate Chainstack's documentation into your own AI-powered development tools and assistants.

## Next steps

<CardGroup cols={2}>
  <Card title="Solana MCP server" href="/docs/solana-mcp-server">
    Add Solana blockchain capabilities
  </Card>

  <Card title="Developer Portal MCP server" href="/docs/developer-portal-mcp-server">
    Access documentation and guides
  </Card>

  <Card title="GitHub Repository" href="https://github.com/chainstacklabs/rpc-nodes-mcp" icon="external-link">
    View source code and installation instructions
  </Card>

  <Card title="Ethereum API Reference" href="/reference/ethereum-getting-started">
    Explore available Ethereum methods
  </Card>
</CardGroup>
