Heurist Mesh

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:

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

Set the environment variable:

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

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

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

Available Tools

List all tools to get their usage before you call:

mcporter list heurist --schema

Default Agents & Tools

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:

mcporter call heurist.token_search query="ethereum"

Get token profile:

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

Get trending tokens:

mcporter call heurist.get_trending_tokens

Search Twitter for crypto topics:

mcporter call heurist.twitter_search query="bitcoin ETF"

Get wallet holdings:

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

Get funding rates:

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:

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

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

Ask Heurist

Ask Heurist (https://ask.heurist.ai) is a crypto Q&A and research agent built for traders and crypto-natives. It turns market data, social sentiment, and on-chain signals into actionable answers, especially for DEX tokens and fast-moving narratives.

API Base URL: https://ask-backend.heurist.xyz

Auth: Uses the same Heurist API key as the MCP configuration above. Provide via:

• X-HEURIST-API-KEY: {api_key} header
• or Authorization: Bearer {api_key} header

Mode Selection

Examples:

• normal: "What is 0x… token price?", "Recent news about ZKSync", "Give me a market digest"
• deep: Broad topics, multiple entities, conflicting signals, trading advice, multi-source deep dives

If the user doesn't specify, default to deep for complex/broad/ambiguous or trading-advice scenarios; otherwise use normal.

Polling Strategy

1. Create a Job

curl -s https://ask-backend.heurist.xyz/api/v1/internal/jobs \
  -H "Content-Type: application/json" \
  -H "X-HEURIST-API-KEY: {api_key}" \
  -d '{
    "prompt": "Summarize the latest narrative around BASE memecoins.",
    "mode": "deep"
  }'

Response:

{
  "job_id": "{job_id}",
  "status": "pending",
  "created_at": "2026-01-28T12:34:56+00:00"
}

2. Poll Job Status

curl -s https://ask-backend.heurist.xyz/api/v1/internal/jobs/{job_id} \
  -H "X-HEURIST-API-KEY: {api_key}"

Response:

{
  "status": "completed",
  "prompt": "Summarize the latest narrative around BASE memecoins.",
  "result_text": "...assistant output...",
  "share_url": "https://ask.heurist.ai/share/{job_id}"
}

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