MCP 服务器
PolyTest MCP(Model Context Protocol)服务器让 AI 工具直接读取 PolyTest 的市场数据。它可用于 Claude Code、Cursor、VS Code、Codex、Gemini CLI、Claude Desktop 以及其他 MCP 客户端。它的所有工具都是只读的。
连接
托管服务器的地址是 https://mcp.polytest.io/mcp,使用 Streamable HTTP。Claude Code 的命令添加服务器时不需要密钥,之后你再用 PolyTest 账户登录。其他示例发送从 POLYTEST_KEY 环境变量读取的 API 密钥。两种方式见身份验证。
claude mcp add --transport http polytest https://mcp.polytest.io/mcp{
"mcpServers": {
"polytest": {
"url": "https://mcp.polytest.io/mcp",
"headers": {
"Authorization": "Bearer ${env:POLYTEST_KEY}"
}
}
}
}{
"mcpServers": {
"polytest": {
"type": "http",
"url": "https://mcp.polytest.io/mcp",
"headers": {
"Authorization": "Bearer ${POLYTEST_KEY}"
}
}
}
}[mcp_servers.polytest]
url = "https://mcp.polytest.io/mcp"
bearer_token_env_var = "POLYTEST_KEY"gemini mcp add --transport http --header "Authorization: Bearer $POLYTEST_KEY" polytest https://mcp.polytest.io/mcpClaude Code 和 Gemini CLI 的命令在终端中运行。Cursor 的配置写入 ~/.cursor/mcp.json,VS Code 的写入 .mcp.json,Codex 的写入 ~/.codex/config.toml。
身份验证
如果你的客户端支持 OAuth,就用 PolyTest 账户登录。在 Claude Code 中运行 /mcp,选中 polytest,然后选择“Authenticate”。如果用不了 /mcp(比如桌面应用里的 Claude Code),改为在你添加该服务器时所在的文件夹中,用终端运行 claude mcp login polytest。其他客户端会在连接时或首次调用工具时要求你登录。
浏览器会打开一个位于 qpzofvjvtdvdnvgpxplg.supabase.co 的登录链接,这是 Supabase Auth 的地址,PolyTest 用它处理登录。随后页面会转到 www.polytest.io,由你在那里批准连接。之后可以在设置的“已连接的应用”中移除它。
你也可以在请求头 Authorization: Bearer <key> 中发送 API 密钥,X-API-Key 同样有效。在 API 密钥页面创建一个密钥,切勿把它放进 URL。
在 Claude Code 中,密钥通过 --header 参数传入:
claude mcp add --transport http polytest https://mcp.polytest.io/mcp --header "Authorization: Bearer $POLYTEST_KEY"在本地运行
npx -y @polytest/mcp 会用 npm 包 @polytest/mcp 在你自己的机器上运行服务器。它需要 Node 20 或更高版本,并从 POLYTEST_KEY 环境变量读取你的密钥。
claude mcp add --transport stdio --env POLYTEST_KEY=$POLYTEST_KEY polytest -- npx -y @polytest/mcp{
"mcpServers": {
"polytest": {
"command": "npx",
"args": ["-y", "@polytest/mcp"],
"env": {
"POLYTEST_KEY": "pt_live_..."
}
}
}
}Claude Desktop 的配置写入 claude_desktop_config.json。把 pt_live_... 换成你的密钥。
工具
服务器提供五个工具。最后一列是一次调用消耗的 API 请求数。
| 工具 | 返回值 | API 请求数 |
|---|---|---|
polytest_list_markets | 某个币种、某个 market_type 的市场,最新的在前。每行包含时间窗口、status、开盘和收盘时的现货价格、获胜方和成交量。 | 1 |
polytest_get_market | 单个市场,按 market_id 或 slug 查找,包含代币 ID 和结算字段。 | 1 |
polytest_get_snapshots | 单个市场的快照,最早的在前,每条包含 time、spot_price、price_up 和 price_down。加上 include_orderbook 后,每行还带有双边订单簿。 | 1 |
polytest_get_price_series | 单个市场内等间隔的价格点,最早的在前。 | 1 次,每个采样点另加 1 次,默认共 21 次 |
polytest_get_limits | 你的套餐限制:层级、速率限制、并发上限、数据访问范围、密钥数量上限和试用额度。 | 1 |
price_up 是 Up 订单簿上的最低卖价,也就是那一刻买入 Up 要付的价格。price_down 同理,对应 Down。两者都在 0 到 1 之间,没有人挂出该方向的卖单时为 null。它们既不是中间价,也不是最新成交价。由于两者都是卖价,Up 与 Down 相加通常略高于 1。
通常的流程是先调用 polytest_list_markets 找到市场,再用 polytest_get_price_series 查看该市场的走势,然后用 polytest_get_snapshots 读取逐笔细节或某一时刻的订单簿。
覆盖范围与数据时效
PolyTest 提供 btc、eth 和 sol 的 5m、15m 和 1hr 市场;4hr 和 24hr 市场只有 btc。
PolyTest 分批加载新市场,因此最新的市场可能比实时晚几个小时或几天。延迟多少因币种和市场类型而异。
每个市场行都有一个 status 字段:
upcoming:时间窗口尚未开始。open:时间窗口仍在进行中。resolved:获胜方已确定。ended_no_result:时间窗口已结束,而 PolyTest 没有该窗口的结果。
当你列出最新的市场(不指定 end_time),而其中最新的一个开始时间远早于当前时间时,polytest_list_markets 会附上一条说明。对于仍在进行的市场,polytest_get_price_series 会停在当前时间,不会对未来时段取样。如果一个序列最后几个时间桶返回为空,它会说明数据在哪里截止。如果请求的范围在当前时间之后才开始(比如尚未开始的市场),会返回错误。
限制与消耗
每次工具调用发出的都是普通 API 请求,因此和 REST 调用计入同一套餐限制。
- 速率限制按密钥计算,所以请为 MCP 服务器单独创建一个密钥。
- 并发额度与你账户上运行的其他程序共用。没有空闲名额时,服务器会短暂重试。
polytest_get_limits会为每个账户返回trial_budget,付费账户也不例外。它是免费试用在 3 天内总共可用的请求数、记录数和字节数,只在试用期间生效。这些工具无法显示剩余额度:REST API 只在响应头中报告剩余量,而 MCP 客户端看不到响应头。- 返回结果的大小按 AI 的上下文窗口设计:每页较小,订单簿只保留选定的档数。需要批量拉取或回测时,请让 AI 改用 TypeScript SDK 或 REST API 编写代码。
试一试
连接服务器后,用自然语言提问即可。例如:
列出 PolyTest 上最近的五个 BTC 5m 市场,并说明最新一个市场中 Up 价格的变化。
找到 PolyTest 上最近一个已结算的 BTC 15m 市场,显示它收盘前三十秒的双边订单簿。
查看我的 PolyTest 套餐限制,然后告诉我 40 个采样点的价格序列要消耗多少次 API 请求。