Codex Reset Tracker MCP server
Commit Oct 21, 2026Allows an AI client to retrieve OpenAI Codex usage-limit reset announcements and calendar data from tokenusage.dev.
Also known as stdcmms-lang/tokenusage-codex-mcp, tokenusage-codex-mcp
- Stars
- 0
- Tools
- 2
- Downloads, 30 days
- —
- Latest version
- 1.1.0
- Last commit
- Oct 21, 2026
- License
- MIT
What is Codex Reset Tracker MCP?
Codex Reset Tracker allows an AI client to retrieve OpenAI Codex usage-limit reset announcements and calendar data from tokenusage.dev. It exposes 2 tools, such as get_codex_reset_announcements, get_codex_reset_calendar.
Summary generated from the project's README
About Codex Reset Tracker MCP server
Codex Reset Tracker provides a read-only connection to usage-limit reset announcements for OpenAI Codex. It functions as a hosted MCP server via a streamable HTTP endpoint, meaning users do not need to run local code or manage accounts. The server requires no API keys or sign-ins to access the data provided by tokenusage.dev.
Developers can use this server with clients like Claude Code, Codex, Gemini CLI, or Cursor by adding the remote URL. The server offers two specific tools: get_codex_reset_announcements, which retrieves individual posts from @thsottiaux on X including reset types like automatic or banked, and get_codex_reset_calendar, which organizes these announcements by UTC calendar date. This setup allows an AI agent to monitor when limits might be replenished without any local data being written or modified.
What you can do with it
- 1Check recent reset announcementsAsk your AI agent to find the most recent announcements regarding Codex usage-limit resets.
- 2Identify specific reset typesDetermine if a reset is categorized as automatic, banked, or both.
Written from the project's README. Every use case is checked against a quote from it.
How to install Codex Reset Tracker MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Codex Reset Tracker MCP in Claude Code
$ claude mcp add --transport http tokenusage-codex-mcp https://tokenusage.dev/mcpInstall Codex Reset Tracker MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"tokenusage-codex-mcp": {
"url": "https://tokenusage.dev/mcp"
}
}
}Install Codex Reset Tracker MCP in VS Code
.vscode/mcp.json
{
"servers": {
"tokenusage-codex-mcp": {
"type": "http",
"url": "https://tokenusage.dev/mcp"
}
}
}Install Codex Reset Tracker MCP in VS Code CLI
$ code --add-mcp '{"name":"tokenusage-codex-mcp","type":"http","url":"https://tokenusage.dev/mcp"}'Install Codex Reset Tracker MCP in Codex
$ codex mcp add tokenusage-codex-mcp --url https://tokenusage.dev/mcpInstall Codex Reset Tracker MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.tokenusage-codex-mcp] url = "https://tokenusage.dev/mcp"
Install Codex Reset Tracker MCP in Gemini CLI
$ gemini mcp add -s user --transport http tokenusage-codex-mcp https://tokenusage.dev/mcpInstall Codex Reset Tracker MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"tokenusage-codex-mcp": {
"url": "https://tokenusage.dev/mcp",
"type": "http"
}
}
}Codex Reset Tracker MCP tools 2
Detected from the READMEget_codex_reset_announcementsget_codex_reset_calendar
| get_codex_reset_announcements | — | |
| get_codex_reset_calendar | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablestdcmms-lang/tokenusage-codex-mcp is public and reachablegithub.com/stdcmms-lang/tokenusage-codex-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-21github.com/stdcmms-lang/tokenusage-codex-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model2 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 224 msPass
README
View on GitHubCodex 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
| Tool | What it returns |
|---|---|
get_codex_reset_announcements |
Codex 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_calendar |
The 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
- Server card: https://tokenusage.dev/mcp/server-card
- AI catalog: https://tokenusage.dev/.well-known/ai-catalog.json
- MCP Registry name:
dev.tokenusage/codex(manifest: server.json)
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.
Codex Reset Tracker MCP questions
How do I add Codex Reset Tracker MCP to Claude Code?
Run claude mcp add --transport http tokenusage-codex-mcp https://tokenusage.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Codex Reset Tracker MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Codex Reset Tracker MCP provide?
It exposes 2 tools, including get_codex_reset_announcements, get_codex_reset_calendar.
Does this server require an API key?
No, the server is read-only and requires no API key, account, or sign-in.
What information is provided by the reset announcements tool?
It returns links to posts, posting times, recording times, reset types (automatic, banked, or both), and the last check time.
Is a reset announcement proof that my personal limit was reset?
No, a post is not proof of your personal reset; you should check your Codex account for your specific reset times.
