开发者

给工具用的 Codex 重置 API 与 MCP

本站背后的 Codex 重置 API 和 MCP 服务器属于 codex-reset.com：免费、无需密钥，任何注明来源的智能体或脚本都可以使用。

MCP: /mcp
REST: /api
鉴权: 无

MCP

Streamable HTTP · 无需密钥

codex-reset.com 运营一个只读的 MCP 服务器。它的工具和 JSON 接口用的是同一份数据：实时预测、带日期的重置记录和 Codex 服务状态。在展示回答的地方请写明“数据：codex-reset.com”。

Streamable HTTP

https://codex-reset.com/mcp

智能体可以调用的工具

工具	返回内容
`get_reset_forecast`	未来 24 和 48 小时内重置的概率、上次确认的重置，以及当前生效的承诺。
`get_reset_timeline`	已确认的重置和相关公告，最新的在前，每条附原始推文。
`get_codex_status`	Codex 当前的服务状态，用来区分故障和额度用完。

接入你的智能体

配置一行，然后问它 Codex 重置了没有

Claude Code

HTTP 传输，可装在单个项目或你的用户范围。

CLI

claude mcp add --transport http codex-reset https://codex-reset.com/mcp

.mcp.json

{
    "mcpServers": {
        "codex-reset": {
            "type": "http",
            "url": "https://codex-reset.com/mcp"
        }
    }
}

Codex

Codex CLI 和 IDE 插件都读取 ~/.codex/config.toml。

~/.codex/config.toml

[mcp_servers.codex-reset]
url = "https://codex-reset.com/mcp"

Cursor

单个项目写在 .cursor/mcp.json，所有项目写在 ~/.cursor/mcp.json。

.cursor/mcp.json

{
    "mcpServers": {
        "codex-reset": {
            "url": "https://codex-reset.com/mcp"
        }
    }
}

~/.cursor/mcp.json

{
    "mcpServers": {
        "codex-reset": {
            "url": "https://codex-reset.com/mcp"
        }
    }
}

其他客户端

支持 Streamable HTTP 的客户端直接填这个网址。手动检查服务器：

curl

curl -sS https://codex-reset.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

REST

JSON · 允许跨域 · 无需密钥

和 MCP 工具返回的是同一份数据。请在 User-Agent 里写明你的项目和联系方式，轮询不要超过每分钟一次，并在展示数据的地方写明“数据：codex-reset.com”。

API 目录 llms.txt 完整文档

方法	路径	返回内容
`GET`	/api/forecast	24 和 48 小时的重置概率、上次重置时间和当前生效的承诺。
`GET`	/api/timeline	每一次重置、储备重置和加量的记录，含 UTC 时间和原始推文。
`GET`	/api/feed	Tibo 最近与重置相关的推文及其新旧程度。
`GET`	/api/status-history	Codex 服务状态和 OpenAI 近期的故障记录。
`GET`	/api/juice	观测到的 Codex 模型和推理强度读数。

curl

curl -sS -H 'User-Agent: yourproject/1.0 (+https://yourproject.example)' https://codex-reset.com/api/forecast

JavaScript

const res = await fetch('https://codex-reset.com/api/forecast');
const f = await res.json();
console.log(f.probabilities.rounded_24h, f.last_reset_at); // Data: codex-reset.com

浏览器提醒

这台设备上，关掉本站也能收到

只需允许一次通知。重置被确认时，本站通过浏览器的推送服务发出一条 Web Push 消息，本站的标签页全部关掉也能收到。

提醒

点“浏览器提醒”，浏览器询问时选择允许通知。
之后可以关掉标签页，不需要一直开着。
Tibo 确认重置时会弹出一条通知。再按一次按钮即可关闭。

邮件提醒在提醒页设置，MCP 服务器是给智能体用的。iPhone 或 iPad 上请先把本站添加到主屏幕。