# Pitwall MCP server

> Provides Claude with real-time F1 telemetry, race strategy data, and 75 years of historical racing statistics.

- Repository: https://github.com/darshjoshi/pitwall
- Page: https://hostedmcp.org/servers/darshjoshi/pitwall
- Transport: stdio
- Stars: 9
- License: MIT
- Latest version: 1.1.1

## Install

### Claude Code

```sh
claude mcp add pitwall -- uvx f1pitwall
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "pitwall": {
      "command": "uvx",
      "args": [
        "f1pitwall"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "pitwall": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "f1pitwall"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"pitwall","type":"stdio","command":"uvx","args":["f1pitwall"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "pitwall": {
      "command": "uvx",
      "args": [
        "f1pitwall"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add pitwall -- uvx f1pitwall
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.pitwall]
command = "uvx"
args = ["f1pitwall"]
```

### Gemini CLI

```sh
gemini mcp add -s user pitwall uvx -- f1pitwall
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "pitwall": {
      "command": "uvx",
      "args": [
        "f1pitwall"
      ]
    }
  }
}
```

## Tools (14)

- `list_seasons`
- `list_races`
- `get_race_info`
- `get_standings`
- `get_lap_times`
- `get_telemetry`
- `get_tyre_strategy`
- `get_pit_stops`
- `get_race_control`
- `get_weather`
- `get_speed_traps`
- `get_driver_comparison`
- `get_historical_results`
- `get_championship_standings`

## FAQ

### Does Pitwall require an API key?

No, all core data is free and no account is needed for the standard tools.

### What kind of telemetry data can I get?

You can access lap-level telemetry including speed, RPM, throttle, brake, gear, and DRS at 4Hz per car.

### How much historical data is available?

The server provides access to every race result and championship since 1950.

### Is there a difference between Lite and Full modes?

Lite mode includes 30 tools and live timing without heavy dependencies, while Full mode includes 79 tools with visual plots and deep telemetry analysis using FastF1.