heurist-network/heurist-mesh-mcp-server

A Model Context Protocol (MCP) server that connects to Heurist Mesh APIs - your gateway to Web3 intelligence.
**Heurist Mesh** is the skills marketplace for AI agents. General-purpose AI models lack specialized knowledge about Web3 and often fail to deliver accurate results. Heurist Mesh provides 30+ specialized AI agents that are experts in crypto analytics, ready to give your AI applications the Web3 expertise they need.
Features
- **Gateway to Web3 Intelligence**: Access 30+ specialized crypto analytics agents via MCP
- **Optimized for AI**: Input/output formats optimized for AI agents - fewer tool calls, less token usage
- Supports both SSE and stdio transports
- Works with Claude, Cursor, Claude Desktop, and other MCP-compatible interfaces
- Use one API key to access multiple services (CoinGecko, DexScreener, Twitter analytics, and more)
🔥 Just In: Customize Your Agents and Create Managed MCP Servers On-Demand
You can use Heurist Mesh Console to create SSE MCP Servers. Select your agents and compose a personalized swarm for your tasks!
Hosted SSE Endpoint
We provide a hosted SSE endpoint at https://mesh.heurist.xyz/mcp/sse. **Authentication is required** - you need a Heurist API key (use invite code "claude" for free credits).
Provide your API key via:
- X-HEURIST-API-KEY header (recommended)
- Authorization: Bearer header
- api_key query parameter
This endpoint includes tools from recommended agents for comprehensive Web3 intelligence:
| Agent | Description |
|-------|-------------|
| TokenResolverAgent | Find tokens by address/symbol/name, return normalized profiles and top DEX pools |
| TrendingTokenAgent | Aggregates trending tokens from GMGN, CoinGecko, Pump.fun, Dexscreener, Zora and Twitter |
| TwitterIntelligenceAgent | Twitter/X timeline, tweet detail, and smart search |
| ExaSearchDigestAgent | Web search with concise LLM summarization |
| FundingRateAgent | Binance funding rates, open interest, and spot-futures opportunities |
| AIXBTProjectInfoAgent | Trending project info, fundamental analysis, and market summary |
| ZerionWalletAnalysisAgent | EVM wallet token and NFT holdings analysis |
This is a shared server and the performance may be unstable. For production use, we recommend self-hosting or using Heurist Mesh Console to create dedicated servers.
Cursor can directly access SSE servers. For Claude Desktop users, we recommend installing mcp-proxy to connect to the SSE server.
Prerequisites
- Python 3.10 or higher
- UV package manager (recommended)
- OR Docker
- Get a Heurist API key or you can claim free API credits with invite code "claude"
Installation
Using UV (Recommended)
Using Docker
Usage
Option 1: Run with stdio Transport (for Claude Desktop)
Using UV
To use this with Claude Desktop, add the following to your claude_desktop_config.json:
Using Docker
Alternatively, you can use Docker with Claude Desktop by adding this to your claude_desktop_config.json:
Replace /path/to/heurist-mesh-mcp-server with the actual path to the repository and your-api-key-here with your Heurist API key.
Option 2: Run with SSE Transport (for Cursor)