CryptoStruct
官方用于历史加密货币和预测市场数据的远程MCP服务器:搜索约50万个工具,实时市场统计(OHLC、交易额、价差、深度、滑点)以及tick数据购买。目录和统计无需密钥;账户工具可选OAuth。端点:https://cryptostruct.com/mcp
你可以用 CryptoStruct MCP 做什么?
- 搜索工具目录 — 通过
search_instruments在包括预测市场在内的 35 个交易场所中搜索工具,可使用class=prediction等筛选条件。 - 获取实时市场快照 — 通过
get_market_snapshot请求任何工具的当前 OHLC、VWAP、价差及最优买卖盘深度。 - 分析历史聚合数据 — 拉取日、小时或分钟级别的统计数据(例如
get_daily_stats、get_hourly_stats),用于事件研究或趋势分析。 - 检查存档覆盖范围 — 使用
get_coverage验证某工具自 2021 年以来的日级数据可用性。 - 预览并开始购买 — 使用
preview_checkout试运行数据购买,然后通过create_checkout获取 Stripe URL 或触发信用审批。 - 管理您的账户 — 使用
list_my_orders和get_my_subscription列出历史订单、检索已购买的文件下载,并查看订阅或信用余额。
文档
CryptoStruct MCP 服务器
面向 cryptostruct.com 的官方远程 MCP 服务器 —— 提供历史加密货币和预测市场数据(来自 35 个交易场所的逐笔级每日文件,包括 Kalshi 和 Polymarket)以及实时市场统计,专为交易者、量化分析师和 AI 代理构建。
本仓库记录的是托管服务器。这里无需安装或运行任何内容 —— 服务器由 CryptoStruct 运营。
- 端点:
https://cryptostruct.com/mcp(Streamable HTTP,无状态,JSON 模式) - OAuth 端点:
https://cryptostruct.com/mcp/auth(相同工具;响应401+WWW-Authenticate以触发标准 OAuth 流程 —— 动态客户端注册 + PKCE) - 服务器卡片:
/.well-known/mcp/server-card.json - 文档: https://cryptostruct.com/docs/mcp · 产品文档:https://docs.cryptostruct.com
无需 API 密钥 —— 目录、市场统计和访客购买流程均可无密钥使用。通过 OAuth 登录(可选)可将您的 CryptoStruct 账户关联起来,用于订单历史、已购文件下载和使用积分支付 —— 始终在您同意的前提下进行(参见购买数据)。
快速开始
Claude Code
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
# or, to enable account sign-in via OAuth:
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp/auth
Cursor / 通用 JSON 配置
{
"mcpServers": {
"cryptostruct": {
"url": "https://cryptostruct.com/mcp"
}
}
}
claude.ai —— 设置 → 连接器 → 添加自定义连接器 → https://cryptostruct.com/mcp/auth
您可以做什么
- 目录与发现: 搜索 35 个交易场所(现货、永续合约、期货、期权、预测市场)中约 50 万个工具,日级档案覆盖可追溯至 2021-02-08。
- 预测市场: Kalshi 和 Polymarket 的事件合约是一等公民工具 —— 可在目录中搜索(
class=prediction),与任何加密货币工具一样提供覆盖范围、实时快照和分钟/日级聚合数据。合约报价为 0..1(美元);成交额以美元归一化。 - 市场统计: 实时快照和分钟/小时/日级聚合数据 —— OHLC、VWAP、成交笔数、成交额、价差、最优买卖盘深度;滑点 / 市场冲击曲线。
- 购买数据: 原始逐笔文件 —— 加密货币和预测市场工具均适用 —— 每个工具日收费 1 欧元。银行卡支付:服务器转交 Stripe 结账 URL —— 支付在用户浏览器中完成,服务器绝不接触银行卡信息。无需任何购买即可获取免费的全天示例文件。
- 积分与代理同意(OAuth 登录): 未经用户同意,代理绝不会花费账户积分。默认情况下,
create_checkout响应approval_required并显示一个批准页面,用户在其中确认(使用积分或银行卡支付)或放弃订单;未批准的订单在 24 小时后过期,不收取任何费用。用户可以在 https://cryptostruct.com/account/agents 选择启用限额内的自主购买(每笔订单和滚动 24 小时上限)—— 之后完全由积分覆盖的订单会立即完成;超出上限的部分会返回请求批准。代理还可以额外传递自己的max_credit_cents。preview_checkout会提前告知代理三种结果中应预期哪一种。这些设置只能在网站上更改,绝不能通过代理的令牌更改。 - 账户工具(OAuth 登录): 列出订单、获取已购文件的下载 URL、查看订阅、积分余额和代理消费设置。
工具
| 工具 | 描述 | 层级 |
|---|---|---|
get_data_dictionary | 数据字典与产品参考(文件格式、单位、定价) | 免费 |
search_instruments | 搜索工具目录 | 免费 |
list_venues | 列出覆盖的交易场所 | 免费 |
get_instrument | 工具详情 | 免费 |
get_coverage | 工具日级档案覆盖范围 | 免费 |
list_sample_files | 免费全天示例文件 | 免费 |
get_price_quote | 一组数据文件的报价 | 免费 |
get_market_snapshot | 实时市场快照(60 分钟 + 24 小时) | 免费 |
get_daily_stats | 日级聚合数据(30 天–180 天免费;365 天/最大为高级版) | 免费 |
get_hourly_stats | 小时级聚合数据(7 天–90 天免费;180 天为高级版) | 免费 |
get_slippage | 滑点 / 市场冲击曲线(1 小时免费;24 小时/7 天为高级版) | 免费 |
get_top_instruments | 按实时 24 小时成交额排名的顶级工具 | 免费 |
get_movers | 24 小时涨跌榜(涨幅榜与跌幅榜) | 免费 |
get_minutes_range | 用于事件研究的历史分钟序列 | 高级版 |
create_checkout | 发起购买 —— Stripe URL(银行卡)或 approval_required / 已付清(积分,按用户同意设置) | 商务 |
get_checkout_status | 通过 session_id(银行卡)或 order_id(已登录;积分/批准订单)轮询结账状态 | 商务 |
get_order_files | 列出已支付订单的文件及下载 URL | 商务 |
request_file_restore | 恢复归档(冷存储)文件 | 商务 |
list_my_orders | 我的订单 | 登录 |
get_my_files | 我已购买的文件 | 登录 |
get_my_subscription | 我的订阅、积分余额与代理消费设置 | 登录 |
preview_checkout | 购买试运行:已拥有/不可用的文件、积分覆盖情况,以及 create_checkout 将完成、请求批准还是转交 Stripe | 登录 |
层级: free/commerce 无需密钥即可使用。sign-in 需要经过验证的 OAuth 登录(任何账户)。premium 工具/参数需要 CryptoStruct 高级版(每月 20 欧元)—— 同时解锁更长的统计窗口(日级 365 天/最大、小时级 180 天、滑点 24 小时/7 天)、更大的搜索限制、get_market_snapshot 中的数据质量模块,以及 5 倍的调用预算。超出您层级的调用会返回静态的 AUTH_REQUIRED / PREMIUM_REQUIRED 错误并附带升级 URL —— 绝不会硬性失败。
速率限制
按调用者加权的预算:120 单位/分钟 无密钥(按 IP)或按已登录用户,600 单位/分钟 为高级版。廉价的目录读取消耗 1 单位,上游负载较重的统计消耗 3–5,结账消耗 10。遇到 RATE_LIMITED 错误时,请按指示的秒数退避。
约定
- 所有文件大小均为压缩后(zstd)字节;市场价值以美元计;销售价格以欧元计。
- 分钟级数据在上游保留约 30 天;小时/日级聚合数据可追溯更久。
- 逐笔文件是全天 JSON 行格式的捕获(订单簿快照与更新、成交、清算、资金费率、标记/指数价格,包括期权希腊字母)。格式参考:市场数据协议。
相关资源
- 用于解析逐笔文件的代理技能:
cryptostruct-market-data(zip) - 技能发现索引:
/.well-known/agent-skills/index.json - API 目录(RFC 9727):
/.well-known/api-catalog llms.txt:https://cryptostruct.com/llms.txt