MarketTrace Crypto MCP

MarketTrace agent-feed

面向 AI Agent 的只读加密货币永续合约微观结构数据 — 提供跨交易所标准化市场状态，并为每项指标声明覆盖范围和新鲜度。只提供事实和标准化数据，不给出结论：由 Agent 进行解读。

• 托管式 MCP：https://api.markettrace.ai/mcp（Streamable HTTP，OAuth — 无需 API 密钥）
• 官方注册表：ai.markettrace/agent-feed
• 文档：https://markettrace.ai/agents

本仓库是入口 — 包含连接配置、接口约定和轻量级 stdio 桥接。数据管道本身（4 家交易所的数据接入、归档和标准化）不开源。

---

提供的内容

覆盖 Binance、Bybit、OKX、Hyperliquid 的 9 种资产（BTC、ETH、SOL、BNB、XRP、DOGE、HYPE、ZEC、ENA）：

工具	解答的问题
get_market_state	一个标准化快照：资金费率及其过去 2 年的百分位数、OI、交易量、CVD、订单簿失衡、强平、基差和驱动因素。“ETH 的持仓是否过度偏向一方？”
get_funding_percentile	当前资金费率在其过去 2 年区间内的排名（0–100）+ 同号连续时长。
get_liquidations_recent	指定时间窗口内的跨交易所强平名义金额估算：美元金额，以及多头／空头拆分。
get_ohlcv	汇总的跨交易所蜡烛图（5m…1d），含每根蜡烛的 delta（主动买入量 − 主动卖出量），可用于 ATR、区间、CVD 和 RV 计算。
get_conditional_outcomes	满足指定条件后的前向收益历史测量值 — 用基准发生率取代传闻。“历史上，资金费率高于第 90 百分位后发生了什么？”
get_state_history	15 分钟归档中任意数值状态字段的时间序列 — 展示快照背后的趋势。
get_volume_profile	汇总行情数据中按 UTC 日统计的成交量分布水平：POC、价值区高点／低点、价值区宽度及其排名、多日综合分布和裸 POC。“价格是否处于昨日的价值区内？”
get_big_trades	大额主动订单（将交易所、方向和时间戳相同的成交合并为一笔交易）：按方向统计的总额，以及附带交易所、价格和美元金额的最大几笔成交。“巨鲸市价单是在买入还是卖出？”
get_footprint_events	1 分钟 Footprint 中的订单簿墙事件：被吸收和撤走的挂单墙，含以美元计的峰值、成交量和收盘时规模，以及盘口稀薄的分钟。“这次下跌前买盘挂单墙是否被撤走？”
get_stacked_imbalances	汇总行情数据中的堆叠 Footprint 失衡：按蜡烛（1m…1h）统计对角买入和卖出序列，并提供价格区间和美元金额。“今天早上，主动买家在 BTC 的哪些价位集中建仓？”
help	服务器使用指南：按所解答的问题分组列出所有工具，为每个工具提供可用的调用示例，并介绍交易对、刻度的解读方式、限制，以及没有专用工具的数据所在位置（未平仓量、CVD、资金费率）。“哪个工具能提供未平仓量？”

**数据：**资金费率、未平仓量、累计成交量差（CVD）、订单簿深度、强平、带每根蜡烛 delta 的 OHLCV 蜡烛图、成交量分布水平、大额主动订单、订单簿墙事件、堆叠 Footprint 失衡。

**诚实原则：**每项指标都包含 coverage 条目（交易所、窗口深度、新鲜度）；历史数据较少时会披露数据深度，而非编造数字；条件结果在证据低于最低要求时会标记为 history_silent；每条响应都会声明自身时效。报告历史，不做预测。

连接

Claude（网页端/桌面端）： Settings → Connectors → Add custom connector → https://api.markettrace.ai/mcp → 授权（电子邮件魔法链接）。

所有客户端都以相同方式登录：打开浏览器，输入电子邮件地址，然后会收到登录链接。请在开始操作时使用的同一设备和同一浏览器中打开链接。

Claude Code（添加服务不会让你登录，因此请运行以下两项）：

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： 将以下内容添加到 ~/.cursor/mcp.json（或在 https://markettrace.ai/agents 上使用 Add to Cursor），并在 Cursor 提示时登录：

{
  "mcpServers": {
    "markettrace": { "url": "https://api.markettrace.ai/mcp" }
  }
}

仅支持 Stdio 的客户端（通过标准的支持 OAuth 的桥接程序）：

npx -y mcp-remote https://api.markettrace.ai/mcp

更多客户端配置见 examples/mcp-configs.md。

本地 Stdio 桥接程序（本仓库）

mcp_server.py 是一个零依赖的 Stdio 桥接程序：它无需凭据即可启动并响应内省请求（initialize、tools/list）——随附的 tools.json 是托管服务自身契约的快照。设置 MARKETTRACE_BEARER 后，工具调用会代理到托管端点；未设置时，则会返回托管 OAuth 端点的指引，而非数据。它不包含任何方法论——只是一个客户端。

刷新契约： tools.json 是实时服务 tools/list 的 {version, generated_at, tools} 快照——捕获该响应并写入当前契约版本即可重新生成（与 get_market_state 中的 feed.version 保持一致）。

python3 mcp_server.py            # Python 3.9+, no dependencies

也可以使用 Docker：

docker build -t markettrace-bridge . && docker run -i markettrace-bridge

可以询问的问题

• “BTC 的市场状态如何——持仓是否过度？”
• “资金费率高于第 90 百分位后，历史上发生过什么？”
• “过去 3 天的未平仓合约量是如何累积的？”
• “过去一小时 ETH 有多少仓位被清算——是多头还是空头？”
• “BTC 的关键成交量价位在哪里——附近有没有尚未测试的 POC？”
• “过去一小时 SOL 上的大额挂单是否被吸收？”

条款

仅提供市场信息——不构成财务建议。 隐私政策 · 服务条款 · 联系：[email protected]

本仓库中的桥接程序采用 MIT 许可证（LICENSE）；托管服务受上述条款约束。