Free Codex reset API & MCP | will codex resets

JSON API

curl 'https://willcodexresets.com/api/resets?limit=10&type=global'

GET /api/resets returns a resets array and full-archive stats. Results are newest first. Optional limit is an integer from 1 to 1000; type accepts global or banked. Omit both for the complete archive. Filters do not change the archive statistics.

{
  "resets": [{
    "id": "stable-event-id",
    "occurredAtUtc": "2026-09-12T08:09:00.000Z",
    "type": "global",
    "announcementUrl": "https://x.com/thsottiaux/status/...",
    "text": "Full announcement text, with original newlines."
  }],
  "stats": {
    "total": 53,
    "avgIntervalDays": 6.9263677,
    "longestWaitDays": 67.7424074,
    "latest": "2026-09-12T08:09:00.000Z"
  }
}

This is a shortened example of the launch dataset, not a second source of live statistics. The endpoint computes current values from the database.

Field	Meaning
`id`	Stable archive identifier; use it to deduplicate.
`occurredAtUtc`	Recorded event time, ISO 8601 in UTC. It may differ from publication time.
`type`	Global announcement or banked reset credit announcement.
`announcementUrl`	Original public X source; check its scope before acting.
`text`	Full source text with original line breaks.
`stats`	Full archive count, mean interval, longest interval, and latest recorded UTC time.

Remote MCP

The endpoint implements Streamable HTTP using the official MCP TypeScript SDK. Add this URL to a client that supports remote MCP servers:

https://willcodexresets.com/mcp

For clients with a mcpServers configuration:

{
  "mcpServers": {
    "will codex resets": {
      "url": "https://willcodexresets.com/mcp"
    }
  }
}

Client configuration formats vary. In a settings interface, choose a remote HTTP server and paste the endpoint. The server exposes three read-only tools:

get_latest_reset: the most recent recorded announcement.
list_resets: an optional limit and type filter.
get_reset_stats: full-archive statistics.

Tools cannot view your personal usage, sign in to OpenAI, spend reset credits, or change account limits. HTTP POST handles MCP messages; OPTIONS supports cross-origin clients. Standalone GET event streams are not required by this stateless server.

Fair use and freshness

The JSON API and MCP share a budget of 60 requests per IP per minute. An exhausted budget returns HTTP 429; respect Retry-After. Cache results locally and avoid polling more than once a minute. JSON responses permit all CORS origins and have a 60-second shared-cache lifetime. New reset ingestion triggers page and data invalidation; deployment-specific edge purge must be configured when an external CDN is used.

Public announcement intervals are not personal account reset timers. Imported event dates and global/banked classifications remain marked for editorial review. Source authorship and full text are verified separately. Read the source announcement when quoting a record.

RSS and AI discovery

Subscribe to RSS for published events. llms.txt lists the available data and guide URLs. Attribution with a link to the original archive and the X announcement helps readers inspect the evidence.