Developers

Codex reset API and MCP server

tokenusage.dev publishes the announcements its Codex reset tracker records as read-only JSON and through an MCP server. There is no key and no sign-up.

Reset announcements

GET https://tokenusage.dev/api/resets

Posts by @thsottiaux on X that the monitor classified as announcing a Codex usage-limit reset, newest first, at most 50. An announcement can be of a reset to come, one already applied, or a banked reset: open its link for the exact wording.

resets[].postId, resets[].url

The X post's id, as a string, and its address on X.

resets[].postedAt

When the post was published, ISO 8601 in UTC.

resets[].detectedAt

When this site recorded it. Posts recorded when the monitor started share one time.

lastPolledAt

The monitor's latest successful fetch of @thsottiaux's X timeline, checks that found no new posts included, ISO 8601 in UTC; null before the first, or when an older record lacks it. It is not a sign that classification or alert delivery is working.

generatedAt

When the response was made.

source

The fixed credit URL, https://tokenusage.dev/resets. It is returned by both the JSON endpoint and the MCP tool.

MCP server

https://tokenusage.dev/mcp

Streamable HTTP, read-only, with no sign-in and no session. It speaks MCP 2026-07-28, and 2025-11-25, 2025-06-18 and 2025-03-26 through initialize.

get_codex_reset_announcements

The announcements /api/resets returns, newest first, up to its limit (1 to 50, default 10), with lastPolledAt.

Claude Code

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

Codex

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

Cursor

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

In .cursor/mcp.json. Identity and connection metadata are in the server card, advertised by the AI catalog. The tool list is available through tools/list.

Using it

  • Responses are cached for 15 seconds (/api/resets), and the MCP tool keeps each read as long, so please poll no faster than that.
  • Depend only on the fields named on this page. Other fields, and other paths under /api, are this site's own interface and can change without notice.
  • Please send a User-Agent that names your project and a way to reach you when your client supports it.
  • The public JSON endpoint supports browser GET and HEAD without credentials. Make MCP connections from a server: the MCP endpoint accepts no foreign Origin. Other API paths do not gain CORS access.
  • Credit is the condition of reuse: when you show reset data to other people, show Data: tokenusage.dev on the same screen or in the same message. Personal use needs no visible credit.
  • An API or MCP relay must retain source: "https://tokenusage.dev/resets"and pass on this credit condition. See Terms.
  • It is unofficial and not affiliated with OpenAI. Only @thsottiaux is watched, so an announcement made elsewhere is missing.

Example

curl -sS https://tokenusage.dev/api/resets \
  -A 'myproject/1.0 (+https://example.com)'

A summary of the site for language models is at /llms.txt. Questions and corrections: Contact.