ethereum-rpc-mpc MCP Server

Use This MCP server To

Query Ethereum blockchain state and transaction data Fetch account balances and token holdings Interact with smart contracts via JSON-RPC calls Monitor blockchain events and logs in real time Enable AI-driven blockchain analytics and reporting Integrate blockchain data into AI-enhanced applications Automate blockchain data retrieval for decentralized apps Support multi-chain EVM-compatible blockchain interactions

README

Ethereum RPC MPC Server

A TypeScript MCP server that leverages the MCP SDK to support all Ethereum JSON-RPC calls, enabling AI models to interact with blockchain data.

Overview

This project provides a Model Context Protocol (MCP) server that allows AI assistants like Cursor or Claude (or any MCP Client implementation) to interact with Ethereum blockchain data through standardized JSON-RPC interfaces. It acts as a bridge between AI models and EVM blockchains, enabling seamless access to on-chain data and functionality.

Installation

# Clone the repository
git clone git@github.com:Phillip-Kemper/ethereum-rpc-mpc.git
cd ethereum-rpc-mpc

# Install dependencies
yarn install

# Build the project
yarn build

# Start Inspector with default Ethereum RPC (you can change in the inspector settings on )
yarn inspector

Usage

Using with Cursor

To use this MPC server with Cursor:

In Cursor, go to Settings > Cursor Settings > MCP
Add a new MCP server with the following configuration:
- Name: Ethereum RPC
- Type: Command
- Command: npx -y ethereum-rpc-mpc https://eth.llamarpc.com Ethereum or
- Command: node /path/to/ethereum-rpc-mpc/dist/server/index.js https://eth.llamarpc.com Ethereum

Analytics

You can also enable analytics using MCP Analytics Middleware to get an overview about number of requests, duration of requests as well as error reporting for all your tools and resources. To enable it, just pass the --analytics flag and additionally a path for the Sqlite File.

Command: npx -y ethereum-rpc-mpc https://eth.llamarpc.com Ethereum --analytics --db-path /Users/satoshi/Desktop/analytics.db

Starting the Server

You can start the server by providing an Ethereum RPC URL and an optional chain name:

yarn start [RPC_URL] [CHAIN_NAME]

# Using npx (without installing)
npx -y ethereum-rpc-mpc [RPC_URL] [CHAIN_NAME]

If no RPC URL is provided, it will default to "https://eth.llamarpc.com".

Example:

# Connect to Ethereum mainnet
yarn start https://eth.llamarpc.com Ethereum

# Connect to Zircuit
yarn start https://mainnet.zircuit.com Zircuit

Examples

Here are some examples of how to use the Ethereum RPC MPC server with Claude:

Getting the Current Block Number

What's the current block number?

Checking an Address Balance

What's the ETH balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?

Getting Contract Information

Is 0x6B175474E89094C44Da98b954EedeAC495271d0F a smart contract? If yes, what kind of contract is it?

Retrieving Transaction Details

Can you show me the details of transaction 0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060?

Zircuit SLS (Sequencer Level Security) Methods

This server includes special support for Zircuit-specific RPC methods. These methods are not enabled by default but are automatically activated when connecting to a Zircuit endpoint (Chain ID: 48900).

The supported Zircuit methods include:

zirc_isQuarantined: Check if a specific transaction is quarantined
zirc_getQuarantined: Query all quarantined transactions with optional address filtering

These methods are particularly useful for monitoring transaction quarantine status.

Future Steps

Next to RPC, also support indexed API access

We plan to extend the functionality beyond basic RPC calls to include support for indexed blockchain data APIs. This will enable more efficient querying of historical data and complex on-chain analytics.

Multi Chain, Multi RPC Support

Future versions will support connecting to multiple chains and RPC endpoints simultaneously, allowing AI models to access data across different blockchains in a single session.

Client Implementation

A future enhancement will be to develop a client-side implementation that makes it easier to interact with this MCP server from various applications.

Server Analytics

We plan to add analytics capabilities to track usage patterns, popular RPC methods, and performance metrics. This will help optimize the server and provide insights into how AI models are interacting with blockchain data.

License

MIT

ethereum-rpc-mpc FAQ

How do I install ethereum-rpc-mpc?

Clone the GitHub repo, install dependencies with yarn, build the project, and start the server as per the README instructions.

Can ethereum-rpc-mpc support all Ethereum JSON-RPC methods?

Yes, it supports the full range of Ethereum JSON-RPC calls, enabling comprehensive blockchain interaction.

Which AI models can interact with ethereum-rpc-mpc?

Any MCP client-compatible AI model like Cursor, Claude, or GPT-4 can interact with this server.

Is ethereum-rpc-mpc limited to Ethereum mainnet?

No, it supports any EVM-compatible blockchain network accessible via JSON-RPC endpoints.

How does ethereum-rpc-mpc ensure secure blockchain interactions?

It leverages MCP's secure, scoped, and observable model interaction principles to safely expose blockchain data.

Can ethereum-rpc-mpc be extended to support custom blockchain methods?

Yes, developers can extend the server to add support for additional or custom JSON-RPC methods as needed.

What programming language is ethereum-rpc-mpc written in?

It is implemented in TypeScript, leveraging the MCP SDK for protocol compliance.

Does ethereum-rpc-mpc provide real-time blockchain event monitoring?

Yes, it can monitor blockchain events and logs, enabling AI models to react to on-chain changes in real time.