@racehooks/mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RACEHOOKS_BASE_URL | No | API base URL, defaults to https://api.racehooks.io | |
| RACEHOOKS_CLIENT_ID | Yes | Your RaceHooks client ID (racehooks.io) | |
| RACEHOOKS_CLIENT_SECRET | Yes | Your RaceHooks client secret |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_feedsB | 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. |
| list_webhooksC | List all webhook subscriptions for the authenticated RaceHooks account. |
| get_webhookB | Get a single webhook subscription by ID. |
| create_webhookA | Register a new webhook subscription. Returns the webhook and the HMAC signing secret (shown once — store it immediately). |
| update_webhookA | 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. |
| delete_webhookB | Permanently delete a webhook subscription. |
| test_webhookA | Send a test payload to a webhook endpoint immediately. Useful for verifying your server is reachable and your HMAC verification code is correct. |
| get_webhook_logsB | Retrieve recent delivery logs for a webhook — shows status codes, retry counts, and payload excerpts. |
| get_webhook_secretB | Retrieve the current HMAC signing secret for a webhook. |
| rotate_webhook_secretA | 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. |
| get_live_sessionA | 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. |
| list_eventsB | List events (race weekends) for the current or a specific season, including session schedules and status. |
| get_subscriptionA | Get the current subscription tier, plan limits (webhooks, deliveries, HMAC, analytics enrichment), and live usage snapshot for this account. |
| get_usageA | Get delivery usage summary for the current period: total deliveries, failures, tier, and remaining monthly delivery bucket. |
| get_usage_by_feedA | Get webhook delivery counts broken down by feed for the current period. Useful for identifying which feeds are driving delivery volume. |
| get_usage_latencyA | Get webhook delivery latency percentiles (p50, p95, p99) broken down by feed for the current period. |
| get_usage_hourlyA | Get webhook delivery volume broken down by hour for the last 24 hours. Useful for identifying traffic spikes. |
| get_usage_historyB | Get historical delivery counts and failure rates over past periods. |
| get_billing_planA | Get the detailed billing plan including tier, subscription period end date, limits, and current usage. |
| list_replay_sessionsA | 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. |
| get_demo_sessionA | Get the curated demo session to replay (the canonical ID of a guaranteed-real event). |
| get_replay_quotaB | Get the replay delivery quota for this account: distinct-session lifetime slots for your tier. |
| prepare_replayA | Prepare a session for recorded playback, generating its playback artifact if not already cached. Check readiness with get_replay_status. |
| get_replay_statusA | Check whether a session's playback artifact is ready to stream. |
| list_driversC | List drivers. Available on every plan; page size is capped at 25 on Free and 100 on paid plans. |
| get_driverA | Get a driver profile with career statistics (wins, podiums, poles, championships). Available on every plan. |
| get_driver_resultsA | Get race-by-race results for a driver. Available on every plan; timing fields (gap, finish time) are only returned on Developer and above. |
| get_driver_standingsB | Get championship standings history for a driver across seasons. Available on every plan. |
| list_constructorsC | List constructors. Available on every plan. |
| get_constructorB | Get a constructor profile including its lineage history (predecessor and successor teams). Available on every plan. |
| get_constructor_resultsC | Get race-by-race results for a constructor. Available on every plan; timing fields (gap, finish time) are only returned on Developer and above. |
| get_constructor_standingsB | Get championship standings history for a constructor across seasons. Available on every plan. |
| list_circuitsB | List all F1 circuits with location and coordinates. Available on every plan. |
| get_circuitA | Get circuit details and analytics (compound priors, historical pace data). Available on every plan. |
| list_seasonsA | List all available F1 seasons with race counts. Available on every plan. |
| get_season_standingsA | Get final driver and constructor championship standings for a season. Available on every plan. |
| get_season_racesB | List all races in a season with circuit, date, and data quality tier. Available on every plan. |
| get_raceA | 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. |
| get_race_qualifyingA | Get qualifying results for a race. Available on every plan; Q1/Q2/Q3 times are only returned on Developer and above. |
| get_race_pitstopsB | Get all pit stop records for a race (driver, stop number, lap, duration). Available on every plan. |
| get_race_tyresB | Get tyre stint records for a race (driver, stint number, lap range, compound, tyre age). Available on every plan. |
| get_race_weatherB | Get lap-by-lap weather data for a race. Available on every plan. |
| get_race_lapsA | Get per-lap times and positions for a race. Requires Developer or higher. Optionally filter to a single driver with driverId. |
| get_race_summaryA | 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. |
| get_race_telemetry_lapsA | Get per-lap telemetry metrics (speed, throttle, brake, DRS, aggression) from telemetry data. Requires Developer or higher. Optional driverId to filter to one driver. |
| get_race_telemetry_stintsB | Get per-stint telemetry metrics and degradation slopes. Requires a Custom plan (not included in Developer). |
| get_race_telemetry_aggressionB | Get driver aggression index rankings for a race. Requires a Custom plan (not included in Developer). |
| get_session_analyticsA | Get per-lap ML analytics snapshot for a session (pit probability, SC probability, tyre health, LTOE, win probability). Requires Developer or higher. |
| get_event_paceB | Get practice and qualifying pace summary per driver for an event. Requires Developer or higher. |
| list_insight_racesA | List races that have a completed post-race analytics pipeline — i.e. races where get_race_insights will return data. Available on every plan. |
| get_race_insightsA | 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. |
| get_model_metaA | 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. |
| get_telemetry_lapsA | 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. |
| get_telemetry_driver_lapsA | Get per-lap telemetry for a single driver across all laps of a race. Requires Developer or higher. |
| get_telemetry_lap_comparisonB | Get all drivers' telemetry for a single lap — useful for side-by-side lap comparisons. Requires Developer or higher. |
| get_telemetry_race_summaryA | Get race-level telemetry summary: max speed, fastest driver, average throttle/brake percentages, top aggression driver. Requires Developer or higher. |
| get_fantasy_pit_timesA | 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. |
| get_fantasy_scoresA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| setup_race_event_webhook | Guided workflow: create an events.race webhook subscription with optional driver, constructor, or position filters. |
| check_account_health | Get a summary of account health: current tier, usage vs limits, active webhook count, and live session status. |
| setup_fantasy_scoring_webhook | Guided workflow: create a webhook optimised for F1 Fantasy scoring — overtakes, fastest lap, DNF, and pit stop events. |
| analyze_race_strategy | Analyze pit strategy, tyre management, and ML predictions for a specific race — optionally focused on one driver. |
| compare_drivers | Compare two drivers across a race: pace delta, tyre degradation, pit strategy, and ML-predicted performance. |
| explain_ml_predictions | Explain what the RaceHooks ML models predicted vs what actually happened in the most recent race with analytics data. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| feed-catalog | Complete RaceHooks feed catalog — all subscribable feeds with tier requirements and cadence information. |
| live-session | Current live session context: flag status, lap counter, full driver standings with tyre compounds and intervals, and recent race control messages. |
| webhooks | All active webhook subscriptions on this account, including feed IDs, endpoint URLs, filter configurations, and delivery tier. |
| usage | Current delivery usage: total deliveries this month, failure count, monthly delivery bucket, and remaining capacity. |
| drivers | Current-season driver roster with car numbers and TLA codes. |
| circuits | All circuits in the RaceHooks database with location and country. |
| seasons | All available seasons in the RaceHooks database with race counts. |
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.