License

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

heurist-network / heurist-mesh-mcp-server Public

• Notifications
  You must be signed in to change notification settings

• Fork 6

• Star 17

License

MIT license

17 stars
6 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

heurist-network/heurist-mesh-mcp-server

main

Branches
Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------

History
-------

16 Commits

| | |
| mesh_mcp_server | | mesh_mcp_server | | |
| .dockerignore | | .dockerignore | | |
| .env.example | | .env.example | | |
| .gitignore | | .gitignore | | |
| Dockerfile | | Dockerfile | | |
| LICENSE.md | | LICENSE.md | | |
| README.md | | README.md | | |
| glama.json | | glama.json | | |
| pyproject.toml | | pyproject.toml | | |
| uv.lock | | uv.lock | | |
| View all files | | |

Repository files navigation

Mesh Agent MCP Server

A Model Context Protocol (MCP) server that connects to Heurist Mesh
APIs, providing Claude with access to various blockchain and web3 tools.

Heurist Mesh is an open network of purpose-built AI agents and tools, each specialized in particular web3 domains such as blockchain data analysis, smart contract security, token metrics, and blockchain interaction. We are actively growing the Heurist Mesh ecosystem, continuously integrating more tools to expand its capabilities.

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 (Alpha Release)

We provide a hosted SSE endpoint at https://sequencer-v2.heurist.xyz/mcp/sse
. This includes all the tools from the following commonly used agents: CoingeckoTokenInfoAgent, ElfaTwitterIntelligenceAgent, ExaSearchAgent, DexScreenerTokenInfoAgent, ZerionWalletAnalysisAgent. This is a shared server and the performance may be unstable.

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/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

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",  // Update this path\
        "run",\
        "mesh-tool-server"\
      ],
      "env": {
        "HEURIST_API_KEY": "your-api-key-here"  // Update this key
      }
    }
  }
}

Using Docker

Alternatively, you can use Docker with Claude Desktop by adding this to your 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"\
      ]
    }
  }
}

Replace /path/to/mesh-agent-mcp 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)

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

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

Available tools

Customizing Supported Agents

The server comes with a default set of agents. To modify which agents are available:

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

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.

About

No description, website, or topics provided.

Resources

Readme

License

MIT license

Activity

Custom properties

Stars

17 stars

Watchers

1 watching

Forks

6 forks

Report repository

Releases

No releases published

Packages 0

No packages published

Contributors 3

• 
  EntroSanity EntroSanity

• 
  wjw12 JW

• 
  tsubasakong Frank

Languages

• Python 95.1%

• Dockerfile 4.9%

You can’t perform that action at this time.