f1-mcp

An MCP server exposing Formula 1 historical data (results, qualifying, pit stops, and championship standings) as tools an LLM can call directly — built on the Jolpica-F1 API.

Tools (more to be added)

Related MCP server: OpenF1 MCP Server

Setup

python -m venv venv && source venv/bin/activate
pip install -r requirements.txt

Running it

Standalone, with MCP Inspector (for testing tools/prompts manually):

npx @modelcontextprotocol/inspector python src/server.py

With Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "f1-mcp": {
      "command": "python",
      "args": ["/absolute/path/to/f1-mcp/src/server.py"]
    }
  }
}

Design notes

• client.py is the only file that touches raw Jolpica JSON. Every method returns a typed schemas.py model — tool functions never parse MRData.* nesting directly.

• Name-based race lookup (get_race_results_by_name) resolves a loose name ("Monaco", "Monaco GP") against the season's race calendar using substring matching first, with a fuzzy fallback (difflib) for typos — since the Ergast/ Jolpica API only supports lookup by round number.

• Season schedules are cached per-session to avoid refetching the calendar on every name-based lookup.

Data source

Jolpica-F1 — free, no API key required. Historical race data from 1950 onward; pit stop data from 2011 onward.