stackgate.ai
All integrations
Formula 1

Formula 1

Access Formula 1 races, calendars, circuits, drivers, constructors, results, grids, pit stops and championship standings.

Manual setup 16 tools

Overview

Connect Formula 1 so AI clients can retrieve races, calendars, circuits, drivers, constructors, results, starting grids, pit stops, and championship standings.

stackgate.ai stores your API-Sports Formula-1 API key encrypted and calls the provider on your behalf. Tool results are returned to your AI client for that request. Responses are cached briefly on the hub (by connection) to reduce duplicate upstream calls and protect your daily quota.

This integration is read-only. Public tool names and response shapes are provider-neutral; the initial upstream provider is API-Sports Formula-1.

Prerequisites

  • An API-Sports account with Formula-1 API access and an API key
  • A stackgate.ai account

Getting credentials

  1. Sign in to stackgate.ai.
  2. Go to My Integrations and open Formula 1.
  3. In a separate tab, open the API-Sports dashboard.
  4. Confirm your subscription includes Formula-1, then go to Account → My Access and copy your API key.
  5. Paste the key into stackgate.ai and click Save.
  6. stackgate.ai runs a lightweight connection test (/status). On success you may see your plan name and daily request limit.
  7. Optionally use Edit tool access to limit which read tools the connection may use.

Use dashboard keys for https://v1.formula-1.api-sports.io (header x-apisports-key). RapidAPI host/key pairs are not supported in this integration. A Football-only Free plan may not authorize Formula-1 endpoints.

Treat the API key like a password. Regenerate it in the API-Sports dashboard if it is exposed.

Using with AI clients

  • Dedicated endpoint: POST /mcp/formula-1 with a Sanctum bearer token
  • Private gateway: one config for all integrations — use formula-1__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Example prompts

  • Show the current Formula 1 driver standings.
  • When is the next race weekend?
  • Who won the last race and what was the finishing order?
  • Show Max Verstappen's career profile.
  • List circuits in Italy.
  • What was the starting grid for race 1530?
  • Show constructor standings for the 2024 season.
  • List pit stops from the last Grand Prix.

Suggested workflow

  1. list_seasons / search_competitions — resolve season year and competition.
  2. search_races — calendar and session lookup (type may be Race, qualifying, Sprint, etc.).
  3. get_race — summary; use rankings/grid/fastest-laps/pit-stops tools for detail.
  4. get_driver_standings / get_constructor_standings — championship tables.
  5. search_drivers / search_teams / search_circuits — then get tools for profiles.

Caching and freshness

Approximate hub cache durations (per connection):

Data Cache
Competitions / seasons ~24 hours
Circuits / teams ~12 hours
Drivers ~6 hours
Race calendar ~10 minutes
Completed race summary ~24 hours
Standings ~10 minutes
Race results / grid / pits ~2 minutes

Authentication failures are never cached.

Rate limits

API-Sports Formula-1 plans have a daily request quota and a per-minute cap. Prefer cached tools and specific IDs. A 429 or provider “request limit” error means wait or upgrade your plan.

Data licensing notice

stackgate.ai provides access to data returned by the connected provider. Availability and permitted use depend on the provider’s terms and your subscription. Official Formula 1 branding, logos, and media may have separate rights restrictions. You are responsible for ensuring usage complies with the provider’s terms and applicable rights.

Troubleshooting

  • 422 integration not configured — add your API-Sports Formula-1 API key in My Integrations.
  • Connection test failed / invalid key — confirm the key from Account → My Access and that Formula-1 is on your plan (not a RapidAPI key).
  • 401 / authentication failed — regenerate the key and update My Integrations.
  • 429 / request limit — you hit the provider quota; wait, reduce tool calls, or upgrade your plan.
  • Empty items — no matching data for those filters/season, or your plan does not cover that season.
  • season required — standings and many race queries need a season year (YYYY).

Available tools

  • search_competitions

    Search Formula 1 competitions. Use when you need a competition_id.

  • list_seasons

    List available Formula 1 seasons (years). Optionally filter by competition_id.

  • search_circuits

    Search Formula 1 circuits by name, ID, or country. Requires at least one filter.

  • get_circuit

    Get a normalized circuit profile (length, laps, lap record, capacity).

  • search_teams

    Search Formula 1 constructors/teams. Requires at least one filter.

  • get_team

    Get a normalized constructor/team profile.

  • search_drivers

    Search Formula 1 drivers by name, ID, or team. Requires at least one filter.

  • get_driver

    Get a normalized driver profile (career stats, nationality, number).

  • search_races

    Search races/sessions by season, type, competition, circuit, date, next/last N, or race_id. Requires at least one filter.

  • get_race

    Get a single race/session summary. Use dedicated tools for rankings, grid, fastest laps, or pit stops.

  • get_race_rankings

    Race classification / finishing order for a race session.

  • get_starting_grid

    Starting grid for a race.

  • get_fastest_laps

    Fastest laps ranking for a race.

  • get_pit_stops

    Pit stops for a race.

  • get_driver_standings

    Drivers championship standings for a season.

  • get_constructor_standings

    Constructors championship standings for a season.

MCP endpoint: https://stackgate.ai/mcp/formula-1 (HTTP) or via the private gateway.

Create account Documentation