# Hyprace F1 Data MCP

> Hyprace F1 Data connects your AI agent to Formula 1 data. It gives you structured access to race results, driver and constructor standings, and historical F1 data dating back to 1950. You can list seasons, check upcoming schedules, retrieve specific qualifying or race outcomes, and pull deep career stats for any driver or team.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** formula-1, race-results, driver-standings, constructor-rankings, f1-history, motorsport-data, qualifying-results, circuit-data

## Description

Hyprace F1 Data links your AI client to Formula 1 history and current race data. You can pull structured info covering every season since 1950. When a race wraps up, the results are ready fast. You'll find tools to check driver stats, team info, and race outcomes.

**Get Driver Stats:** You use `get_driver` to get a specific driver's detailed profile. You can also run `list_drivers` to see every driver in the system. To see what a team is up to, you use `get_team` and `list_teams`. You can check out an engine builder's info with `list_engine_manufacturers`.

**Race Outcomes:** You use `get_race_results` to pull the official results from a full F1 race. You can check the qualifying session results with `get_qualifying_results`. You can't forget the Grand Prix event details; you use `get_grand_prix` for that. You'll also want to know which tracks exist; `list_circuits` gives you every Formula 1 venue. You can see what races are scheduled using `list_grands_prix` and get specific details for a season using `list_seasons`.

**Track Standings:** You use `get_standings` to get current or historical championship rankings for both drivers and constructors. You can see all available seasons by running `list_seasons`. To check the full calendar, you run `list_grands_prix`.

**The Deep Dive:** You can list every single Grand Prix event with `list_grands_prix`. You can also list every constructor with `list_teams` and every driver with `list_drivers`. You'll get the specific Grand Prix details you need using `get_grand_prix`.

## Tools

### get_driver
Gets detailed profile information for a specific Formula 1 driver.

### get_grand_prix
Gets detailed information for a specific Formula 1 Grand Prix event.

### get_qualifying_results
Retrieves the official results for an F1 qualifying session.

### get_race_results
Retrieves the official results for an F1 race session.

### get_standings
Retrieves the current or historical championship rankings for drivers and constructors.

### get_team
Gets detailed profile information for a specific F1 team/constructor.

### list_circuits
Lists every Formula 1 track and circuit available in the database.

### list_drivers
Lists all Formula 1 drivers in the system.

### list_engine_manufacturers
Lists all engine builders and power unit providers in F1.

### list_grands_prix
Lists all Formula 1 Grand Prix events and their schedules.

### list_seasons
Lists all available Formula 1 seasons, from 1950 to the present.

### list_teams
Lists all Formula 1 teams (constructors) available.

## Prompt Examples

**Prompt:** 
```
Show me the race results for the 2024 Monaco Grand Prix.
```

**Response:** 
```
Fetching the Monaco GP results... The winner was Charles Leclerc (Ferrari) with a dominant lights-to-flag victory, followed by Oscar Piastri (McLaren) in P2 and Carlos Sainz (Ferrari) in P3. Max Verstappen finished P6 after struggling with tyre degradation. Would you like to see the full classification or the qualifying grid?
```

**Prompt:** 
```
What are the current driver standings for the 2025 season?
```

**Response:** 
```
Here are the 2025 Driver Standings after Round 5: 1. Max Verstappen (Red Bull) — 110 pts, 2. Lando Norris (McLaren) — 98 pts, 3. Charles Leclerc (Ferrari) — 87 pts, 4. Oscar Piastri (McLaren) — 76 pts. The gap at the top is 12 points. Would you like to see the Constructor standings as well?
```

**Prompt:** 
```
Tell me about Ayrton Senna's career stats.
```

**Response:** 
```
Retrieving driver profile... Ayrton Senna (Brazil, 1960–1994): 3× World Champion (1988, 1990, 1991), 161 race starts, 41 victories, 80 podiums, 65 pole positions, and 19 fastest laps. He raced for Toleman, Lotus, McLaren, and Williams across 11 seasons. Would you like to see his season-by-season results or compare him with another legendary driver?
```

## Capabilities

### Get Driver Stats
Retrieves detailed career and current performance information for a specific F1 driver.

### List All Tracks
Provides a comprehensive list of every Formula 1 circuit and venue.

### Get Race Outcomes
Fetches detailed results for a specific Formula 1 race or qualifying session.

### Track Standings
Retrieves the current or historical championship rankings for both drivers and constructors.

### List Schedules
Browses the full F1 season calendar and lists upcoming Grand Prix events.

### Get Team Details
Accesses specific information about an F1 constructor or team.

## Use Cases

### Comparing legends over decades
A user wants to compare Senna's pole positions to Schumacher's. They ask their agent to pull stats for both. The agent uses `get_driver` multiple times, aggregating the pole positions and total victories from each profile to build a direct, quantifiable comparison that was previously difficult to source.

### Analyzing a specific race weekend
A reporter needs the full data set for the 2024 Monaco GP. They prompt the agent for 'race results and qualifying data.' The agent runs `get_race_results` and `get_qualifying_results` for that date, providing the full classification, gaps, and details in one response.

### Checking team longevity and changes
A fan wants to know which teams raced at a specific circuit. They first run `list_circuits` to find the venue, then use `get_grand_prix` to see the history for that location, and finally `get_team` to see which constructors participated.

### Verifying season context
A researcher needs to know the full scope of available data. They run `list_seasons` and `list_grands_prix`. This establishes the entire time and location boundary, allowing them to then accurately query `get_standings` for any period.

## Benefits

- You get immediate, structured access to race outcomes. Instead of visiting multiple websites to piece together who finished where, calling `get_race_results` gives you the full classification, including gaps and fastest laps.
- Track performance over time using `get_standings`. This tool shows both Driver and Constructor rankings, letting you see how the championship battle evolved round by round, not just the final tally.
- Get deep context on personnel and hardware. Use `get_driver` to pull a career summary—3x World Champion, 161 starts, etc.—or use `get_team` to see a constructor's specific history.
- Understand the venue. `list_circuits` gives you a master list of every track. You can then use `get_grand_prix` to get specific metadata about that location's history.
- Build a timeline of the sport. Use `list_seasons` first, then `list_grands_prix`, and finally `get_race_results` to map out the entire sport's history in a single conversation.
- Access engine lineage. `list_engine_manufacturers` lets you check the technical background of the sport, connecting power unit builders to the teams that run them.

## How It Works

The bottom line is, your agent uses the key to query structured F1 data, giving you precise stats without leaving your chat window.

1. Subscribe to the Hyprace F1 Data server and grab your RapidAPI Key.
2. Configure your AI client (Claude, Cursor, etc.) to use the server and provide the key.
3. Ask your agent a specific question, like 'What were the pole positions for the 2021 Italian Grand Prix?'

## Frequently Asked Questions

**How do I use the get_standings tool? **
The `get_standings` tool retrieves the current or historical championship rankings for both drivers and constructors. You must specify the relevant season and round to get accurate data.

**Can I get the results for a specific Grand Prix using get_race_results? **
Yes, `get_race_results` retrieves the official results for a specific race session. It provides detailed data including finishing positions, gaps, and fastest laps for that single event.

**How do I use get_driver to find career stats? **
Simply provide the driver's name to `get_driver`. It returns a comprehensive profile containing career statistics, total podiums, pole positions, and total race starts.

**What is the best way to find the history of F1 tracks? **
First, run `list_circuits` to get the list of tracks. Then, use `get_grand_prix` to fetch historical metadata and schedules for a specific venue.

**How do I use list_seasons to find available F1 data?**
Run list_seasons to get a list of all available F1 seasons, from 1950 to the present. This tells your agent exactly what historical data years it can query.

**If I need to know the best circuit for a specific race, how do I use list_circuits and get_grand_prix together?**
First, use list_circuits to get all track names. Then, pass that circuit name to get_grand_prix to pull the specific event details for that location.

**What if I run into an error when calling get_race_results?**
Check the required parameters (like season, round, and year). Errors usually mean the combination of date and race does not exist in the dataset.

**Can I use list_drivers to get information about a driver's specific team history?**
list_drivers provides a list of all drivers. For team history, you'll need to use the get_driver tool and look at the associated team names within the detailed profile.

**How quickly are race results available after a session ends?**
Results for active sessions — Practice, Qualifying, Sprint, and Race — are typically published within minutes of the chequered flag. Use the `get_race_results` or `get_qualifying_results` tools with the relevant season and Grand Prix to retrieve the latest classifications instantly.

**Can I compare driver performance across different decades of Formula 1?**
Absolutely. The Hyprace database covers every F1 season since the inaugural championship in 1950. Use `get_driver` to retrieve career statistics for any pilot — from Juan Manuel Fangio to Max Verstappen — and `get_standings` to compare how they ranked against their contemporaries in specific seasons.

**Is this integration read-only, or can it modify F1 data?**
All 12 tools are strictly read-only query operations against the Hyprace data archive. The integration cannot modify, create, or delete any records. Your RapidAPI key is used solely for authenticated data retrieval, ensuring complete safety of your API quota and account.