CacaoTracker MCP

Streamable HTTP

Connect agents to public Maya Protocol analytics, pool data, rewards, positions, reports, and interface activity through CacaoTracker's MCP server.

Endpoints
Use the hosted endpoint for agents and the discovery metadata when a client supports automatic MCP discovery.
https://api.cacaotracker.xyz/mcp
https://api.cacaotracker.xyz/.well-known/mcp.json
Streamable HTTP
Quick Add
Start with a one-click install where supported, or copy the CLI command/config for your client.
VS Code CLI
code --add-mcp '{"name":"cacaotracker","type":"http","url":"https://api.cacaotracker.xyz/mcp"}'

Client Setup

Cursor
Use the quick-add button or paste this into your MCP configuration.
Cursor config
{
  "mcpServers": {
    "cacaotracker": {
      "url": "https://api.cacaotracker.xyz/mcp"
    }
  }
}
VS Code
Add this through MCP: Open User Configuration or workspace .vscode/mcp.json.
VS Code mcp.json
{
  "servers": {
    "cacaotracker": {
      "type": "http",
      "url": "https://api.cacaotracker.xyz/mcp"
    }
  }
}
VS Code command
code --add-mcp '{"name":"cacaotracker","type":"http","url":"https://api.cacaotracker.xyz/mcp"}'
Claude and Claude Code
Add CacaoTracker in your MCP settings using the remote URL.
Claude MCP config
{
  "mcpServers": {
    "cacaotracker": {
      "url": "https://api.cacaotracker.xyz/mcp"
    }
  }
}
Windsurf and Generic MCP
Use the same remote server URL in clients that support Streamable HTTP MCP.
Remote server config
{
  "mcpServers": {
    "cacaotracker": {
      "url": "https://api.cacaotracker.xyz/mcp"
    }
  }
}

Tool Surface

Public
Protocol
Dashboard metrics, latest stats, TVL history, and volume.
Pools
Pool lists, analytics, LUVI comparisons, hourly volume, and TVL history.
Addresses
Public wallet actions, LP rewards, sync status, and impermanent-loss summaries.
Safe jobs
Rate-limited address rewards sync and reward forecast generation.
CACAO and MAYA
CACAO pool positions, global stats, MAYA price, and reward distributions.
Reports and interfaces
Published ecosystem reports, tracked interfaces, swaps, and approved updates.
Tax previews
Public tax-event previews. CSV export is intentionally not exposed in MCP v1.
Security and Limits
CacaoTracker MCP is intentionally scoped to public analytics.

General public MCP requests are rate limited by client IP at 60 per minute by default.

Safe address-scoped jobs are limited to 5 per hour by default.

Tools time out after 20 seconds and responses are capped at 1 MB by default.

Admin routes, API keys, billing, unpublished reports, webhooks, backfills, and raw database access are not exposed.

Example Prompts
Ask your agent for CacaoTracker data once the MCP server is connected.
Show the current Maya Protocol dashboard and summarize TVL, volume, and active pools.
Compare Maya Protocol pools by LUVI over the last 30 days.
For this public address, summarize LP rewards, sync status, and impermanent-loss data: maya1...
Get the latest published ecosystem report and extract the key interface trends.
Preview tax events for these public addresses without exporting CSV.

Troubleshooting

Client cannot connect

Verify the MCP URL is exactly https://api.cacaotracker.xyz/mcp.

No tools visible

Restart the MCP server or client and confirm remote Streamable HTTP MCP is supported.

Rate limited

Wait for the reset window and reduce repeated sync or forecast calls.

Large response

Reduce days, limit, address count, or date range.