Mesh Agent MCP Server

Features

• Connects to the Heurist Mesh API
• Loads tools for cryptocurrency data and Web3 use cases
• Supports both SSE and stdio transports
• Works with Claude in Cursor, Claude Desktop, and other MCP-compatible interfaces
• Use one API key to access multiple services (e.g. CoinGecko crypto market data, GoPlus token security review)

🔥 Just In: Customize Your Agents and Create Managed MCP Servers On-Demand

Hosted SSE Endpoint

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/yourusername/heurist-mesh-agent-mcp.git
cd heurist-mesh-agent-mcp

# Install the package
uv pip install -e .

Using Docker

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

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

Usage

Option 1: Run with stdio Transport (for Claude Desktop)

Using UV

claude_desktop_config.json

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

Using Docker

claude_desktop_config.json

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

/path/to/mesh-agent-mcp

your-api-key-here

Option 2: Run with SSE Transport (for Cursor)

Setting up Environment Variables in

.env

cp .env.example .env
HEURIST_API_KEY=your-api-key-here

Using UV:

uv run mesh-tool-server --transport sse --port 8000

Using Docker:

docker run -p 8000:8000 -e PORT=8000 mesh-tool-server

Available Tools

Featured tools

Customizing Supported Agents

1. Open the

   server.py

   file and locate the

   Config

   class.
2. Edit the

   DEFAULT_AGENTS

   list to add or remove agents listed at Heurist Metadata

DEFAULT_AGENTS = [
    "CoinGeckoTokenInfoAgent",
    "DexScreenerTokenInfoAgent",
    "ElfaTwitterIntelligenceAgent",
    "ExaSearchAgent",
    "FirecrawlSearchAgent",
    "GoplusAnalysisAgent",
    # Add agents here
    "NewAgent"
]

License