Race Calendar developer resources

Race Calendar (racecalendar) Formula 1 data for agents and applications

Race Calendar at racecalendar.app publishes anonymous, read-only REST and MCP interfaces for schedules, standings, results, circuits, history, comparisons, updates, and spoiler-safe previews.

Open the OpenAPI contract Inspect Race Calendar MCP discovery

Race Calendar REST API

Every public REST operation is a synchronous GET under /api/v2. GET requests are idempotent, public reads require no credentials, and the OpenAPI document defines unique operation IDs, parameters, response schemas, and typed JSON errors. The human and agent portal aliases are https://racecalendar.app/api and https://racecalendar.app/developers.

Base URL: https://api.racecalendar.app
Canonical GET proxy: https://racecalendar.app/api/v2
Portal: https://racecalendar.app/api
Authentication: None for documented public reads
Version policy: Major version in the /api/v2 path plus API-Version: 2

Race Calendar OpenAPI

Agents and applications should read the Race Calendar OpenAPI document before calling structured endpoints.

OpenAPI: https://api.racecalendar.app/api/v2/openapi.json

Race Calendar MCP

The canonical MCP endpoint uses stateless Streamable HTTP and exposes the same read-only facts through tools, resources, prompts, completion, and an optional race-weekend dashboard for hosts that support MCP Apps. Discovery lives at /.well-known/mcp.json; the protocol itself stays at https://racecalendar.app/mcp.

Discovery: https://racecalendar.app/.well-known/mcp.json
Endpoint: https://racecalendar.app/mcp
Server card: https://racecalendar.app/.well-known/mcp/server-card.json
Authentication: Anonymous and read-only
App resource: ui://racecalendar/race-weekend-dashboard.html

Race Calendar auth.md

Public Race Calendar agent surfaces are anonymous. Read auth.md before touching any account-adjacent route; purchase, referral, account, and admin operations are not public agent tools.

Access policy: https://racecalendar.app/auth.md

Race Calendar reliability and errors

Public reads are cache-friendly and complete synchronously; this API has no long-running job workflow. Invalid or unavailable REST resources return typed JSON errors. Bounded MCP data cache misses can return HTTP 429 with Retry-After; clients should preserve that delay instead of retrying immediately.

Race Calendar machine-readable discovery

Predictable Race Calendar URLs for API, OpenAPI, auth.md, MCP, and agent instructions.

Official CLI

Script Race Calendar from a clone of this repository with the workspace race-calendar binary. Public npm publish is not required to use the workspace CLI for racecalendar.app.

Help: npx --workspace=@f1-calendar/cli race-calendar --help
From a clone: Install workspace dependencies, then run race-calendar against the public API.

Need the human-facing Race Calendar product? Browse the Formula 1 hub.