📌Overview

Purpose: This MCP server connects Claude to various blockchain and web3 tools via the Heurist Mesh APIs, enhancing functionality for users in web3 contexts.

Overview: The Model Context Protocol (MCP) server acts as a bridge to the Heurist Mesh ecosystem, which consists of specialized AI agents designed for tasks related to blockchain, such as data analysis and smart contract security. The server facilitates access to multiple tools with a single API key, streamlining user interactions and capabilities within the blockchain landscape.

Key Features:

API Connectivity: Connects seamlessly to Heurist Mesh API, enabling direct access to a range of web3 tools.
Transport Support: Offers support for both Server-Sent Events (SSE) and standard input/output (stdio) transports, ensuring flexibility in how the server can be used.
Unified API Key: Utilizes a single API key for accessing various services, simplifying user management across different blockchain data and insights.

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 AI agents and tools specialized in web3 domains such as blockchain data analysis, smart contract security, token metrics, and blockchain interaction. The ecosystem is actively growing with continuous integration of new tools.

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)

Customize Your Agents and Create Managed MCP Servers On-Demand

You can use Heurist Mesh MCP Provisioner to create SSE MCP Servers. Select your agents and compose a personalized swarm for your tasks!

Hosted SSE Endpoint

A hosted SSE endpoint is available at https://sequencer-v2.heurist.xyz/mcp/sse. This includes tools from commonly used agents such as CoingeckoTokenInfoAgent, ElfaTwitterIntelligenceAgent, ExaSearchAgent, DexScreenerTokenInfoAgent, and ZerionWalletAnalysisAgent. Note that this is a shared server, so performance may vary.

Cursor can directly access SSE servers. For Claude Desktop users, it is recommended to install 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 claim free API credits with invite code "claude"

Installation

Using UV (Recommended)

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

Using Docker

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

Usage

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

Using UV

Add 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"
      }
    }
  }
}

Using Docker

Add 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",
        "mesh-tool-server"
      ]
    }
  }
}

Replace path and API key accordingly.

Option 2: Run with SSE Transport (for Cursor)

Set 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

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

Available Tools

View all available tools at:

Featured Tools

Tool Name	Description	Agent	Parameters	Required Params
get_coingecko_id	Search token by name to get its CoinGecko ID	CoinGeckoTokenInfoAgent	token_name (string): Token name	token_name
get_token_info	Get token info & market data using CoinGecko ID	CoinGeckoTokenInfoAgent	coingecko_id (string): CoinGecko ID	coingecko_id
get_trending_coins	Get current top trending cryptocurrencies on CoinGecko	CoinGeckoTokenInfoAgent	-	None
get_specific_pair_info	Get trading pair info by chain and pair address on DexScreener	DexScreenerTokenInfoAgent	chain (string): Chain ID pair_address (string): Pair contract address	chain, pair_address
get_token_pairs	Get trading pairs by chain and token address on DexScreener	DexScreenerTokenInfoAgent	chain (string): Chain ID token_address (string): Token contract address	chain, token_address
get_token_profiles	Get basic info of latest tokens from DexScreener	DexScreenerTokenInfoAgent	-	None
search_pairs	Search for trading pairs on DexScreener by token name, symbol, or address	DexScreenerTokenInfoAgent	search_term (string): Search term	search_term
get_trending_tokens	Get current trending tokens on Twitter	ElfaTwitterIntelligenceAgent	time_window (string): Time window to analyze	None
search_account	Analyze a Twitter account with mention search and stats	ElfaTwitterIntelligenceAgent	username (string): Twitter username (without @) days_ago (int) limit (int)	username
search_mentions	Search for mentions of tokens or topics on Twitter	ElfaTwitterIntelligenceAgent	keywords (array): List of keywords days_ago limit (min: 20)	keywords
answer	Get direct answer using Exa's answer API	ExaSearchAgent	question (string): Question	question
search	Search webpages related to a query	ExaSearchAgent	search_term (string) limit (int, default 10)	search_term
search_and_answer	Perform search and answer operations	ExaSearchAgent	topic (string)	topic
execute_search	Execute web search query by reading web pages	FirecrawlSearchAgent	search_term (string)	search_term
generate_queries	Generate related search queries for expanding research	FirecrawlSearchAgent	topic (string) num_queries (int)	topic
fetch_security_details	Fetch security details of blockchain token contract	GoplusAnalysisAgent	contract_address (string) chain_id (int/string): Blockchain chain ID or 'solana'	contract_address

Supported chains include Ethereum (1), Optimism (10), Cronos (25), BSC (56), Gnosis (100), HECO (128), Polygon (137), Fantom (250), KCC (321), zkSync Era (324), ETHW (10001), FON (201022), Arbitrum (42161), Avalanche (43114), Linea Mainnet (59144), Base (8453), Tron (tron), Scroll (534352), opBNB (204), Mantle (5000), ZKFair (42766), Blast (81457), Manta Pacific (169), Berachain Artio Testnet (80085), Merlin (4200), Bitlayer Mainnet (200901), zkLink Nova (810180), X Layer Mainnet (196), and Solana (solana).

Customizing Supported Agents

The server uses a default set of agents. To modify this:

Open server.py and locate the Config class.
Edit the DEFAULT_AGENTS list to add or remove agents listed at Heurist Metadata.

Example:

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

License

This MCP server is licensed under the MIT License. You are free to use, modify, and distribute the software under the MIT License terms.

heurist-mesh-mcp-server

📌Overview

Mesh Agent MCP Server

Features

Customize Your Agents and Create Managed MCP Servers On-Demand

Hosted SSE Endpoint

Prerequisites

Installation

Using UV (Recommended)

Using Docker

Usage

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

Using UV

Using Docker

Option 2: Run with SSE Transport (for Cursor)

Set environment variables in .env

Using UV:

Using Docker:

Available Tools

Featured Tools

Customizing Supported Agents

License

Set environment variables in `.env`