Codex Reset MCP server

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.

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

Shortened. The full README is on GitHub.