更新日志
位于 /mcp 的 MCP 服务器的每一项变更 - 工具、输入、结果、密钥与限制 - 最新在前。哪些算作破坏性变更,详见其政策。
来自 /mcp 的 401 现在携带 WWW-Authenticate: ApiKey realm="mcp",而不是 Bearer realm="mcp", error="invalid_token",后者曾让部分客户端去寻找 OAuth 服务器。密钥仍可通过 Authorization: Bearer 或 X-API-Key 传递。
成功的工具调用会在保持不变的 JSON 文本旁返回 structuredContent,并且对于响应已在 OpenAPI 契约中记录的每个工具,tools/list 都会发布一个 outputSchema。错误仍为纯 isError 文本。
tools/list 过去每页返回 15 个工具并附带 nextCursor,因此忽略游标的客户端永远看不到 get_coin_markets、get_coin_technicals、get_liquidations_summary 或 calculate_dca。现在全部 19 个工具都在一页中返回。
自上线以来,get_exchange 和 get_exchange_trust_score 对每个交易所都返回内部错误。现在两者都能正常响应;输入和结果字段均不变。
自 9 月 6 日起,已关闭的工具会返回 server_error (HTTP 500)。现在它再次返回 endpoint_unavailable (HTTP 503): This endpoint is temporarily unavailable.。
days 曾标示默认值和最小值为 0,但 0 一直都会被拒绝。现在其取值范围为 1-365,且没有默认值;如需获取当前读数,请省略该参数。get_global_history 的描述现在说明了数据点的结构({time, marketcap} 或 {time, volume})。
新增无需身份验证的 /.well-known/mcp/server-card.json,包含 serverInfo 和完整的工具定义,缓存一小时,供无法扫描需要密钥的服务器的注册中心使用。它和 /.well-known/mcp.json 现在都可以跨源读取。
/mcp 现在也接受以 X-API-Key: YOUR_API_KEY 发送的 MCP 密钥,适用于将 Authorization 专用于自身登录的客户端和网关。发送该请求头时,只会校验其中的密钥,并且可以容忍粘贴进来的 Bearer 前缀。
身份验证失败过去按每个 IP 每分钟最多 30 次限制,超出后该 IP 背后的所有密钥都会被拒绝。现在,单个密钥在单个 IP 上每分钟最多可失败 30 次,单个 IP 最多 300 次,且大约最近 15 分钟内成功通过验证的密钥不会被 IP 上限阻止。
get_fear_greed(主读数和每个时间区间)和 get_global_market(fear_greed)现在会在原始 score 旁包含 index - 即 Bitculator 上显示的 0-100 指数 - 工具描述也会告诉模型引用 index。
对于最大供应量没有上限的币种,get_coin 过去会将完全稀释估值返回为 0。现在改为回退到总供应量,两者均未知时为 null。
get_top_movers 现在按涨跌幅本身排名(此前实际上按市值排名),其跌幅榜会排除持平于 0.00 的币种。带 symbols 的 get_prices 每个代码只返回一个币种,即排名最高的活跃币种;当没有市值时,get_global_market 会将 BTC 和 ETH 的市场份额报告为 null,而不是 0。
initialize 说明现在指出市值和交易量为 JSON 数字(此前写的是十进制字符串),list_exchanges 的 sort 描述给出了真实的默认值 -volume,get_exchange_trust_score 也注明未排名的交易所其评分和明细为 null。
服务器已列入 /apis.json 和 /.well-known/api-catalog,/.well-known/mcp.json 新增了 status 和 changelog 链接,/status.json 也会报告一个 mcp 组件。
破坏性变更:/mcp 只接受在 MCP 控制台中创建的密钥;Data API 密钥和组件密钥会得到 401。MCP 拥有自己的 Free(每月 2,500 次工具调用)、Starter(50,000 次)和 Pro(250,000 次)套餐,分别提供 2、5 和 10 个密钥名额,并拥有自己的计费和按工具划分的套餐门槛,每个账户都从 Free 起步。配额和套餐错误现在会写明 MCP 套餐。
发往 /mcp 的每个 JSON-RPC 请求 - initialize、tools/list、ping 和工具调用 - 现在都计入套餐每分钟 30、60 或 120 次的突发限制,超出时返回 HTTP 429。只有工具调用计入月度配额。
工具的服务器错误过去会包含内部错误消息。现在显示为 server_error (HTTP 500): Internal server error.。
从上线到此次修复,生产环境中的每次工具调用都返回 server_error,因为服务器把自己的内部数据请求当作来自不受信任主机的请求而拒绝了。
/mcp 通过 Streamable HTTP(仅限 POST)上线,为 Claude、Cursor、VS Code 及任何 MCP 客户端提供 19 个只读工具,从 search_coins 和 get_coin 到 calculate_dca,返回与 REST API 相同的数据。它使用 Data API 的密钥、套餐和配额,每次工具调用计为一次请求,并由 /.well-known/mcp.json 对其进行描述。
移除或重命名某个工具或输入,会至少提前六个月在此处公布 - 参见弃用政策。位于 /.well-known/mcp.json 的服务器卡片会链接到本更新日志。