Codex Reset MCP server

Read-only facts about OpenAI Codex usage-limit resets, served by codex-reset.com over the Model Context Protocol.

• Endpoint: https://codex-reset.com/mcp

• Transport: Streamable HTTP, JSON-RPC 2.0, protocol 2025-06-18. POST only; a GET answers 405.

• Auth: none. No API key, no sign-up, no session.

• Cost: free, with credit (see Terms).

• Docs: codex-reset.com/developers · terminal walkthrough on dev.to · server card · llms.txt

This repository holds the client configuration and directory metadata for the hosted server. There is nothing to install or run: the server lives at the endpoint above, and its source is not published here.

Tools

All three tools are read-only (readOnlyHint: true) and read the same data as the site's public JSON API, so an agent and a browser never disagree.

locale is en, zh, ja or es and changes only the human-readable copy.

Related MCP server: who-gho

Example prompts

• "Is Codex likely to reset its usage limits in the next 24 hours?"

• "When was the last verified Codex usage-limit reset, and where was it announced?"

• "List every Codex reset from August 2026 with its source link."

• "I'm getting errors in Codex. Is that an outage or did I hit my usage limit?"

• "Should I wait for a reset or keep working? Check the forecast and the service status."

Setup

Claude Code

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

Or in .mcp.json:

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

This repository is also a Claude Code plugin (.claude-plugin/plugin.json + .mcp.json).

Codex CLI / IDE extension

~/.codex/config.toml:

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

This repository is also a Codex plugin (.codex-plugin/plugin.json: the MCP server plus a codex-reset skill), listed in awesome-codex-plugins and the HOL plugin registry. The two config.toml lines above are all a plain Codex setup needs.

Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

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

Clients that only speak stdio

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

Check it by hand

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

Where it is listed

• Official MCP Registry: io.github.suvadadepolo-blip/codex-reset

• Smithery

• cursor.directory

• Glama

Terms

Reuse is free and keyless on one condition: credit. A site, app, bot message, dashboard, MCP tool or API that passes this data on names the source and links to it on the same surface: "Data: codex-reset.com", linked to https://codex-reset.com/. Personal use needs no visible credit. Full wording: codex-reset.com/developers and the terms of use.

• Privacy: codex-reset.com/privacy. The server keeps no session and needs no account.

• Contact: hello@codex-reset.com

Independent community project, not affiliated with OpenAI. "Codex" and "ChatGPT" are trademarks of OpenAI and are used only to describe what is being tracked.

License

The configuration files in this repository are MIT-licensed. The data served by the endpoint is covered by the terms above.