Pitwall — F1 Data for Claude

Pitwall

Turn Claude into your F1 race engineer.

Real telemetry. Real strategy data. 75 years of history.

---

Quick Start

Claude Code — one command, all 79 tools:

claude mcp add pitwall -- uvx --from "f1pitwall[full]" f1pitwall

Then ask Claude: *"Who won the 2025 Australian GP?"*

Needs uv (curl -LsSf https://astral.sh/uv/install.sh | sh). No pip, no virtualenv, no "which python3" — and you always get the latest release.

First launch downloads the FastF1 stack (~540 MB) and takes about 25 seconds. Every launch after that is under a second. If the very first start times out, just restart Claude Code — the download is already cached.

Want the plugin instead, so you get the f1 skill along with the server? See Install as a Claude Code plugin.

Lighter install (30 tools, no plots)

Skips pandas/numpy/matplotlib/FastF1. Still includes all 16 live-timing tools.

claude mcp add pitwall -- uvx --from f1pitwall f1pitwall

Install with pip instead

pip install "f1pitwall[full]"        # or just f1pitwall for lite

claude mcp add pitwall -- f1pitwall

Install from source instead

git clone https://github.com/darshjoshi/pitwall.git && cd pitwall

pip install -r requirements.txt # lite (incl. live timing) pip install -r requirements-full.txt # full claude mcp add pitwall -- python3 $(pwd)/pitwall.py

Install as a Claude Code plugin

The plugin ships the MCP server and the f1 skill together — the skill teaches Claude which of the 79 tools to reach for and how to explain F1 to someone who's never watched a race.

/plugin marketplace add darshjoshi/pitwall

/plugin install pitwall@pitwall

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{

"mcpServers": { "pitwall": { "command": "uvx", "args": ["--from", "f1pitwall[full]", "f1pitwall"] } } }

---

Why Pitwall?

Claude knows F1 from training data — but it can't look up last week's race. It can't show you Verstappen's throttle trace through Turn 1. It doesn't know who pitted first or when the safety car came out.

Pitwall connects Claude to real F1 data:

• Real data, not hallucinations — actual timing feeds from formula1.com
• Lap-level telemetry — speed, RPM, throttle, brake, gear, DRS at 4Hz per car
• Visual plots — speed trace comparisons, gear shift maps returned as images
• 75 years of history — every race result and championship since 1950
• Fresh after every session — full telemetry and timing published ~30 min after each session ends, back to 2018
• Zero API keys — all core data is free, no account needed

---

What You Can Ask

"Who won the 2025 Australian GP?"           → Race results and classification

"Verstappen's speed on lap 25 at Monaco" → Lap telemetry at 4Hz "Plot Hamilton vs Norris speed trace" → Visual speed comparison chart "Compare Ferrari's tyre strategy" → Stint-by-stint breakdown "Who won the 1994 championship?" → 75 years of history "When was the safety car at Silverstone?" → Race control messages and flags

See all example questions

---

Features

79 tools across two modes. Pitwall auto-detects what's installed — no config changes needed.

Lite Mode (30 tools)

pip install f1pitwall — light deps only (mcp, requests, plus websockets/aiohttp for live timing); no pandas/numpy/FastF1.

Race results, lap times, telemetry, tyre strategy, pit stops, weather, race control, speed traps, driver comparison, and historical data back to 1950. Plus 16 live-timing tools (running order, gaps, lap/sector times, tyres, weather, race control, speed traps, mini-sectors, …) that read F1's real-time SignalR feed during a session — no auth needed. (Live car telemetry + GPS are auth-gated and live in Full mode.) Uses F1's free static archive and the Jolpica API.

Full Mode (79 tools)

pip install -r requirements-full.txt — adds FastF1.

Everything in Lite, plus:

Full tool list (79 tools)

Lite Tools (always available)

Live Timing (lite — no auth, reads F1's real-time SignalR feed during a session)

FastF1 Tools (requires FastF1)

---

Setup

macOS

Claude Code:

claude mcp add pitwall -- python3 /absolute/path/to/pitwall.py

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{

"mcpServers": { "pitwall": { "command": "python3", "args": ["/absolute/path/to/pitwall.py"] } } }

</details>

Windows

1. Find your Python path:

where python

This will return something like C:\Users\YourName\AppData\Local\Programs\Python\Python313\python.exe or C:\Python313\python.exe.

2. Note where you cloned Pitwall: For example: C:\Users\YourName\Projects\pitwall\pitwall.py

Claude Code (PowerShell):

claude mcp add pitwall -- python C:\Users\YourName\Projects\pitwall\pitwall.py

**Claude Desktop