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)

Hosted SSE Endpoint

We provide a hosted SSE endpoint at https://sequencer-v2.heurist.xyz/mcp/sse. This includes all the tools from the commonly used agents.

Prerequisites

• Python 3.10 or higher
• UV package manager (recommended) or Docker
• Get a Heurist API key or claim free API credits with invite code "claude"

Installation# Using UV (Recommended)

git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server\n\n# Install the package
uv pip install -e .
```\n\n### Using Docker
```bash\n\n# Clone the repository
git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server\n\n# Build the Docker image
docker build -t mesh-tool-server .

Usage# Option 1: Run with stdio Transport (for Claude Desktop)\n\n#### Using UV

To use this with Claude Desktop, add the following to your claude_desktop_config.json:

{
  "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"
      }
    }
  }
}
```\n\n#### Using Docker
Alternatively, you can use Docker with Claude Desktop by adding this to your `claude_desktop_config.json`:
```bash
{
  "mcpServers": {
    "mesh-agent": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "TRANSPORT=stdio",
        "-e",
        "HEURIST_API_KEY=your-api-key-here",
        "mesh-tool-server"
      ]
    }
  }
}
```\n\n### Option 2: Run with SSE Transport (for Cursor)## Setting up Environment Variables in `.env`
```bash
cp .env.example .env
HEURIST_API_KEY=your-api-key-here
```\n\n#### Using UV:
```bash
uv run mesh-tool-server --transport sse --port 8000
```\n\n#### Using Docker:
```bash
docker run -p 8000:8000 -e PORT=8000 mesh-tool-server

Then, in Cursor, add the MCP Server URL: http://0.0.0.0:8000/sse

Available Tools

Visit https://mesh.heurist.ai/metadata.json or https://mcp.heurist.ai/ to view all available tools.

License

This MCP server is licensed under the MIT License.