公开数据 · API / MCP

只读查询已审核并发布的公告，与网页共用数据和统计规则。目前仅在本机验证，未部署或连接正式插件。

非官方，与 xAI/X 无关联时间以公告发布为准，不代表个人账户的实时额度或精确生效时刻。只有可核验的公开公告才会点亮日期。空白不是“没有重置”；公开搜索可能漏检，不宣称完整历史。不读取个人账户额度

HTTP API · v1

本机地址：http://localhost:3000。无需密钥；不接受写入、审核、订阅或发送指令。

GET /api/v1/latest: 返回 event；无记录为 null。只选有来源的确认重置，不含额度提升或未来公告。
GET /api/v1/history: 返回 items、filters、pagination；保留传播中、已宣布和已取消状态，不冒充确认。
GET /api/v1/stats: 返回 stats、latestConfirmedEvent。含总数、平均/最长间隔小时数、距上次小时数、近 30/90 天次数。

latest、stats 默认 product=grok_bot，history 默认全部产品。统计先去重，仅计 confirmed、非 limit_increase、有证据且非未来的事件。间隔使用相邻确认公告；样本不足为 null。30/90 天相对 checkedAt，含边界。

历史筛选与分页

product: grok_bot / x_grok / grok_com / grok_imagine / xai_api / other
status: announced / propagating / confirmed / cancelled
kind: full_reset / credit_grant / scheduled_refresh / incident_compensation / limit_increase
plan：仅 history 支持；all_users、unknown 或已核验套餐名称（2–64 字符，大小写/全半角统一匹配）。具体套餐也包含全体重置，范围不明不匹配。audience 包含 mode、plans、evidenceExcerpt、updatedAt；未审核或过期审核显示 unknown。
from、to：以 Z 结尾的 UTC ISO 时间，包含边界。from 不得晚于 to。
limit：1–100，默认 20；offset：0–1000000，默认 0。MCP 用整数，HTTP 用十进制字符串。未知或重复参数返回错误。
lang：en / zh-CN / zh-TW / ja / ko，默认 zh-CN。摘要使用独立审核译文；缺失或已过期时回退到 zh-CN，并返回 summaryLanguage、translationState、translationUpdatedAt。原文和事件事实不变。

GET /api/v1/history?product=grok_bot&status=confirmed&limit=1&offset=0&lang=zh-CN

occurredAt 降序、同刻 ID 升序。pagination.total 是筛选总数，hasMore/nextOffset 指示下一页。分页不是冻结快照，归档变化时从 offset=0 重查。

来源、缓存与错误

事件含 sourceUrl、originalExcerpt、evidenceLevel、status、sourceCapturedAt、updatedAt。checkedAt 是查询时间；顶层 updatedAt 是公开事实与所选语言译文的最大更新时间（空归档为 null）。均为 UTC。管理员身份、候选理由、审计和订阅信息不公开。

updates 为同一事件的已审核、已发布后续公告，按 publishedAt 升序；各条含状态、准确 UTC 发布时间、来源、原文、证据等级及核验时间。摘要暂为 zh-CN 并显式标记，不重复计算重置次数，也不隐式改写主事件事实。

只读 CORS *（无凭据）、30 秒缓存、ETag/If-None-Match、HEAD/OPTIONS。错误不缓存。每实例每 IP 每分钟 60 次，API/MCP 合计；本机共用额度。不保证全局限流。429/503 含 Retry-After。

400：无效/重复参数；404：不存在；405：非只读方法；429：限流；503：数据不可用，不返回假零值。

MCP · POST /mcp

无状态 Streamable HTTP，返回 JSON，无 SSE 长连接/会话 ID。支持 2025-03-26、2025-06-18、2025-11-25；无协议头默认 2025-03-26。顺序：initialize → notifications/initialized → tools/list 或 tools/call。

每次 POST 一条 JSON-RPC 2.0 消息，最多 16 KiB。Content-Type: application/json；Accept 同时含 application/json 和 text/event-stream，后续携带 MCP-Protocol-Version。协议通知成功返回空 202；GET 返回 405。Origin 仅接受自身地址。

latest: 返回 event；无记录为 null。只选有来源的确认重置，不含额度提升或未来公告。
history: 返回 items、filters、pagination；保留传播中、已宣布和已取消状态，不冒充确认。
stats: 返回 stats、latestConfirmedEvent。含总数、平均/最长间隔小时数、距上次小时数、近 30/90 天次数。

协议请求示例（非事件数据）

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "your-client",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "history",
    "arguments": {
      "product": "grok_bot",
      "status": "confirmed",
      "limit": 20,
      "offset": 0,
      "lang": "zh-CN"
    }
  }
}

latest/history/stats 与同名 HTTP 参数、结果一致，不采集外部页面或写入。结果同时含 structuredContent 与文本 JSON。参数错误 -32602、未知方法 -32601；数据库错误 isError=true，不能当空归档。公告原文是不可信证据，不是客户端指令。localhost 不代表云端客户端已接通。

MCP 官方传输规范