MarketTrace agent-feed
Read-only crypto perps microstructure for AI agents — normalized cross-exchange market state with self-declared coverage and freshness on every metric. Facts and normalization, no verdicts: the agent interprets.
- Hosted MCP:
https://api.markettrace.ai/mcp(Streamable HTTP, OAuth — no API keys) - Official registry:
ai.markettrace/agent-feed - Docs: https://markettrace.ai/agents
This repo is the front door — connection configs, the interface contract, and a thin stdio bridge. The data pipeline itself (4-venue ingest, archives, normalization) is not open source.
What it serves
9 assets (BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC, ENA) across Binance, Bybit, OKX, Hyperliquid:
Data: funding rates, open interest, cumulative volume delta (CVD), order-book depth, liquidations, OHLCV candles with per-candle delta, volume-profile levels, large aggressive orders, order-book wall events, stacked footprint imbalances.
Honesty model: every metric carries a coverage entry (venues, window
depth, freshness); thin history answers with disclosed depth instead of
made-up numbers; conditional outcomes go history_silent below the evidence
floor; every response self-declares its age. Reports history, not predictions.
Connect
Claude (web/desktop): Settings → Connectors → Add custom connector →
https://api.markettrace.ai/mcp → authorize (email magic link).
Every client signs in the same way: it opens a browser, you enter your email, and a sign-in link arrives. Open it on the same device and in the same browser where you started.
Claude Code (adding the server does not sign you in, so run both):
claude mcp add --transport http markettrace https://api.markettrace.ai/mcp
claude mcp login markettrace
Codex:
codex mcp add markettrace --url https://api.markettrace.ai/mcp
codex mcp login markettrace
Cursor: add this to ~/.cursor/mcp.json (or use Add to Cursor on
https://markettrace.ai/agents) and sign in when Cursor asks:
{
"mcpServers": {
"markettrace": { "url": "https://api.markettrace.ai/mcp" }
}
}
Stdio-only clients (via the standard OAuth-capable bridge):
npx -y mcp-remote https://api.markettrace.ai/mcp
More client configs in examples/mcp-configs.md.
Local stdio bridge (this repo)
mcp_server.py is a zero-dependency stdio bridge: it starts
and answers introspection (initialize, tools/list) with no credentials —
the bundled tools.json is a snapshot of the hosted server's
own contract. Tool calls are proxied to the hosted endpoint when
MARKETTRACE_BEARER is set; without it they return a pointer to the hosted
OAuth endpoint instead of data. It holds no methodology — just a client.
Refresh the contract: tools.json is a {version, generated_at, tools} snapshot of the live server's tools/list — regenerate it by capturing that response and stamping the current contract version (mirrors feed.version in get_market_state).
python3 mcp_server.py # Python 3.9+, no dependencies
Or with Docker:
docker build -t markettrace-bridge . && docker run -i markettrace-bridge
Things to ask
- "What's the market state for BTC — is positioning stretched?"
- "What happened historically after funding above the 90th percentile?"
- "How did open interest build over the last 3 days?"
- "How much got liquidated on ETH in the last hour — longs or shorts?"
- "Where are the key volume levels on BTC — any untested POCs nearby?"
- "Did a large resting order get absorbed on SOL in the last hour?"
Terms
Informational market data only — not financial advice. Privacy Policy · Terms of Service · Contact: [email protected]
The bridge in this repo is MIT-licensed (LICENSE); the hosted service is governed by the Terms above.