Connects to the Heurist Mesh API to provide access to specialized web3 AI agents for analyzing blockchain data, smart contract security, token metrics, and blockchain interactions.

Installation

UV (Recommended)

git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server
uv pip install -e .

Docker

git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server
docker build -t mesh-tool-server .

Configuration

Claude Desktop (UV)

{
  "mcpServers": {
    "heurist-mesh-agent": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/heurist-mesh-mcp-server/mesh_mcp_server",
        "run",
        "mesh-tool-server"
      ],
      "env": {
        "HEURIST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop (Docker)

{
  "mcpServers": {
    "mesh-agent": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "TRANSPORT=stdio",
        "-e", "HEURIST_API_KEY=your-api-key-here",
        "mesh-tool-server"
      ]
    }
  }
}

Available Tools

Tool	Description
get_coingecko_id	Search for a token by name to get its CoinGecko ID
get_token_info	Get detailed token information and market data using CoinGecko ID
get_trending_coins	Get current top trending cryptocurrencies on CoinGecko
get_specific_pair_info	Get information about a trading pair by chain and pair address on DexScreener
get_token_pairs	Get trading pairs by chain and token address on DexScreener
get_token_profiles	Get basic information about latest tokens from DexScreener
search_pairs	Search trading pairs on DexScreener by name, symbol, or token address
get_trending_tokens	Get current trending tokens on Twitter
search_account	Analyze Twitter account with mention search and account statistics
search_mentions	Search for mentions of specific tokens or topics on Twitter
answer	Get a direct answer to a question using the Exa API
search	Search web pages by query
search_and_answer	Perform search and answer operations for a query
execute_search	Execute web search with web page reading
generate_queries	Generate related search queries on a topic to expand research

Features

• Connects to the Heurist Mesh API
• Loads tools for cryptocurrency data and Web3 use cases
• Supports SSE and stdio transports
• Works with Claude in Cursor, Claude Desktop, and other MCP-compatible interfaces
• Use a single API key to access multiple services (e.g., CoinGecko cryptocurrency market data, GoPlus token security reviews)
• Hosted SSE endpoint available
• Customizable agent selection

Environment Variables

Required

• HEURIST_API_KEY - API key for accessing Heurist Mesh services

Notes

The hosted SSE endpoint is available at https://sequencer-v2.heurist.xyz/mcp/sse. You can configure supported agents by editing the DEFAULT_AGENTS list in server.py. Free API credits are available with the invite code 'claude'. Use the Heurist Mesh MCP Portal (https://mcp.heurist.ai/) to create SSE MCP servers on demand.