Crypto perps data for AI agents: funding rates, open interest, liquidations, order book, CVD.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Remote HTTPChoose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
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
7 assets (BTC, ETH, SOL, BNB, XRP, DOGE, HYPE) across Binance, Bybit, OKX, Hyperliquid:
| Tool | What it answers |
|---|---|
get_market_state | One normalized snapshot: funding + its trailing 2-year percentile, OI, volume, CVD, order-book imbalance, liquidations, basis, drivers. "Is ETH positioning stretched?" |
get_funding_percentile | Current funding ranked against its own trailing 2-year window (0–100) + same-sign streak. |
get_liquidations_recent | Cross-exchange liquidation notional estimates for a window: USD, long/short split. |
get_ohlcv | Consolidated cross-exchange candles (5m…1d) for ATR/range/RV math. |
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?" |
get_state_history | Time series of any numeric state field from the 15-minute archive — the trend view behind the snapshot. |
Data: funding rates, open interest, cumulative volume delta (CVD), order-book depth, liquidations, OHLCV candles.
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).
Claude Code:
Stdio-only clients (via the standard OAuth-capable bridge):
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).
Or with Docker:
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?"
Terms
Informational market data only — not financial advice. Privacy Policy · Terms of Service · Contact: support@markettrace.ai
The bridge in this repo is MIT-licensed (LICENSE); the hosted service is governed by the Terms above.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
npm downloads
6M
Package downloads in the last 30 days.
Last commit
23d ago
Most recent push to the default branch.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about MarketTrace agent Feed
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/markettrace-agent-feed-2)HTML Embed
<a href="https://allmcps.com/mcp/markettrace-agent-feed-2"><img src="https://allmcps.com/api/badge/markettrace-agent-feed-2?style=directory" alt="MarketTrace agent Feed on AllMCPs" /></a>Technical Specs & Signals
CategoryFinance & Fintech
12/12 checks healthy over the last 46d
41Quality signal: Fair · 41/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership7/20
Documentation & tools16/30
Adoption & activity8/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
1 high-severity advisory on record for this package. Most advisories affect transitive dependencies and may not be exploitable in this server's actual usage — this is a directional signal, not a security audit.
Critical 1High 0Medium 0Low 0
Scanned 27d ago via OSV.dev · https://api.markettrace.ai/mcp (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.