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 <your-api-key> 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)

# Clone the repository
git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server

# Install the package
uv pip install -e .

Using Docker

# Clone the repository
git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server

# Build the Docker image
docker build -t mesh-tool-server .

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:

{
  "mcpServers"

... [View full README on GitHub](https://github.com/heurist-network/heurist-mesh-mcp-server#readme)