Heurist Mesh

You can connect to Heurist Mesh MCP Server to tap into 30+ specialized crypto analytics agents for Web3 intelligence. This MCP server enables AI applications to access expert crypto data through standard MCP transports, making it easy to build Web3-aware workflows with secure API key access and configurable agent swarms.

How to use

Connect to the hosted SSE endpoint to access a curated set of crypto analytics agents. You can run local MCP servers via standard MCP clients, or use the hosted endpoint with the appropriate API key. Use the provided tools to resolve tokens, track trends, analyze wallets, summarize markets, and perform web searches with AI-assisted summaries. When using a local or hosted server, you will configure the MCP client to point at the SSE URL or the local stdio interface, and supply your API key to authorize access.

How to install

Prerequisites you need before setup include Python 3.10 or higher and a package manager such as UVX, or Docker for containerized runs. You also need a Heurist API key; you can obtain free credits using the invite code “claude.” Proceed with the installation steps that match your preferred environment.

# Prerequisites
python3 --version
uv --version

# Clone the MCP server repository
git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server

# Option A: Install with UV (recommended)
uv pip install -e .

# Option B: Build with Docker
# Build the Docker image (from the project root)
docker build -t mesh-tool-server .

Additional configuration and notes

The MCP server supports both a hosted SSE endpoint and local stdio-based servers. The hosted endpoint requires an API key included in the request headers or query parameters. Local stdio servers can be started with UV or Docker, and you can configure clients like Claude Desktop or Cursor to connect via SSE or stdio transports.

Configuration options for MCP clients

Use one of the following connection methods in your MCP client configuration. The hosted SSE endpoint is preferred for quick access, while local stdio servers are ideal for production or higher reliability.

Security and access control

Always provide your API key securely to the MCP server. Use the recommended header X-HEURIST-API-KEY or the Authorization header with a Bearer token, or supply the api_key parameter in the request URL. Treat your API key as a secret and rotate it if you suspect compromise.

Troubleshooting

If you encounter unstable performance on the hosted endpoint, consider self-hosting a dedicated MCP server using the local stdio flow described in the installation steps. Ensure your API key is valid and that your client is configured to the correct transport (SSE or stdio). Check logs for authentication errors or transport connectivity issues.

Available tools

token_search

Find tokens by address, symbol, name, or CoinGecko ID and retrieve normalized profiles and top liquidity pools

token_profile

Get comprehensive token profiles including market data, socials, and top pools

get_trending_tokens

Aggregate trending tokens from GMGN, CoinGecko, Pump.fun, Dexscreener, Zora, and Twitter

get_market_summary

AI-generated market summaries across trending sources

twitter_search

Smart Twitter search for crypto topics and trends

user_timeline

Fetch recent tweets from a specified Twitter user

tweet_detail

Retrieve detailed information about a specific tweet

exa_web_search

Web search with AI-generated summarization

exa_scrape_url

Scrape and summarize webpage content

get_all_funding_rates

Fetch funding rates for all Binance perpetual contracts

get_symbol_oi_and_funding

Get open interest and funding rates for a given symbol

find_spot_futures_opportunities

Identify arbitrage opportunities between spot and futures markets

search_projects

Search trending projects with fundamental analysis

fetch_wallet_tokens

Retrieve EVM wallet token holdings

fetch_wallet_nfts

Retrieve EVM wallet NFT holdings