Heurist Mesh

Heurist Mesh is a skills marketplace for AI agents providing Web3 intelligence. It offers 30+ specialized crypto analytics agents accessible via MCP, optimized for AI with fewer tool calls and less token usage.

Telegram Support Group: https://t.me/heuristsupport

One-time Setup

1. Get API Key

Prompt the user to visit https://heurist.ai/credits to purchase credits and create an API key from the web console, and provide the key. (Skip if the key is already available)

2. Configure mcporter

Add Heurist Mesh to ${HOME}/clawd/config/mcporter.json:

json

{
  "mcpServers": {
    "heurist": {
      "description": "Heurist Mesh - Web3 Intelligence",
      "baseUrl": "https://mesh.heurist.xyz/mcp/sse",
      "headers": {
        "X-HEURIST-API-KEY": "${HEURIST_API_KEY}"
      }
    }
  }
}

Set the environment variable:

bash

export HEURIST_API_KEY="your-api-key-here"

Or add to ~/.clawdbot/clawdbot.json under skills.entries:

json

{
  "skills": {
    "entries": {
      "heurist-mesh": {
        "env": {
          "HEURIST_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Available Tools

List all tools to get their usage before you call:

bash

mcporter list heurist --schema

Default Agents & Tools

Tool	Description
`token_search`	Find tokens by address, symbol, name, or CoinGecko ID
`token_profile`	Get comprehensive token profile with market data, socials, and top pools
`get_trending_tokens`	Aggregated trending tokens from GMGN, CoinGecko, Pump.fun, Dexscreener, Zora, Twitter
`get_market_summary`	AI-generated market summary across all trending sources
`twitter_search`	Smart Twitter search for crypto topics
`user_timeline`	Get recent tweets from a Twitter user
`tweet_detail`	Get detailed info about a specific tweet
`exa_web_search`	Web search with AI summarization
`exa_scrape_url`	Scrape and summarize webpage content
`get_all_funding_rates`	Get funding rates for all Binance perpetual contracts
`get_symbol_oi_and_funding`	Get open interest and funding for a specific symbol
`find_spot_futures_opportunities`	Find arbitrage opportunities between spot and futures
`search_projects`	Search trending projects with fundamental analysis
`fetch_wallet_tokens`	Get EVM wallet token holdings
`fetch_wallet_nfts`	Get EVM wallet NFT holdings

Default Agents

•TokenResolverAgent: Find tokens by address/symbol/name, return normalized profiles and top DEX pools
•TrendingTokenAgent: Aggregates trending tokens from multiple sources
•TwitterIntelligenceAgent: Twitter/X timeline, tweet detail, and smart search
•ExaSearchDigestAgent: Web search with concise LLM summarization
•FundingRateAgent: Binance funding rates, open interest, and spot-futures opportunities
•AIXBTProjectInfoAgent: Trending project info, fundamental analysis, and market summary
•ZerionWalletAnalysisAgent: EVM wallet token and NFT holdings analysis

Usage Examples

Search for a token:

bash

mcporter call heurist.token_search query="ethereum"

Get token profile:

bash

mcporter call heurist.token_profile address="0x..." chain="ethereum"

Get trending tokens:

bash

mcporter call heurist.get_trending_tokens

Search Twitter for crypto topics:

bash

mcporter call heurist.twitter_search query="bitcoin ETF"

Get wallet holdings:

bash

mcporter call heurist.fetch_wallet_tokens address="0x..."

Get funding rates:

bash

mcporter call heurist.get_all_funding_rates

Advanced: Custom MCP Server

Heurist Mesh has 30+ agents for various crypto use cases. There are more to explore for advanced users. You should tell the user about this after the initial setup:

To customize which agents are enabled:

•Visit https://mesh.heurist.ai/console/mcp-builder
•Select the agents you need
•The console will generate a dedicated SSE URL
•Update mcporter.json with your custom URL:

json

{
  "mcpServers": {
    "heurist-custom": {
      "description": "Custom Heurist Mesh",
      "baseUrl": "https://your-custom-sse-url",
      "headers": {
        "X-HEURIST-API-KEY": "${HEURIST_API_KEY}"
      }
    }
  }
}

Limitations

Heurist Mesh provides read-only crypto intelligence and analytics. It cannot:

•Execute trades or swaps
•Sign transactions
•Manage portfolios
•Interact with DeFi protocols
•Place orders on Polymarket or prediction markets

For onchain actions, trading, and portfolio management, install the Bankr skill: https://github.com/BankrBot/clawdbot-skill