{
  "markdown": "# MarketTrace agent-feed\n\n**Read-only crypto perps microstructure for AI agents** — normalized\ncross-exchange market state with self-declared coverage and freshness on\nevery metric. Facts and normalization, no verdicts: the agent interprets.\n\n- **Hosted MCP**: `https://api.markettrace.ai/mcp` (Streamable HTTP, OAuth — no API keys)\n- **Official registry**: [`ai.markettrace/agent-feed`](https://registry.modelcontextprotocol.io/v0/servers?search=ai.markettrace)\n- **Docs**: https://markettrace.ai/agents\n\nThis repo is the **front door** — connection configs, the interface contract,\nand a thin stdio bridge. The data pipeline itself (4-venue ingest, archives,\nnormalization) is not open source.\n\n---\n\n## What it serves\n\n6 assets (BTC, ETH, SOL, BNB, XRP, DOGE) across **Binance, Bybit, OKX,\nHyperliquid**:\n\n| Tool | What it answers |\n|---|---|\n| `get_market_state` | One normalized snapshot: funding + multi-year percentile, OI, volume, CVD, order-book imbalance, liquidations, basis, drivers. *\"Is ETH positioning stretched?\"* |\n| `get_funding_percentile` | Current funding ranked against its own multi-year history (0–100) + same-sign streak. |\n| `get_liquidations_recent` | Cross-exchange liquidation totals for a window: USD, long/short split. |\n| `get_ohlcv` | Consolidated cross-exchange candles (5m…1d) for ATR/range/RV math. |\n| `get_conditional_outcomes` | Measured forward-return history after a stated condition — base rates instead of folklore. *\"What happened historically after funding above the 90th percentile?\"* |\n| `get_state_history` | Time series of any numeric state field from the 15-minute archive — the trend view behind the snapshot. |\n\n**Data:** funding rates, open interest, cumulative volume delta (CVD), order-book depth, liquidations, OHLCV candles.\n\n**Honesty model:** every metric carries a `coverage` entry (venues, window\ndepth, freshness); thin history answers with disclosed depth instead of\nmade-up numbers; conditional outcomes go `history_silent` below the evidence\nfloor; every response self-declares its age. Reports history, not predictions.\n\n## Connect\n\n**Claude (web/desktop):** Settings → Connectors → *Add custom connector* →\n`https://api.markettrace.ai/mcp` → authorize (email magic link).\n\n**Claude Code:**\n\n```bash\nclaude mcp add --transport http markettrace https://api.markettrace.ai/mcp\n```\n\n**Stdio-only clients** (via the standard OAuth-capable bridge):\n\n```bash\nnpx -y mcp-remote https://api.markettrace.ai/mcp\n```\n\nMore client configs in [`examples/mcp-configs.md`](examples/mcp-configs.md).\n\n## Local stdio bridge (this repo)\n\n[`mcp_server.py`](mcp_server.py) is a zero-dependency stdio bridge: it starts\nand answers introspection (`initialize`, `tools/list`) with no credentials —\nthe bundled [`tools.json`](tools.json) is a snapshot of the hosted server's\nown contract. Tool **calls** are proxied to the hosted endpoint when\n`MARKETTRACE_BEARER` is set; without it they return a pointer to the hosted\nOAuth endpoint instead of data. It holds no methodology — just a client.\n\n**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`).\n\n```bash\npython3 mcp_server.py            # Python 3.9+, no dependencies\n```\n\nOr with Docker:\n\n```bash\ndocker build -t markettrace-bridge . && docker run -i markettrace-bridge\n```\n\n## Things to ask\n\n- *\"What's the market state for BTC — is positioning stretched?\"*\n- *\"What happened historically after funding above the 90th percentile?\"*\n- *\"How did open interest build over the last 3 days?\"*\n- *\"How much got liquidated on ETH in the last hour — longs or shorts?\"*\n\n## Terms\n\nInformational market data only — **not financial advice**.\n[Privacy Policy](https://markettrace.ai/privacy) ·\n[Terms of Service](https://markettrace.ai/terms) ·\nContact: support@markettrace.ai\n\nThe bridge in this repo is MIT-licensed ([LICENSE](LICENSE)); the hosted\nservice is governed by the Terms above.\n",
  "bytes": 4074,
  "sha": "324b73e9d0af82c8948fc780cb40e83a989f24c35d585ab439ae7cfa7deb7c39",
  "repo_slug": "markettrace/markettrace-agent-feed",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_markettrace_agent_feed_70a1ed03/readme"
}