AgentCanary MCP Server

MCP server for AgentCanary — the market context layer for autonomous AI agents. Fresh regime classifications, risk scores, narrative momentum, and scenario state via 19 MCP tools, with transparent source trails.

Quick Start

npx agentcanary-mcp

get_track_record is public and works without an API key. Set AC_API_KEY for tiered AgentCanary API tools such as briefs, indicators, regime, signals, and diagnostics.

Claude Desktop Config

{
  "mcpServers": {
    "agentcanary": {
      "command": "npx",
      "args": ["agentcanary-mcp"],
      "env": { "AC_API_KEY": "ac_your_key_here" }
    }
  }
}

Cursor Config

~/.cursor/mcp.json:

{
  "mcpServers": {
    "agentcanary": {
      "command": "npx",
      "args": ["-y", "agentcanary-mcp"],
      "env": { "AC_API_KEY": "ac_your_key_here" }
    }
  }
}

Restart Cursor → all 19 tools available via Composer.

Windsurf Config

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "agentcanary": {
      "command": "npx",
      "args": ["-y", "agentcanary-mcp"],
      "env": { "AC_API_KEY": "ac_your_key_here" }
    }
  }
}

Continue.dev Config

~/.continue/config.json → experimental.modelContextProtocolServers:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "agentcanary-mcp"],
          "env": { "AC_API_KEY": "ac_your_key_here" }
        }
      }
    ]
  }
}

ChatGPT (Custom GPT)

Don't want to install MCP? Use the AgentCanary Custom GPT directly in ChatGPT:

https://chatgpt.com/g/g-6a0f2b6ab07c819188983b3fb43ac62b-agentcanary

All major endpoints exposed as Actions. Free Explorer tier on the shared key.

Get an API Key

curl -X POST https://api.agentcanary.ai/api/keys/create \
  -H "Content-Type: application/json" \
  -d '{"walletAddress": "0xYourWallet"}'

Deposit USDC/USDT on any major EVM chain (Base, Ethereum, Arbitrum, Optimism, Polygon). $5 minimum. Credits never expire.

Tools (19)

| Tool | Tier | Returns | |------|------|---------| | get_briefs | Explorer | Daily market intelligence briefs (4×/day: radar / signal / pulse / wrap) | | get_regime | Builder | Current macro regime, risk gauge (0-100), key drivers, transition probabilities | | get_indicators | Builder | Any of 36 proprietary indicators (Bull Market Support Band, Pi Cycle, Wyckoff, CAPE, Hindenburg…) — pass name= | | get_narratives | Builder | Top active narratives with momentum scores, stage, asset impact | | get_predictions | Builder | Prediction market data (Polymarket, Kalshi) | | get_scores | Explorer | Prediction scoring results (hit / partial / miss after 72h) | | get_scenario_analysis | Signal | Forward scenarios with price targets | | get_signals | Builder+ | 20 sub-types via type=: whale-alerts, fear-greed, funding-rates, btc-etf-flows, vix, credit-stress, sector-rotation, insider-activity, correlations, dxy, oil, yield-curve, market-structure, stablecoin-dominance, whale-positions, cftc-cot, bofa-fms, dispersion, geopolitical-risk, decision-engine | | get_news | Builder | Aggregated market news, filterable by ticker | | get_market_structure | Builder | Orderbook depth, liquidation heatmap, exchange volumes — pass view= | | get_defi | Builder | DeFi yields, stablecoins, chains, unlocks, perps — pass category= | | get_btc_options | Builder | BTC options max pain + volatility skew | | get_central_banks | Signal | Balance sheets, gold, reserves, TIC — pass view= | | get_expectations | Signal | Market expectations (crowded, early, rotation) | | get_macro | Builder | FRED, business cycle, global liquidity, M2, supply chain, high-impact calendar | | get_open_interest | Builder | Cross-exchange OI across 43 perps + top by USD + 4h Δ% shifters | | get_liquidations | Builder | 24h totals + 4h long/short split + per-side event counts + dominant-direction label | | diagnose | Public | Reports whether a key is present; with AC_API_KEY, returns tier, scopes, credits, rate limit, and upgrade path. | | get_track_record | Public | Mean Brier + per-asset hit rates + reliability buckets. No API key needed — same data as agentcanary.ai/record/. Optional ticker filter. |

Pricing

| Tier | Deposit | Calls/day | Adds | |------|---------|-----------|------| | Explorer | free | 50 | briefs + scores | | Builder | $50 USDC | 500 | + indicators / regime / narratives / news / predictions | | Signal | $150 USDC | 2000 | + scenarios / positioning / full content | | Institutional | $500 USDC | unlimited | white-label, SLA |

Per-call cost: $0.01-0.02 from deposit. Credits never expire. No subscriptions.

License

MIT

Diagnose Tool

If any tiered tool returns tier_insufficient, scope_insufficient, or insufficient_credits, call diagnose for the exact upgrade path. Without AC_API_KEY, diagnose reports that only get_track_record is available publicly:

{
  "mcp_version": "1.4.5",
  "tier": "explorer",
  "scopes": ["all"],
  "credits": 50,
  "upgrade_path": "Deposit $50 USDC on Base to upgrade to Builder tier"
}

Tier-Aware Errors

Errors are now structured. Examples:

[tier_insufficient] — endpoint requires a higher tier than your key carries
[scope_insufficient] — your key has restricted scopes (re-issue with broader)
[insufficient_credits] — top up via deposit on Base
[rate_limited] — includes Retry after Ns

AgentCanary