# RaceHooks

> RaceHooks is a freemium MCP server for sports data. Motorsport race forecasts, odds and pit-stop models through your RaceHooks account. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $99 a month
- **Platforms:** CLI, API
- **Website:** https://racehooks.io
- **Repository:** https://github.com/racehooks/racehooks-mcp
- **MCP Registry name:** io.github.racehooks/racehooks-mcp
- **Categories:** sports data, analytics and data
- **Listing updated:** 2026-11-14

## About

Lap-by-lap forecasts for motorsport are the product behind this server, and the server hands an assistant 58 tools, 7 resources and 6 guided prompts against your account. What each call returns depends on your plan, so a Free account gets less detail than Developer.

The tools span live session state, race weekends and schedules, and post-race insights with per-driver, per-lap model outputs for pit stops, safety cars, overtakes, undercuts, tyre health, cliff risk and win probability. Further tools cover race results, qualifying, pit stops, tyre stints, weather, lap times, practice pace, and history for drivers, constructors, circuits and seasons.

It needs a RaceHooks client ID and secret, and the base URL defaults to the hosted API. The website describes forecasts for race pricing, rival pit-stop intent, Formula 1 battery charge and strategy simulation, aimed at strategists, trading desks and broadcasters. The README notes it is independent and not affiliated with Formula One Management or the FIA.

## Features

- **Live session state:** Flag, lap, running order, intervals, tyres and race control messages when a session is live.
- **Post-race model outputs:** Per-driver, per-lap pit, safety car, overtake, undercut and tyre outputs.
- **Historical lookups:** Drivers, constructors, circuits, seasons and standings.
- **Race detail tools:** Results, qualifying, pit stops, tyre stints, weather and lap times.
- **Plan-aware access:** Returned detail depends on whether the account is Free, Developer or Custom.
- **Guided prompts and resources:** Includes 7 resources and 6 prompts alongside the tools.

## Good for

- Ask which rivals are likely to pit next lap
- Review a finished race's tyre and pit strategy
- Look up a driver's season results and standings
- Check weather and lap times for a race

## Install

### Claude Code (Terminal)

```sh
claude mcp add racehooks-mcp --env RACEHOOKS_CLIENT_ID='<RACEHOOKS_CLIENT_ID>' --env RACEHOOKS_CLIENT_SECRET='<RACEHOOKS_CLIENT_SECRET>' -- npx -y @racehooks/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "racehooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@racehooks/mcp"
      ],
      "env": {
        "RACEHOOKS_CLIENT_ID": "<RACEHOOKS_CLIENT_ID>",
        "RACEHOOKS_CLIENT_SECRET": "<RACEHOOKS_CLIENT_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "racehooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@racehooks/mcp"
      ],
      "env": {
        "RACEHOOKS_CLIENT_ID": "<RACEHOOKS_CLIENT_ID>",
        "RACEHOOKS_CLIENT_SECRET": "<RACEHOOKS_CLIENT_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "racehooks-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@racehooks/mcp"
      ],
      "env": {
        "RACEHOOKS_CLIENT_ID": "<RACEHOOKS_CLIENT_ID>",
        "RACEHOOKS_CLIENT_SECRET": "<RACEHOOKS_CLIENT_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "racehooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@racehooks/mcp"
      ],
      "env": {
        "RACEHOOKS_CLIENT_ID": "<RACEHOOKS_CLIENT_ID>",
        "RACEHOOKS_CLIENT_SECRET": "<RACEHOOKS_CLIENT_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "racehooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@racehooks/mcp"
      ],
      "env": {
        "RACEHOOKS_CLIENT_ID": "<RACEHOOKS_CLIENT_ID>",
        "RACEHOOKS_CLIENT_SECRET": "<RACEHOOKS_CLIENT_SECRET>"
      }
    }
  }
}
```

## Tools

- `get_live_session`: Current session state including flag, lap, running order and tyres
- `list_events`: Race weekends with session schedules
- `list_insight_races`: Races with a completed post-race analytics bundle
- `get_race_insights`: Per-driver, per-lap model outputs plus pit stops, stints and lap times
- `get_model_meta`: Public model manifest
- `get_session_analytics`: Per-lap analytics snapshot for a session
- `get_race_summary`: Post-race analytics status and aggregate metrics
- `get_race`: Race details with results and grid
- `get_race_qualifying`: Qualifying results
- `get_race_pitstops`: Pit stop records
- `get_race_tyres`: Tyre stints
- `get_race_weather`: Lap-by-lap weather
- `get_race_laps`: Per-lap times and positions
- `get_event_pace`: Practice and qualifying pace summary per driver
- `list_drivers`: Drivers, searchable
- `get_driver`: Driver profile with career stats
- `get_driver_results`: Race-by-race results for a driver
- `get_driver_standings`: Championship standings history for a driver
- `list_constructors`: Constructors
- `get_constructor`: Constructor profile with lineage history
- `get_constructor_results`: Race-by-race results for a constructor
- `get_constructor_standings`: Championship standings history for a constructor
- `list_circuits`: Circuits with location
- `get_circuit`: Circuit details and analytics
- `list_seasons`: Seasons with race counts

## FAQ

### What credentials are needed?

A RaceHooks client ID and client secret.

### How many tools does it expose?

58 tools, 7 resources and 6 guided prompts.

### What does it cost?

The site lists a free tier and a Developer plan at $99 per month; Custom terms are agreed with the vendor.

### Is it affiliated with Formula 1?

No. The README says it is independent and not endorsed by Formula One Management or the FIA.

### Is RaceHooks free?

RaceHooks has a free plan, with paid plans for more usage or features. Paid plans start at $99 a month.

### How do I add RaceHooks to Claude Code?

Run this command in your terminal: claude mcp add racehooks-mcp --env RACEHOOKS_CLIENT_ID='<RACEHOOKS_CLIENT_ID>' --env RACEHOOKS_CLIENT_SECRET='<RACEHOOKS_CLIENT_SECRET>' -- npx -y @racehooks/mcp

### What are the best alternatives to RaceHooks?

The closest alternatives to RaceHooks are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/racehooks
