Supports testing and interacting with all server endpoints through curl commands, including connecting to SSE streams, subscribing to address updates, and triggering address information requests.
Manages environment variables for the server configuration, including port settings through a .env file.
Provides information about Ethereum addresses across multiple chains, including real-time updates through Server-Sent Events (SSE). Allows querying address details with tools like 'get-address-info' and receiving live updates for subscribed addresses.
Supports repository cloning for installation and setup of the MCP server.
Handles dependency management and provides scripts for starting the server.
MCP Ethereum Address Info Server
This server provides information about Ethereum addresses across multiple chains using the Model Context Protocol (MCP). It includes a Server-Sent Events (SSE) endpoint for real-time updates.
Table of Contents
Setup
- Clone the repository:
- Install dependencies:
- Create a
.env
file with the following variables:
Running the Server
Start the HTTP MCP server:
This will start the server on port 3002 (or the port specified in your .env
file).
Available Endpoints
The server provides the following endpoints:
GET /health
- Server health checkPOST /mcp
- MCP endpoint for tool callsGET /sse
- Server-Sent Events endpoint for real-time updatesGET /sse/clients
- Get information about connected SSE clientsPOST /sse/subscribe/:clientId
- Subscribe to address updatesPOST /sse/unsubscribe/:clientId
- Unsubscribe from address updates
Using the SSE Endpoint
The SSE endpoint allows clients to receive real-time updates from the server. Here's how to use it:
- Connect to the SSE endpoint
- Get your client ID from the connection response
- Subscribe to specific addresses
- Receive real-time updates for those addresses
Testing with Curl
1. Connect to the SSE Endpoint
This will establish a connection to the SSE endpoint and start receiving events. The connection will remain open until you manually terminate it.
2. Check Connected Clients
3. Subscribe to Address Updates
After connecting to the SSE endpoint, you'll receive a client ID. Use that ID to subscribe to address updates:
Replace YOUR_CLIENT_ID
with the client ID you received when connecting to the SSE endpoint.
4. Unsubscribe from Address Updates
5. Trigger an Address Update
To trigger an address update (which will be sent to subscribed clients), call the get-address-info
tool:
6. Check Server Health
7. Test the Ping Tool
Example Workflow
Here's a complete workflow for testing the SSE functionality:
- Start the server:
- In a new terminal, connect to the SSE endpoint:You'll receive a response like:
- Note the
clientId
from the response. - In another terminal, subscribe to address updates:
- Trigger an address update:
- In the terminal where you're connected to the SSE endpoint, you'll see updates for the address.
Automated Testing Script
For a more automated test, you can use this bash script:
Save this as test_sse.sh
, make it executable with chmod +x test_sse.sh
, and run it with ./test_sse.sh
.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides real-time information about Ethereum addresses across multiple chains using the Model Context Protocol, featuring a Server-Sent Events endpoint for live updates.
Related MCP Servers
- AsecurityAlicenseAqualityFacilitates interaction with Ethereum blockchain data via Etherscan's API, providing real-time access to balances, transactions, token transfers, contract ABIs, gas prices, and ENS name resolutions.Last updated -61922TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.Last updated -3118TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, providing services like token transfers, contract interactions, and ENS resolution through a unified interface.Last updated -28613301TypeScriptMIT License
- -securityAlicense-qualityA server that provides real-time cryptocurrency data through the Model Context Protocol, allowing access to detailed exchange information and current cryptocurrency rates from the CoinCap API.Last updated -11TypeScriptMIT License