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.

Links

• API Docs (OpenAPI)
• Website
• The Record (public brief archive)
• Telegram

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