Skip to main content
Glama
@racehooks/mcp

@racehooks/mcp

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
RACEHOOKS_BASE_URLNoAPI base URL, defaults to https://api.racehooks.io
RACEHOOKS_CLIENT_IDYesYour RaceHooks client ID (racehooks.io)
RACEHOOKS_CLIENT_SECRETYesYour 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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. restrictedToSeason in the response reports the applied limit.

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

NameDescription
setup_race_event_webhookGuided workflow: create an events.race webhook subscription with optional driver, constructor, or position filters.
check_account_healthGet a summary of account health: current tier, usage vs limits, active webhook count, and live session status.
setup_fantasy_scoring_webhookGuided workflow: create a webhook optimised for F1 Fantasy scoring — overtakes, fastest lap, DNF, and pit stop events.
analyze_race_strategyAnalyze pit strategy, tyre management, and ML predictions for a specific race — optionally focused on one driver.
compare_driversCompare two drivers across a race: pace delta, tyre degradation, pit strategy, and ML-predicted performance.
explain_ml_predictionsExplain 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

NameDescription
feed-catalogComplete RaceHooks feed catalog — all subscribable feeds with tier requirements and cadence information.
live-sessionCurrent live session context: flag status, lap counter, full driver standings with tyre compounds and intervals, and recent race control messages.
webhooksAll active webhook subscriptions on this account, including feed IDs, endpoint URLs, filter configurations, and delivery tier.
usageCurrent delivery usage: total deliveries this month, failure count, monthly delivery bucket, and remaining capacity.
driversCurrent-season driver roster with car numbers and TLA codes.
circuitsAll circuits in the RaceHooks database with location and country.
seasonsAll available seasons in the RaceHooks database with race counts.

TDQS

B3.2/5.0

Scored across 58 tools

Disambiguation3/5

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.

Naming Consistency5/5

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.

Tool Count1/5

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.

Completeness4/5

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

ActivityMaintained
ResponsivenessNo recent community issues