Access Ergo Blockchain Data for AI Analysis
Ergo Blockchain MCP Server gives AI assistants standardized access to Ergo blockchain data: address analysis, token analytics, and clustering.
1.0.0Add to Favorites
Why it matters
Integrate AI assistants with the Ergo blockchain, providing direct access to on-chain data for exploration, analysis, and visualization.
Outcomes
What it gets done
Retrieve blocks, transactions, and network statistics.
Analyze address balances, transaction history, and token holder distribution.
Generate interactive network visualizations for entity analysis.
Perform advanced analytics on blockchain patterns and token metrics.
Source
Get it from source
Spark does not host a copy of it.
Open sourceReports
Agent outcome reports
No reports yet
Capabilities
Tools your agent gets
Returns a text summary of detected entities for an address
Displays an interactive D3.js network visualization for address clustering
Overview
Ergo Blockchain MCP Server
Ergo Blockchain MCP Server gives AI assistants standardized access to Ergo blockchain data - blocks, transactions, addresses, and tokens - through blockchain exploration, address analysis, and advanced analytics tools. Use it when an AI assistant needs to explore the Ergo blockchain, analyze addresses and tokens, or cluster related addresses into entities.
What it does
Ergo Blockchain MCP Server is an MCP server that gives AI assistants direct, standardized access to Ergo blockchain data - blocks, transactions, network statistics, addresses, and tokens - through a consistent interface. It enables blockchain exploration, address analysis, token information retrieval, and advanced analytics without the assistant needing to talk to the Ergo Explorer or Node APIs directly.
When to use - and when NOT to
Use it when an AI assistant needs to explore the Ergo blockchain: checking network status, analyzing an address's balance and transaction history, tracking a token's holder distribution over time, or clustering related addresses for entity identification. It requires at minimum the Ergo Explorer API endpoint; advanced functions additionally need a running Ergo node and its API key. It is not the right tool for blockchains other than Ergo, since its tools and data model are specific to the Ergo Explorer and Node APIs.
Capabilities
- Blockchain exploration: retrieve blocks, transactions, and network statistics
- Address analysis: query balances, transaction history, and perform forensic analysis
- Token analytics: view token information, holder distribution, historical ownership, and collection data
- Ecosystem integration: access EIP information, oracle pool data, and address book
- Advanced analytics: analyze blockchain patterns, token metrics, and transaction flows
- Entity identification: discover related addresses via address clustering algorithms
- Interactive visualizations: openwebui_viz_tool renders an interactive D3.js network visualization for address clustering, and openwebui_entity_tool returns a text summary of detected entities for an address
- Response standardization in JSON or Markdown, with built-in token estimation for AI context window optimization
- Historical token holder tracking with block-height tracking
How to install
From source:
git clone https://github.com/ergo-mcp/ergo-explorer-mcp.git
cd ergo-explorer-mcp
pip install -r requirements.txt
python -m ergo_explorer.server
A Docker image is also available. The server requires the environment variable ERGO_EXPLORER_API (the Ergo Explorer API URL). Advanced node-level functions additionally accept the optional ERGO_NODE_API and ERGO_NODE_API_KEY.
Who it's for
Developers and analysts building AI assistants that need to explore the Ergo blockchain - checking balances, tracing transaction history, tracking token holders, or clustering related addresses - through a standardized MCP interface instead of calling the Ergo Explorer and Node APIs directly.
Source README
An MCP server that provides AI assistants with direct access to Ergo blockchain data through a standardized interface, enabling blockchain exploration, address analysis, token information retrieval, and advanced analytics.
Installation
From Source Code
git clone https://github.com/ergo-mcp/ergo-explorer-mcp.git
cd ergo-explorer-mcp
pip install -r requirements.txt
python -m ergo_explorer.server
Docker
docker build -t ergo-explorer-mcp .
docker run -d -p 8000:8000 \
-e ERGO_EXPLORER_API="https://api.ergoplatform.com/api/v1" \
-e ERGO_NODE_API="http://your-node-address:9053" \
-e ERGO_NODE_API_KEY="your-api-key" \
--name ergo-mcp ergo-explorer-mcp
Available Tools
| Tool | Description |
|---|---|
openwebui_entity_tool |
Returns a text summary of detected entities for an address |
openwebui_viz_tool |
Displays an interactive D3.js network visualization for address clustering |
Capabilities
- Blockchain Exploration: Retrieve blocks, transactions, and network statistics
- Address Analysis: Query balances, transaction history, and perform forensic analysis
- Token Analytics: View token information, holder distribution, track historical ownership, and collection data
- Ecosystem Integration: Access EIP information, oracle pool data, and address book
- Advanced Analytics: Analyze blockchain patterns, token metrics, and transaction flows
- Entity Identification: Discover related addresses using advanced address clustering algorithms
- Interactive Visualizations: Generate and interact with network visualizations for entity analysis
- Response Standardization: Support for two formats (JSON/Markdown) with consistent structure
- Token Estimation: Built-in token counting for AI context window optimization
- Historical Token Holder Tracking: Complete token history with block height tracking
Environment Variables
Required
ERGO_EXPLORER_API- URL for Ergo Explorer API
Optional
ERGO_NODE_API- URL for Ergo Node API (optional for advanced functions)ERGO_NODE_API_KEY- API key for Ergo Node API (optional)
Usage Examples
Check blockchain status and network statistics
Analyze address balances and transaction history
Identify entities related to an address using clustering algorithms
Track historical token holder distribution
Monitor token transfers and ownership changes
Notes
The server includes comprehensive entity identification capabilities through address clustering algorithms, integration with Open WebUI for enhanced visualization, and built-in token estimation for AI context optimization. All responses follow a standardized format with metadata including execution time, result size, and token estimates.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.