The Mesh Agent MCP Server connects to Heurist Mesh APIs, providing access to blockchain and web3 tools for Claude and other MCP-compatible interfaces.
Blockchain & Crypto Tools: Access specialized AI agents for blockchain data analysis, smart contract security, and token metrics.
Crypto Market Data: Retrieve token information, trending coins, and asset prices via CoinGecko integration.
DEX Analytics: Analyze trading pairs and get token pair data via DexScreener.
Twitter Intelligence: Track trending tokens, search mentions, and analyze account activity for crypto insights.
Web Search: Perform searches, get direct answers, and extract structured data from web pages using Exa and Firecrawl.
Token Security: Check security details of blockchain token contracts via GoPlus.
Integration: Connect with Claude Desktop, Cursor, and other MCP-compatible applications using SSE or stdio protocols.
Unified Access: Use a single API key to access multiple underlying data services.
Supports configuration of API keys and server settings through environment variables stored in .env files.
Provides access to blockchain data and smart contract analysis, including token metrics and interactions with Ethereum-based networks.
Provides security analysis and blockchain data for tokens on the Fantom network through integrated tools.
Supports retrieving token security details and contract analysis for Optimism blockchain via the GoplusAnalysisAgent.
Offers token security analysis and blockchain data retrieval for Polygon network through the GoplusAnalysisAgent.
Enables token security analysis and blockchain data retrieval for Solana tokens through tools like the GoplusAnalysisAgent.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Mesh Agent MCP Serverwhat's the current price of Bitcoin?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Heurist Mesh MCP Server
A Model Context Protocol (MCP) server that connects to Heurist Mesh APIs - your gateway to Web3 intelligence.
Heurist Mesh is the skills marketplace for AI agents. General-purpose AI models lack specialized knowledge about Web3 and often fail to deliver accurate results. Heurist Mesh provides 30+ specialized AI agents that are experts in crypto analytics, ready to give your AI applications the Web3 expertise they need.
Features
Gateway to Web3 Intelligence: Access 30+ specialized crypto analytics agents via MCP
Optimized for AI: Input/output formats optimized for AI agents - fewer tool calls, less token usage
Supports both SSE and stdio transports
Works with Claude, Cursor, Claude Desktop, and other MCP-compatible interfaces
Use one API key to access multiple services (CoinGecko, DexScreener, Twitter analytics, and more)
Related MCP server: Linear MCP Server
🔥 Just In: Customize Your Agents and Create Managed MCP Servers On-Demand
You can use Heurist Mesh Console to create SSE MCP Servers. Select your agents and compose a personalized swarm for your tasks!
Hosted SSE Endpoint
We provide a hosted SSE endpoint at https://mesh.heurist.xyz/mcp/sse. Authentication is required - you need a Heurist API key (use invite code "claude" for free credits).
Provide your API key via:
X-HEURIST-API-KEYheader (recommended)Authorization: Bearer <your-api-key>headerapi_keyquery parameter
This endpoint includes tools from recommended agents for comprehensive Web3 intelligence:
Agent | Description |
| Find tokens by address/symbol/name, return normalized profiles and top DEX pools |
| Aggregates trending tokens from GMGN, CoinGecko, Pump.fun, Dexscreener, Zora and Twitter |
| Twitter/X timeline, tweet detail, and smart search |
| Web search with concise LLM summarization |
| Binance funding rates, open interest, and spot-futures opportunities |
| Trending project info, fundamental analysis, and market summary |
| EVM wallet token and NFT holdings analysis |
This is a shared server and the performance may be unstable. For production use, we recommend self-hosting or using Heurist Mesh Console to create dedicated servers.
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)
Using Docker
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:
Using Docker
Alternatively, you can use Docker with Claude Desktop by adding this to your claude_desktop_config.json:
Replace /path/to/heurist-mesh-mcp-server 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
Using UV:
Using Docker:
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://mesh.heurist.ai/console to view all 30+ available agents and their tools.
Recommended Tools
These tools from our recommended agents cover most Web3 intelligence use cases:
Tool Name | Description | Agent |
token_search | Find tokens by address, symbol, name, or CoinGecko ID | TokenResolverAgent |
token_profile | Get comprehensive token profile with market data, socials, and top pools | TokenResolverAgent |
get_trending_tokens | Aggregated trending tokens from multiple sources | TrendingTokenAgent |
get_market_summary | AI-generated market summary across all trending sources | TrendingTokenAgent |
twitter_search | Smart Twitter search for crypto topics | TwitterIntelligenceAgent |
user_timeline | Get recent tweets from a Twitter user | TwitterIntelligenceAgent |
tweet_detail | Get detailed info about a specific tweet | TwitterIntelligenceAgent |
exa_web_search | Web search with AI summarization | ExaSearchDigestAgent |
exa_scrape_url | Scrape and summarize webpage content | ExaSearchDigestAgent |
get_all_funding_rates | Get funding rates for all Binance perpetual contracts | FundingRateAgent |
get_symbol_oi_and_funding | Get open interest and funding for a specific symbol | FundingRateAgent |
find_spot_futures_opportunities | Find arbitrage opportunities between spot and futures | FundingRateAgent |
search_projects | Search trending projects with fundamental analysis | AIXBTProjectInfoAgent |
get_market_summary | Get AI market summary from AIXBT | AIXBTProjectInfoAgent |
fetch_wallet_tokens | Get EVM wallet token holdings | ZerionWalletAnalysisAgent |
fetch_wallet_nfts | Get EVM wallet NFT holdings | ZerionWalletAnalysisAgent |
Customizing Supported Agents
The server comes with a default set of recommended agents. To modify which agents are available:
Open the
server.pyfile and locate theConfigclass.Edit the
DEFAULT_AGENTSlist to add or remove agents listed at Heurist Metadata
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.
Tools
- coingeckotokeninfoagent_get_categories_list
- coingeckotokeninfoagent_get_category_data
- coingeckotokeninfoagent_get_token_info
- coingeckotokeninfoagent_get_token_price_multi
- coingeckotokeninfoagent_get_tokens_by_category
- coingeckotokeninfoagent_get_top_token_holders
- coingeckotokeninfoagent_get_trending_coins
- coingeckotokeninfoagent_get_trending_pools