English Français العربية

Codex Reset Tracker

Official registry Other

Codex reset tracker: usage-limit reset announcements from @thsottiaux on X. Read-only, no key.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http codex-reset-tracker 'https://tokenusage.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "codex-reset-tracker": {
            "type": "http",
            "url": "https://tokenusage.dev/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Codex Reset Tracker MCP server
  2. Tools
  3. Install
  4. Discovery
  5. Credit
  6. License

Codex Reset Tracker MCP server

A hosted, read-only MCP server for OpenAI Codex usage-limit resets, from tokenusage.dev. Ask your agent whether Codex has announced a reset, and it reads the record behind the Codex reset tracker.

  • Endpoint: https://tokenusage.dev/mcp (Streamable HTTP)
  • No API key, no account, no sign-in
  • Read-only: nothing runs on your machine and nothing is written

This repository holds client configuration only. The server is hosted at tokenusage.dev; its fields, caching and limits are documented at tokenusage.dev/developers.

Nerf Watch has a separate read-only MCP server for public benchmark scores and history. See Nerf Watch installation and tools. A lower score is a lower score on this suite, not proof that a provider changed a model. Data: tokenusage.dev linked to https://tokenusage.dev/nerfwatch.

Tools

ToolWhat it returns
get_codex_reset_announcementsCodex usage-limit reset announcements by @thsottiaux on X, newest first (limit 1 to 50, default 10): each post's link, when it was posted, when tokenusage.dev recorded it and its resetType (automatic, banked or both; null for records older than reset types), plus when the monitor last checked X.
get_codex_reset_calendarThe same announcements grouped by UTC calendar date, newest first, at most 50 in total; an optional month (YYYY-MM) selects one UTC month. A date without an entry does not mean no reset was announced.

A banked reset grant saves a reset for eligible users to apply later and does not itself refill limits. A post is not proof that your own limit was reset: open its link for the exact wording, and check your Codex account for your personal reset times. Only @thsottiaux is watched.

Install

Claude Code

claude mcp add --transport http tokenusage https://tokenusage.dev/mcp

or as a plugin:

claude plugin marketplace add stdcmms-lang/tokenusage-codex-mcp
claude plugin install tokenusage-codex@tokenusage

Codex

codex mcp add tokenusage --url https://tokenusage.dev/mcp

or as a plugin:

codex plugin marketplace add stdcmms-lang/tokenusage-codex-mcp
codex plugin add tokenusage-codex@tokenusage

Gemini CLI

gemini extensions install https://github.com/stdcmms-lang/tokenusage-codex-mcp

Cursor (.cursor/mcp.json) and other clients that take an mcpServers file:

{ "mcpServers": { "tokenusage": { "url": "https://tokenusage.dev/mcp" } } }

A client that supports only stdio servers can bridge with npx -y mcp-remote https://tokenusage.dev/mcp.

Discovery

Credit

The data is free to reuse on one condition: where you show it to other people, in a site, app, bot message or dashboard, show Data: tokenusage.dev linked to https://tokenusage.dev/resets on the same screen or in the same message. Personal use needs no visible credit. Every response carries the link in its source field. See the terms.

Unofficial; not affiliated with OpenAI. Privacy: https://tokenusage.dev/privacy. Questions and corrections: https://tokenusage.dev/contact.

License

The configuration in this repository is MIT licensed. The hosted data is covered by the credit condition above.

Frequently asked questions

What is Codex Reset Tracker?

Codex reset tracker: usage-limit reset announcements from @thsottiaux on X. Read-only, no key.

How do I install Codex Reset Tracker?

It runs as a remote server. In Claude Code: claude mcp add --transport http codex-reset-tracker 'https://tokenusage.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Codex Reset Tracker need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Codex Reset Tracker open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Codex Reset Tracker?

It is published by stdcmms-lang. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.