MCP Connector

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.

Works with githubdockeropen webui

90
Spark score
out of 100
Updated 7 months ago
Source checked Aug 10, 2026
Version 1.0.0
Models
universal

Add 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

01

Retrieve blocks, transactions, and network statistics.

02

Analyze address balances, transaction history, and token holder distribution.

03

Generate interactive network visualizations for entity analysis.

04

Perform advanced analytics on blockchain patterns and token metrics.

Source

Get it from source

Spark does not host a copy of it.

Open source

Reports

Agent outcome reports

No reports yet

Capabilities

Tools your agent gets

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

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.