Skip to main content
MCP (Model Context Protocol) is an open standard for connecting AI applications to external tools and data sources. Heurist Mesh agents are accessible as MCP servers, providing a standardized way for AI apps to use crypto intelligence tools.

​
Authentication

All MCP endpoints require a Heurist API key. Get one at heurist.ai/credits.

​
Per-Agent MCP Server

Every agent has a dedicated MCP endpoint: 
https://mesh.heurist.xyz/mcp/agents/<AgentName>/

​
Configuration

{
  "mcpServers": {
    "heurist-agent": {
      "url": "https://mesh.heurist.xyz/mcp/agents/TokenResolverAgent/",
      "headers": {
        "X-HEURIST-API-KEY": "your-api-key-here"
      }
    }
  }
}
You can add multiple agents by adding more entries under mcpServers. See mesh.heurist.ai/metadata.json for the full list of agent names.

​
Multi-Agent MCP Server

A curated set of recommended agents is available at a single MCP endpoint: 
https://mesh.heurist.xyz/mcp/

​
Configuration

{
  "mcpServers": {
    "heurist": {
      "url": "https://mesh.heurist.xyz/mcp/",
      "headers": {
        "X-HEURIST-API-KEY": "your-api-key-here"
      }
    }
  }
}

​
Default Agents

AgentDescription
TokenResolverAgentFind tokens by address/symbol/name, return normalized profiles and top DEX pools
TrendingTokenAgentAggregates trending tokens from multiple sources (GMGN, CoinGecko, Pump.fun, Dexscreener, Zora, Twitter)
TwitterIntelligenceAgentTwitter/X timeline, tweet detail, and smart search
ExaSearchDigestAgentWeb search with concise LLM summarization
FundingRateAgentBinance funding rates, open interest, and spot-futures opportunities
AIXBTProjectInfoAgentTrending project info, fundamental analysis, and market summary
ZerionWalletAnalysisAgentEVM wallet token and NFT holdings analysis

​
Default Tools

ToolDescription
token_searchFind tokens by address, symbol, name, or CoinGecko ID
token_profileGet comprehensive token profile with market data, socials, and top pools
get_trending_tokensAggregated trending tokens across all chains and social media
get_market_summaryAI-generated market summary across all trending sources
twitter_searchSmart Twitter search for crypto topics
user_timelineGet recent tweets from a Twitter user
tweet_detailGet detailed info about a specific tweet
exa_web_searchWeb search with AI summarization
exa_scrape_urlScrape and summarize webpage content
get_all_funding_ratesGet funding rates for all Binance perpetual contracts
get_symbol_oi_and_fundingGet open interest and funding for a specific symbol
find_spot_futures_opportunitiesFind arbitrage opportunities between spot and futures
search_projectsSearch trending projects with fundamental analysis
fetch_wallet_tokensGet EVM wallet token holdings
fetch_wallet_nftsGet EVM wallet NFT holdings

​
Custom MCP Server

Heurist Mesh has 30+ agents. To customize which agents are included in your MCP server:
  1. Visit mesh.heurist.ai/console/mcp-builder
  2. Select the agents you need
  3. Get a dedicated SSE URL
  4. Use it in your MCP config:
{
  "mcpServers": {
    "heurist-custom": {
      "url": "https://your-custom-sse-url",
      "headers": {
        "X-HEURIST-API-KEY": "your-api-key-here"
      }
    }
  }
}