Codex Reset

Codex Reset MCP 服务

通过模型上下文协议，获取由 codex-reset.com 提供的 OpenAI Codex 使用限额重置只读信息。

• Endpoint： https://codex-reset.com/mcp
• 传输方式： Streamable HTTP、JSON-RPC 2.0，协议 2025-06-18。仅支持 POST；GET 请求会返回 405。
• 身份验证： 无需身份验证、API 密钥、注册或会话。
• 费用： 免费，且附带额度（请参阅条款）。
• 文档： codex-reset.com/developers · dev.to 上的终端操作指南 · 服务卡片 · llms.txt

此代码仓库包含托管服务的客户端配置和目录元数据。无需安装或运行任何内容：服务运行于上述端点，其源代码未在此处发布。

工具

以下三个工具均为只读（readOnlyHint: true），读取的数据与网站公开 JSON API 相同，因此 Agent 和浏览器看到的信息始终一致。

工具	返回内容	参数
get_reset_forecast	预测未来 24 和 48 小时内 Codex 使用限额重置的概率、置信度、上一次确认的重置时间，以及当前有效的官方信号。这只是预测，并非保证。	locale
get_reset_timeline	已验证的重置记录及相关公告，按日期记录并按时间从新到旧排列，每条记录均附来源 URL。	group（reset | boost | unlock | credits）、from、to（YYYY-MM-DD）、limit（1–50，默认值为 10）、locale
get_codex_status	Codex 当前服务状态，用于区分服务中断与使用限额。	locale

locale 可设为 en、zh、ja 或 es，仅用于切换人类可读文本的语言。

示例提示词

• “Codex 的使用限额有可能在未来 24 小时内重置吗？”
• “上一次确认的 Codex 使用限额重置是什么时候？在哪里发布的公告？”
• “列出 2026 年 8 月以来的所有 Codex 重置，并附上来源链接。”
• “我的 Codex 报错了。这是服务中断，还是我已达到使用限额？”
• “我应该等重置还是继续工作？请查看预测和服务状态。”

设置

Claude Code

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" }
  }
}

此代码仓库也是一个 Claude Code 插件（.claude-plugin/plugin.json + .mcp.json）。

Codex CLI / IDE 扩展

~/.codex/config.toml：

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

此代码仓库也是一个 Codex 插件（.codex-plugin/plugin.json：包含 MCP 服务和一个 codex-reset 技能），已列入 awesome-codex-plugins 和 HOL 插件注册表。普通 Codex 设置只需添加上面的两行 config.toml 配置。

Cursor

.cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

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

VS Code（GitHub Copilot）

.vscode/mcp.json：

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

Gemini CLI

gemini extensions install https://github.com/suvadadepolo-blip/codex-reset-mcp

仅支持 stdio 的客户端

npx -y mcp-remote https://codex-reset.com/mcp

手动检查

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"}'

收录平台

• 官方 MCP 注册表：io.github.suvadadepolo-blip/codex-reset
• Smithery
• cursor.directory
• Glama

条款

满足一个条件即可免费且无需密钥地复用：注明出处。传递此数据的网站、应用、机器人消息、仪表板、MCP 工具或 API，必须在同一界面注明来源并提供链接：“数据：codex-reset.com”，链接至 https://codex-reset.com/。个人使用无需显式注明出处。完整说明见：[codex-reset.com/developers](https://codex-reset.com/developers) 和使用条款。

• 隐私：codex-reset.com/privacy。服务端不保留会话，也无需账号。
• 联系方式：[email protected]

这是独立的社区项目，与 OpenAI 无关联。“Codex”和“ChatGPT”是 OpenAI 的商标，仅用于描述被追踪的内容。

许可证

本仓库中的配置文件采用 MIT 许可证。端点提供的数据受上述条款约束。