Mesh Agent MCP Server
Blockchain and Web3 tools for Claude via Heurist Mesh MCP Server.
Key Features
Use Cases
README
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)
🔥 Just In: Customize Your Agents and Create Managed MCP Servers On-Demand
You can use Heurist Mesh MCP Portal 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://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/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server
# Install the package
uv pip install -e .
Using Docker
# Clone the repository
git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server
# 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/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
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
Visit https://mesh.heurist.ai/metadata.json or https://mcp.heurist.ai/ to view all available tools.
Featured tools
| Tool Name | Description | Agent | Parameters | Required Params |
|---|---|---|---|---|
| get_coingecko_id | Search for a token by name to get its CoinGecko ID | CoinGeckoTokenInfoAgent | token_name (string): The token name to search for | token_name |
| get_token_info | Get detailed token information and market data using CoinGecko ID (you can't use the token address or name or symbol) | CoinGeckoTokenInfoAgent | coingecko_id (string): The CoinGecko ID of the token | coingecko_id |
| get_trending_coins | Get the 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 identifier (e.g., solana, bsc, ethereum, base)pair_address (string): The pair contract address to look up | chain, pair_address |
| get_token_pairs | Get the trading pairs by chain and token address on DexScreener | DexScreenerTokenInfoAgent | chain (string): Chain identifier (e.g., solana, bsc, ethereum, base)token_address (string): The token contract address to look up all pairs for | chain, token_address |
| get_token_profiles | Get the basic info of the 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 (token name, symbol, or address) | 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 both mention search and account stats | ElfaTwitterIntelligenceAgent | username (string): Twitter username to analyze (without @)days_ago (integer): Number of days to look back for mentionslimit (integer): Maximum number of mention results | username |
| search_mentions | Search for mentions of specific tokens or topics on Twitter | ElfaTwitterIntelligenceAgent | keywords (array): List of keywords to search fordays_ago (integer): Number of days to look backlimit (integer): Maximum number of results (minimum: 20) | keywords |
| answer | Get a direct answer to a question using Exa's answer API | ExaSearchAgent | question (string): The question to answer | question |
| search | Search for webpages related to a query | ExaSearchAgent | search_term (string): The search termlimit (integer): Maximum number of results to return (default: 10) | search_term |
| search_and_answer | Perform both search and answer operations for a query | ExaSearchAgent | topic (string): The topic to search for and answer | topic |
| execute_search | Execute a web search query by reading the web pages | FirecrawlSearchAgent | search_term (string): The search term to execute | search_term |
| generate_queries | Generate related search queries for a topic that can expand the research | FirecrawlSearchAgent | topic (string): The main topic to researchnum_queries (integer): Number of queries to generate | topic |
| fetch_security_details | Fetch security details of a blockchain token contract | GoplusAnalysisAgent | contract_address (string): The token contract addresschain_id (['integer', 'string']): The blockchain chain ID or 'solana' for Solana tokens. Supported chains: 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), Solana (solana) | contract_address |
Customizing Supported Agents
The server comes with a default set of 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
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.
Star History
Repository Owner
Organization
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Hive Intelligence MCP Server
Unified MCP server delivering advanced cryptocurrency and Web3 analytics.
Hive Intelligence MCP Server provides comprehensive cryptocurrency, DeFi, and Web3 analytics via the Model Context Protocol. It enables AI assistants to access and orchestrate over 200 specialized tools covering market data, on-chain analytics, portfolio tracking, and security analysis. The server offers both dynamic and category-specific analytics through a unified MCP interface, facilitating intelligent tool orchestration for diverse crypto data needs.
- ⭐ 7
- MCP
- hive-intel/hive-crypto-mcp
Dappier MCP Server
Real-time web search and premium data access for AI agents via Model Context Protocol.
Dappier MCP Server enables fast, real-time web search and access to premium data sources, including news, financial markets, sports, and weather, for AI agents using the Model Context Protocol (MCP). It integrates seamlessly with tools like Claude Desktop and Cursor, allowing users to enhance their AI workflows with up-to-date, trusted information. Simple installation and configuration are provided for multiple platforms, leveraging API keys for secure access. The solution supports deployment via Smithery and direct installation with 'uv', facilitating rapid setup for developers.
- ⭐ 35
- MCP
- DappierAI/dappier-mcp
Crypto News MCP Server
Real-time cryptocurrency news and summaries for AI agents via Model Context Protocol.
Crypto News MCP Server provides real-time cryptocurrency news and article search services to AI agents using the Model Context Protocol. It aggregates news from NewsData and exposes tools for fetching the latest headlines, keyword-based article search with pagination, and prompt generation for LLM-powered summarization. The server is compatible with MCP clients and can be integrated as a plugin for platforms like Claude Desktop.
- ⭐ 10
- MCP
- kukapay/crypto-news-mcp
Dune Analytics MCP Server
Bridge Dune Analytics data seamlessly to AI agents via a Model Context Protocol server.
Dune Analytics MCP Server provides a Model Context Protocol-compliant server that allows AI agents to access and interact with Dune Analytics data. It exposes tools to fetch the latest results of Dune queries and execute arbitrary queries, returning results in CSV format. The server is easily deployable, supports integration with platforms like Claude Desktop, and requires a Dune Analytics API key for operation.
- ⭐ 31
- MCP
- kukapay/dune-analytics-mcp
MCP Server for Cortex
Bridge Cortex threat analysis capabilities to MCP-compatible clients like Claude.
MCP Server for Cortex exposes the analysis capabilities of a Cortex instance as tools consumable by Model Context Protocol (MCP) clients, such as large language models. It enables these clients to request threat intelligence analyses via Cortex and receive structured results. The server supports easy configuration, secure authentication, and flexible analyzer selection for integrating threat intelligence tasks into automated AI workflows.
- ⭐ 12
- MCP
- gbrigandi/mcp-server-cortex
Web3 Jobs MCP Server
AI-ready MCP server delivering curated, real-time Web3 job listings.
Web3 Jobs MCP Server provides real-time access to curated Web3 job listings from web3.career through a Model Context Protocol (MCP) interface, enabling intelligent job discovery for AI agents. The server supports advanced filtering by location, remote status, job tag, and result limits, and returns results in Markdown format. It enables the generation of natural language prompts for job searches, facilitating seamless integration with AI platforms such as Claude Desktop. Designed for Python 3.10+, it offers flexible deployment and configuration options.
- ⭐ 4
- MCP
- kukapay/web3-jobs-mcp
Didn't find tool you were looking for?