@racehooks/mcp
OfficialThis MCP server exposes RaceHooks motorsport data and account APIs to AI assistants.
Manage webhook subscriptions: list, get, create, update, pause/resume, delete, test, view logs, and retrieve/rotate signing secrets.
Query live sessions, race weekends/events, and feed/model metadata.
Inspect account subscription, usage, usage by feed, latency, hourly/history usage, and billing plan.
Handle replay sessions: list, get demo, check quota, prepare, and check status.
Browse drivers, constructors, circuits, seasons, standings, and results.
Retrieve race data: qualifying, pit stops, tyres, weather, laps, summary, and ML insights.
Access advanced analytics and telemetry: session analytics, event pace, per-lap telemetry, driver laps, lap comparisons, race summaries, stint degradation, and aggression rankings.
Get F1 Fantasy pit times and estimated scores.
Some tools/fields are plan-gated; advanced timing, analytics, and telemetry require Developer or Custom tiers.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@racehooks/mcp Show me which feeds are using the most delivery quota today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@racehooks/mcp
MCP server for RaceHooks — gives AI assistants (Claude, Cursor, Windsurf) direct access to RaceHooks predictive models and analytics for motorsport — race intelligence delivered to your endpoint.
RaceHooks is an independent service and is not affiliated with or endorsed by Formula One Management or the FIA. "Formula 1," "F1," and related marks are trademarks of Formula One Licensing BV.
What this does
Exposes your RaceHooks account to an AI assistant as 58 tools, 7 resources, and 6 guided prompts. Every call is made with your account's credentials, so what a tool returns depends on your plan (Free, Developer, or Custom). The data tools cover motorsport (including Formula 1).
Tools
Live
Tool | What it does | Key args | Plan |
| Current session state: flag, lap, running order, intervals, tyres, race control messages. Empty when nothing is live. | — | All (Free gets the latest milestone classification instead of live timing) |
| Race weekends with session schedules and status. |
| All |
Post-race insights
Tool | What it does | Key args | Plan |
| Races with a completed post-race analytics bundle. |
| All |
| Per-driver, per-lap model outputs (pit, safety car, overtake, undercut, tyre health, cliff risk, LTOE, win probability, expected points) plus pit stops, stints, and lap times. |
| All (Free gets tyre state only; strategic predictions need Developer+) |
| Public model manifest: each model's id, label, feed and status. | — | All |
| Per-lap analytics snapshot for a session. |
| Developer+ |
| Post-race analytics status and aggregate telemetry metrics. |
| All (aggregates need Developer+) |
Races
Tool | What it does | Key args | Plan |
| Race details with results and qualifying grid. |
| All (timing fields need Developer+) |
| Qualifying results. |
| All (Q1/Q2/Q3 times need Developer+) |
| Pit stop records (driver, stop, lap, duration). |
| All |
| Tyre stints (compound, lap range, tyre age). |
| All |
| Lap-by-lap weather. |
| All |
| Per-lap times and positions. |
| Developer+ |
| Practice and qualifying pace summary per driver. |
| Developer+ |
History (drivers, constructors, circuits, seasons)
Tool | What it does | Key args | Plan |
| Drivers, searchable. |
| All (page size 25 on Free, 100 paid) |
| Driver profile with career stats. |
| All |
| Race-by-race results for a driver. |
| All (timing fields need Developer+) |
| Championship standings history for a driver. |
| All |
| Constructors. |
| All |
| Constructor profile with lineage history. |
| All |
| Race-by-race results for a constructor. |
| All (timing fields need Developer+) |
| Championship standings history for a constructor. |
| All |
| Circuits with location. |
| All |
| Circuit details and analytics. |
| All |
| Seasons with race counts. | — | All |
| Final driver and constructor standings for a season. |
| All |
| Races in a season. |
| All |
Telemetry
Tool | What it does | Key args | Plan |
| Per-lap telemetry aggregates (speed, throttle, brake, DRS, aggression). |
| Developer+ |
| Per-lap telemetry for one driver. |
| Developer+ |
| Every driver's telemetry for one lap. |
| Developer+ |
| Race-level telemetry summary. |
| Developer+ |
| Per-lap telemetry metrics from the race data API. |
| Developer+ |
| Per-stint telemetry and degradation slopes. |
| Custom |
| Driver aggression index rankings. |
| Custom |
Fantasy
Tool | What it does | Key args | Plan |
| Estimated F1 Fantasy points per driver with full breakdown. |
| Developer+ |
| Pit-stop time leaderboard (stationary time) for a session. |
| Developer+ |
Account, usage and webhooks
Tool | What it does | Key args | Plan |
| Feed catalog with the plan each feed requires. |
| All |
| Webhook subscriptions on the account. |
| All |
| One webhook by ID. |
| All |
| Create a webhook; returns the signing secret once. |
| All |
| Change URL, method, or filters; pause/resume with |
| All |
| Delete a webhook. |
| All |
| Send a test payload now. |
| All |
| Recent delivery logs. |
| All |
| Current signing secret. |
| All |
| Rotate the signing secret (old one stops working immediately). |
| All |
| Tier, plan limits, and usage snapshot. | — | All |
| Deliveries and failures this period, remaining bucket. | — | All |
| Deliveries by feed this period. | — | All |
| Delivery latency percentiles by feed. | — | All |
| Hourly deliveries for the last 24 hours. | — | All |
| Delivery history across past periods. | — | All |
| Current plan, limits, usage this period, and billing period dates. | — | All |
Session replay
Tool | What it does | Key args | Plan |
| Recorded sessions that can be replayed. |
| All (Free and Developer: current season only) |
| The curated demo session to replay. | — | All |
| Replay delivery quota (distinct-session slots) for your tier. | — | All |
| Prepare a session's playback artifact. |
| All |
| Whether a session's playback artifact is ready. |
| All |
Resources (read-only context)
racehooks://feeds— full feed catalogracehooks://live— current live session stateracehooks://webhooks— all webhook subscriptionsracehooks://usage— current delivery usageracehooks://drivers— current-season driver rosterracehooks://circuits— circuits with locationracehooks://seasons— seasons with race counts
Prompts (guided workflows)
setup_race_event_webhook— create anevents.racesubscription with filterssetup_fantasy_scoring_webhook— create a fantasy-optimised subscriptioncheck_account_health— full account health summaryanalyze_race_strategy— pit strategy, tyre management, and model predictions for one racecompare_drivers— two drivers head-to-head across a raceexplain_ml_predictions— what the models predicted vs what happened in the latest analysed race
Related MCP server: iRacing MCP Server
Installation
npm install -g @racehooks/mcpOr run directly with npx:
npx @racehooks/mcpGet your API credentials at racehooks.io.
Use of RaceHooks through this MCP server is subject to the RaceHooks Terms of Service and Privacy Policy. Model outputs are probabilistic estimates, not statements of fact.
Configuration
Two environment variables are required; the server exits on start-up without them:
export RACEHOOKS_CLIENT_ID="your-client-id"
export RACEHOOKS_CLIENT_SECRET="your-client-secret"
# Optional — defaults to https://api.racehooks.io
export RACEHOOKS_BASE_URL="https://api.racehooks.io"Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"racehooks": {
"command": "npx",
"args": ["-y", "@racehooks/mcp"],
"env": {
"RACEHOOKS_CLIENT_ID": "your-client-id",
"RACEHOOKS_CLIENT_SECRET": "your-client-secret"
}
}
}
}Claude Code
Claude Code does not read MCP servers from .claude/settings.json. Add the server with the CLI:
claude mcp add racehooks \
-e RACEHOOKS_CLIENT_ID=your-client-id \
-e RACEHOOKS_CLIENT_SECRET=your-client-secret \
-- npx -y @racehooks/mcpAdd --scope project to write it to a shared .mcp.json in your project, or --scope user to make it available in every project. To check the file in without committing secrets, reference environment variables in .mcp.json:
{
"mcpServers": {
"racehooks": {
"command": "npx",
"args": ["-y", "@racehooks/mcp"],
"env": {
"RACEHOOKS_CLIENT_ID": "${RACEHOOKS_CLIENT_ID}",
"RACEHOOKS_CLIENT_SECRET": "${RACEHOOKS_CLIENT_SECRET}"
}
}
}
}Cursor / Windsurf
Add to your MCP config (.cursor/mcp.json or equivalent):
{
"mcpServers": {
"racehooks": {
"command": "npx",
"args": ["-y", "@racehooks/mcp"],
"env": {
"RACEHOOKS_CLIENT_ID": "your-client-id",
"RACEHOOKS_CLIENT_SECRET": "your-client-secret"
}
}
}
}Cline
In Cline, open MCP Servers → Installed → Configure MCP Servers and add to cline_mcp_settings.json:
{
"mcpServers": {
"racehooks": {
"command": "npx",
"args": ["-y", "@racehooks/mcp"],
"env": {
"RACEHOOKS_CLIENT_ID": "your-client-id",
"RACEHOOKS_CLIENT_SECRET": "your-client-secret"
},
"disabled": false
}
}
}Example usage with Claude
Once configured, you can ask Claude things like:
"Check my RaceHooks account health"
"Create an
events.racewebhook for https://myapp.com/hook, filtering for Ferrari only"
"Compare VER and NOR tyre degradation in the last race"
"Show me which feeds are using the most delivery quota today"
"Set up a fantasy scoring webhook for my VER, NOR, LEC team at https://scoring.myapp.com/hook"
Security
The MCP server runs as a local stdio process — it never binds a network port. Your credentials are passed via environment variables, are sent only to the RaceHooks API (to obtain an access token), and are never included in tool calls or resource URIs.
All API calls are authenticated using OAuth 2 client credentials (token auto-refreshes before expiry).
Links
Available Tools
58 toolscreate_webhookCreate WebhookA
Register a new webhook subscription. Returns the webhook and the HMAC signing secret (shown once — store it immediately).
Inputs: feedId (required), webhookUrl (required), filters, webhookMethod.
delete_webhookDelete WebhookBDestructiveIdempotent
Permanently delete a webhook subscription.
Inputs: webhookId (required).
get_billing_planGet Billing PlanARead-onlyIdempotent
Get the detailed billing plan including tier, subscription period end date, limits, and current usage.
Inputs: no named parameters.
get_circuitGet CircuitARead-onlyIdempotent
Get circuit details and analytics (compound priors, historical pace data). Available on every plan.
Inputs: circuitId (required).
get_constructorGet ConstructorBRead-onlyIdempotent
Get a constructor profile including its lineage history (predecessor and successor teams). Available on every plan.
Inputs: constructorId (required).
get_constructor_resultsGet Constructor ResultsCRead-onlyIdempotent
Get race-by-race results for a constructor. Available on every plan; timing fields (gap, finish time) are only returned on Developer and above.
Inputs: constructorId (required), limit, offset, season.
get_constructor_standingsGet Constructor StandingsBRead-onlyIdempotent
Get championship standings history for a constructor across seasons. Available on every plan.
Inputs: constructorId (required), season.
get_demo_sessionGet Demo SessionARead-onlyIdempotent
Get the curated demo session to replay (the canonical ID of a guaranteed-real event).
Inputs: no named parameters.
get_driverGet DriverARead-onlyIdempotent
Get a driver profile with career statistics (wins, podiums, poles, championships). Available on every plan.
Inputs: driverId (required).
get_driver_resultsGet Driver ResultsARead-onlyIdempotent
Get race-by-race results for a driver. Available on every plan; timing fields (gap, finish time) are only returned on Developer and above.
Inputs: driverId (required), limit, offset, season.
get_driver_standingsGet Driver StandingsBRead-onlyIdempotent
Get championship standings history for a driver across seasons. Available on every plan.
Inputs: driverId (required), season.
get_event_paceGet Event PaceBRead-onlyIdempotent
Get practice and qualifying pace summary per driver for an event. Requires Developer or higher.
Inputs: eventId (required).
get_fantasy_pit_timesGet Fantasy Pit TimesARead-onlyIdempotent
Get the pit-stop time leaderboard for a session: stationary time (seconds stopped in the box) per stop, with driver code and team. Requires Developer or higher.
Inputs: sessionId (required).
get_fantasy_scoresGet Fantasy ScoresARead-onlyIdempotent
Get estimated F1 Fantasy points per driver for a completed race. Includes full scoring breakdown: race position points, qualifying points, Q2/Q3 bonuses, positions gained, fastest lap, beat-teammate bonuses, and DNF penalty. Requires Developer or higher.
Inputs: raceId (required).
get_live_sessionGet Live SessionARead-onlyIdempotent
Get the current live session state: flag status, lap number, driver positions, intervals, tyre compounds, and recent race control messages. Returns an empty/inactive context when no session is live. Live per-driver timing requires Developer or higher; Free receives the latest milestone classification (end of a qualifying segment or the final result) instead.
Inputs: no named parameters.
get_model_metaGet Model MetaARead-onlyIdempotent
Get the public model manifest for each RaceHooks predictive model: what it predicts, its model family, a qualitative calibration tier, when it was last trained, and a changelog. Raw evaluation metrics are not exposed. Available on every plan.
Inputs: no named parameters.
get_raceGet RaceARead-onlyIdempotent
Get race details with full results and qualifying grid. Available on every plan; timing fields (gaps, fastest lap, finish time, Q1/Q2/Q3 times) are only returned on Developer and above.
Inputs: raceId (required).
get_race_insightsGet Race InsightsARead-onlyIdempotent
Get the full post-race ML analytics bundle for a race. Includes per-driver per-lap outputs: pit stop probability, safety car probability, overtake probability, undercut probability, tyre health, cliff risk and lap prediction, fuel-corrected lap time (LTOE), win probability, expected championship points. Also includes pit stops, tyre stints, lap times, and safety-car lap list. Output depends on plan: Free receives the descriptive data plus tyre state only (compound, tyre life, tyre health); the strategic predictions require Developer or higher.
Inputs: raceId (required).
get_race_lapsGet Race LapsARead-onlyIdempotent
Get per-lap times and positions for a race. Requires Developer or higher. Optionally filter to a single driver with driverId.
Inputs: raceId (required), driverId.
get_race_pitstopsGet Race PitstopsBRead-onlyIdempotent
Get all pit stop records for a race (driver, stop number, lap, duration). Available on every plan.
Inputs: raceId (required).
get_race_qualifyingGet Race QualifyingARead-onlyIdempotent
Get qualifying results for a race. Available on every plan; Q1/Q2/Q3 times are only returned on Developer and above.
Inputs: raceId (required).
get_race_summaryGet Race SummaryARead-onlyIdempotent
Get the post-race analytics status and aggregate telemetry metrics for a race. Status is available on every plan; the aggregate metrics are only returned on Developer and above.
Inputs: raceId (required).
get_race_telemetry_aggressionGet Race Telemetry AggressionBRead-onlyIdempotent
Get driver aggression index rankings for a race. Requires a Custom plan (not included in Developer).
Inputs: raceId (required).
get_race_telemetry_lapsGet Race Telemetry LapsARead-onlyIdempotent
Get per-lap telemetry metrics (speed, throttle, brake, DRS, aggression) from telemetry data. Requires Developer or higher. Optional driverId to filter to one driver.
Inputs: raceId (required), driverId.
get_race_telemetry_stintsGet Race Telemetry StintsBRead-onlyIdempotent
Get per-stint telemetry metrics and degradation slopes. Requires a Custom plan (not included in Developer).
Inputs: raceId (required), driverId.
get_race_tyresGet Race TyresBRead-onlyIdempotent
Get tyre stint records for a race (driver, stint number, lap range, compound, tyre age). Available on every plan.
Inputs: raceId (required).
get_race_weatherGet Race WeatherBRead-onlyIdempotent
Get lap-by-lap weather data for a race. Available on every plan.
Inputs: raceId (required).
get_replay_quotaGet Replay QuotaBRead-onlyIdempotent
Get the replay delivery quota for this account: distinct-session lifetime slots for your tier.
Inputs: no named parameters.
get_replay_statusGet Replay StatusARead-onlyIdempotent
Check whether a session's playback artifact is ready to stream.
Inputs: sessionId (required).
get_season_racesGet Season RacesBRead-onlyIdempotent
List all races in a season with circuit, date, and data quality tier. Available on every plan.
Inputs: year (required).
get_season_standingsGet Season StandingsARead-onlyIdempotent
Get final driver and constructor championship standings for a season. Available on every plan.
Inputs: year (required).
get_session_analyticsGet Session AnalyticsARead-onlyIdempotent
Get per-lap ML analytics snapshot for a session (pit probability, SC probability, tyre health, LTOE, win probability). Requires Developer or higher.
Inputs: sessionId (required).
get_subscriptionGet SubscriptionARead-onlyIdempotent
Get the current subscription tier, plan limits (webhooks, deliveries, HMAC, analytics enrichment), and live usage snapshot for this account.
Inputs: no named parameters.
get_telemetry_driver_lapsGet Telemetry Driver LapsARead-onlyIdempotent
Get per-lap telemetry for a single driver across all laps of a race. Requires Developer or higher.
Inputs: raceId (required), driverId (required).
get_telemetry_lap_comparisonGet Telemetry Lap ComparisonBRead-onlyIdempotent
Get all drivers' telemetry for a single lap — useful for side-by-side lap comparisons. Requires Developer or higher.
Inputs: raceId (required), lapNumber (required).
get_telemetry_lapsGet Telemetry LapsARead-onlyIdempotent
Get per-lap telemetry aggregates (avg/max speed, throttle, brake, DRS, aggression index). Returns all drivers by default. Filter with driverId or lapNumber. Requires Developer or higher.
Inputs: raceId (required), driverId, lapNumber.
get_telemetry_race_summaryGet Telemetry Race SummaryARead-onlyIdempotent
Get race-level telemetry summary: max speed, fastest driver, average throttle/brake percentages, top aggression driver. Requires Developer or higher.
Inputs: raceId (required).
get_usageGet UsageARead-onlyIdempotent
Get delivery usage summary for the current period: total deliveries, failures, tier, and remaining monthly delivery bucket.
Inputs: no named parameters.
get_usage_by_feedGet Usage By FeedARead-onlyIdempotent
Get webhook delivery counts broken down by feed for the current period. Useful for identifying which feeds are driving delivery volume.
Inputs: no named parameters.
get_usage_historyGet Usage HistoryBRead-onlyIdempotent
Get historical delivery counts and failure rates over past periods.
Inputs: no named parameters.
get_usage_hourlyGet Usage HourlyARead-onlyIdempotent
Get webhook delivery volume broken down by hour for the last 24 hours. Useful for identifying traffic spikes.
Inputs: no named parameters.
get_usage_latencyGet Usage LatencyARead-onlyIdempotent
Get webhook delivery latency percentiles (p50, p95, p99) broken down by feed for the current period.
Inputs: no named parameters.
get_webhookGet WebhookBRead-onlyIdempotent
Get a single webhook subscription by ID.
Inputs: webhookId (required).
get_webhook_logsGet Webhook LogsBRead-onlyIdempotent
Retrieve recent delivery logs for a webhook — shows status codes, retry counts, and payload excerpts.
Inputs: webhookId (required), limit.
get_webhook_secretGet Webhook SecretBRead-onlyIdempotent
Retrieve the current HMAC signing secret for a webhook.
Inputs: webhookId (required).
list_circuitsList CircuitsBRead-onlyIdempotent
List all F1 circuits with location and coordinates. Available on every plan.
Inputs: limit, offset, country.
list_constructorsList ConstructorsCRead-onlyIdempotent
List constructors. Available on every plan.
Inputs: limit, active, offset, lineage.
list_driversList DriversCRead-onlyIdempotent
List drivers. Available on every plan; page size is capped at 25 on Free and 100 on paid plans.
Inputs: limit, active, offset, search, +1 more.
list_eventsList EventsBRead-onlyIdempotent
List events (race weekends) for the current or a specific season, including session schedules and status.
Inputs: year, limit, upcoming.
list_feedsList FeedsBRead-onlyIdempotent
List all available RaceHooks data feeds, including which subscription tier each feed requires. The special 'events.race' feed is a synthetic feed that emits structured events (overtakes, pit stops, safety cars, etc.) derived from multiple raw feeds.
Inputs: limit.
list_insight_racesList Insight RacesARead-onlyIdempotent
List races that have a completed post-race analytics pipeline — i.e. races where get_race_insights will return data. Available on every plan.
Inputs: season.
list_replay_sessionsList Replay SessionsARead-onlyIdempotent
List recorded sessions that have archived data and can be replayed. Only completed sessions with archive paths are returned. Self-serve tiers (Free and Developer) list the current season only, plus the curated demo session; the full historical archive is on Custom. restrictedToSeason in the response reports the applied limit.
Inputs: type, year, limit, offset.
list_seasonsList SeasonsARead-onlyIdempotent
List all available F1 seasons with race counts. Available on every plan.
Inputs: no named parameters.
list_webhooksList WebhooksCRead-onlyIdempotent
List all webhook subscriptions for the authenticated RaceHooks account.
Inputs: limit, offset.
prepare_replayPrepare ReplayAIdempotent
Prepare a session for recorded playback, generating its playback artifact if not already cached. Check readiness with get_replay_status.
Inputs: sessionId (required).
rotate_webhook_secretRotate Webhook SecretADestructive
Rotate the HMAC signing secret for a webhook. The old secret is invalidated immediately — update your server before calling this. The new secret is shown once.
Inputs: webhookId (required).
test_webhookTest WebhookA
Send a test payload to a webhook endpoint immediately. Useful for verifying your server is reachable and your HMAC verification code is correct.
Inputs: webhookId (required).
update_webhookUpdate WebhookAIdempotent
Update an existing webhook subscription. Use active: false to pause delivery, active: true to resume. Can also update the endpoint URL, HTTP method, or filters without deleting and recreating the webhook.
Inputs: webhookId (required), active, filters, webhookUrl, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 58 tools
Core resources such as webhooks, drivers, races, and usage are mostly distinct, but the telemetry/analytics area has several overlapping tools: get_telemetry_laps, get_race_telemetry_laps, get_telemetry_driver_laps, and get_telemetry_lap_comparison are easy to confuse. Similarly, get_race_summary, get_telemetry_race_summary, get_session_analytics, and get_race_insights require careful reading to select correctly.
Tool names consistently use snake_case with a verb-first pattern such as list_, get_, create_, update_, delete_, prepare_, and rotate_. Despite the large surface, there is no mixing of camelCase or vague standalone names.
With 58 tools, the surface is far beyond a well-scoped set and includes many plan-gated variants and overlapping telemetry/analytics endpoints. This volume creates a large selection burden even though the underlying domain is broad.
Coverage is broad and lifecycle-oriented: webhook CRUD, testing, logs, secrets, rotation, usage, billing, replays, F1 data, telemetry, analytics, live sessions, and fantasy outputs are all represented. Minor gaps remain around account/subscription management and webhook delivery retry/resend operations.
Maintenance
Related MCP Connectors
Hosted MCP server for live public-data APIs and Skills for AI agents.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides 118+ Formula 1 analytics tools, enabling race analysis, driver comparisons, telemetry exploration, and strategy simulation through natural language.26 PyPIMIT
- AlicenseCqualityDmaintenanceEnables AI assistants to access real-time iRacing telemetry, race information, camera control, pit operations, and replay features through the MCP protocol.171MIT
- FlicenseAqualityDmaintenanceMCP server for motorsport event documents, enabling AI agents to search, read, compare amendments, and parse schedules via typed tools.9-
- AlicenseBqualityDmaintenanceMCP server that provides F1 telemetry analysis, tyre degradation modeling, and pit strategy recommendations, delivering race engineer-style calls grounded in real data. It exposes tools for degradation fits, fuel correction, and strategy reasoning via LangGraph.4MIT