Integration

The Blue Alliance integration

The Blue Alliance (TBA) is the community database of the FIRST Robotics Competition (FRC). Read teams, events, matches with scores and score breakdowns, qualification rankings, alliances, awards, district and regional championship points, OPR and predictions, team media and robot names, and TBA statistical insights, by season year, event, district or team. Read only: the write API, webhooks, the frontend search index, key-only and simple list variants, and unofficial match timeseries are not included. Authentication is a free Read API key from the TBA account page, sent in the X-TBA-Auth-Key header.

Connect The Blue Alliance How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in The Blue Alliance.Built from the 59 The Blue Alliance tools below, on the connection you add once.

What you can do with The Blue Alliance

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Award, 5 operations

list_district_awardsList district awardsGETGets a list of awards in the given district.
list_event_awardsList event awardsGETGets a list of awards from the given event.
list_team_awardsList team awardsGETGets a list of awards the given team has won.
list_team_awards_by_yearList team awards by yearGETGets a list of awards the given team has won in a given year.
list_team_event_awardsList team event awardsGETGets a list of awards the given team won at the given event.

Event, 5 operations

get_eventGet eventGETGets one FRC event by its event key: name, event type, dates, location, district, week, playoff type and webcasts.
list_district_eventsList district eventsGETGets a list of events in the given district.
list_events_by_yearList events by yearGETGets a list of events in the given year.
list_team_eventsList team eventsGETGets a list of all events this team has competed at.
list_team_events_by_yearList team events by yearGETGets a list of events this team has competed at in the given year.

Team, 5 operations

get_teamGet teamGETGets one FRC team by its team key: team number, nickname, official long name, school, city, country, rookie year, website and motto.
list_district_teamsList district teamsGETLists the teams that competed in events of the given district, with team number, nickname, location and rookie year for each.
list_event_teamsList event teamsGETLists the teams that competed in the given event, with team number, nickname, location and rookie year for each.
list_teamsList teamsGETLists FRC teams by team-number range, 500 numbers per page: page_num 0 holds teams 0 to 499, page 1 holds 500 to 999, and so on. get_status returns the highest page number (max_team_page).
list_teams_by_yearList teams by yearGETLists the teams that competed in the given year, by team-number range: page_num 0 holds teams 0 to 499, page 1 holds 500 to 999, and so on. A page can be empty while later pages are not.

District, 4 operations

list_district_insights_by_categoryList district insights by categoryGETLists TBA statistical insights for a year scoped to one district and one category: leaderboard, streak, timeseries, game_stats or clubs. Use year 0 for all-time insights.
list_district_insights_by_yearList district insights by yearGETLists TBA statistical insights for a year scoped to one district, across all categories. Use year 0 for all-time insights.
list_districts_by_yearList districts by yearGETGets a list of districts and their corresponding district key, for the given year.
list_team_districtsList team districtsGETGets an array of districts representing each year the team was in a district. Will return an empty array if the team was never in a district.

Insight, 4 operations

get_district_insightsGet district insightsGETGets insights for a district: region and district-wide yearly counts (active teams, events, teams gained and lost) and per-team data.
get_event_insightsGet event insightsGETGets event-specific statistical insights for the event, for qualification and playoff matches separately, in a year-specific shape.
list_insights_by_categoryList insights by categoryGETLists TBA statistical insights for a year in one category: leaderboard, streak, timeseries, game_stats or clubs. Global scope only; use year 0 for all-time insights.
list_insights_by_yearList insights by yearGETLists TBA statistical insights (leaderboards, streaks, timeseries, game stats, clubs) for a year across all categories, global scope only. Use year 0 for all-time insights.

Matche, 3 operations

list_event_matchesList event matchesGETGets a list of matches for the given event.
list_team_event_matchesList team event matchesGETGets a list of matches for the given team and event.
list_team_matches_by_yearList team matches by yearGETGets a list of matches for the given team and year.

Ranking, 3 operations

get_event_rankingsGet event rankingsGETGets a list of team rankings for the Event.
list_district_rankingsList district rankingsGETGets a list of team district rankings for the given district.
list_regional_pool_rankingsList regional pool rankingsGETGets the team rankings in the regional pool for a specific year.

History, 2 operations

get_team_historyGet team historyGETGets the history for the team referenced by the given key, including their events and awards.
list_district_historyList district historyGETGets a list of District objects with the given district abbreviation. This accounts for district abbreviation changes, such as MAR to FMA.

Media, 2 operations

list_event_mediaList event mediaGETGets a list of media objects associated with this event itself (e.g. SmugMug photo galleries and event videos), as opposed to media belonging to the event's teams.
list_team_media_by_yearList team media by yearGETGets a list of Media (videos / pictures) for the given team and year.

Statu, 2 operations

get_statusGet statusGETReturns TBA status: the current and maximum season, the highest team page number, whether the official data feed is down, events whose feed is down, and app version info.
get_team_event_statusGet team event statusGETGets the competition rank and status of the team at the given event.

Statuse, 2 operations

get_event_team_statusesGet event team statusesGETGets the status of every team at the event (qualification rank and record, alliance, playoff result, summary strings), as an object keyed by team key.
get_team_event_statuses_by_yearGet team event statuses by yearGETGets the team's status at each event it competed at in the given year (rank, alliance, playoff result, summary strings), as an object keyed by event key.

Tag, 2 operations

list_team_media_by_tagList team media by tagGETGets a list of Media (videos / pictures) for the given team and tag.
list_team_media_by_tag_and_yearList team media by tag and yearGETGets a list of Media (videos / pictures) for the given team, tag and year.

Advancement, 1 operation

get_district_advancementGet district advancementGETGets per-team advancement information and the advancement cutoffs for a district.

Advancement point, 1 operation

get_event_advancement_pointsGet event advancement pointsGETDepending on the type of event (district/regional), this will return either district points or regional CMP points

Alliance, 1 operation

list_event_alliancesList event alliancesGETGets a list of Elimination Alliances for the given Event.

Copr, 1 operation

get_event_coprsGet event coprsGETGets the event's component OPRs: for each scoring component of that year's game, each team's calculated contribution, as an object keyed by component name then team key.

Dcmp history, 1 operation

list_district_championship_historyList district championship historyGETGets a list of DCMP events and awards for the given district abbreviation.

District point, 1 operation

get_event_district_pointsGet event district pointsGETGets the district points each team earned at the event, with tiebreakers. TBA calculates them for every event whatever its type, and notes they may or may not be useful.

Leaderboard, 1 operation

list_leaderboard_insightsList leaderboard insightsGETLists the leaderboard insights for a year, each with its ranked values (for example number of blue banners or of matches played) and the team, event or match keys holding them. Use year 0 for overall leaderboards.

Match, 1 operation

get_matchGet matchGETGets one match by its match key: competition level, set and match number, both alliances with their team keys and scores, the winner, times, videos and the year-specific score breakdown.

Nexus info, 1 operation

get_event_nexus_queueGet event nexus queueGETGets live match-queuing info for an event from Nexus (https://frc.nexus/), or `null` if no data is currently available for this event.

Notable, 1 operation

list_notable_insightsList notable insightsGETLists the notable insights for a year, each with the teams that achieved it and the events where they did. Use year 0 for overall notables.

Opr, 1 operation

get_event_oprsGet event oprsGETGets the event's OPR (offensive power rating), DPR (defensive power rating) and CCWM (calculated contribution to winning margin) for each team, keyed by team key.

Playoff advancement, 1 operation

list_event_playoff_advancementList event playoff advancementGETGets a list of playoff advancement levels for the given Event.

Practice, 1 operation

list_event_practice_matchesList event practice matchesGETGets a list of practice matches for the given event.

Prediction, 1 operation

get_event_predictionsGet event predictionsGETGets TBA-generated match and ranking predictions for the event, in a year-specific shape. TBA marks this data as under development and subject to change at any time.

Regional advancement, 1 operation

get_regional_championship_advancementGet regional championship advancementGETGets per-team advancement to the FIRST Championship for a season, as an object keyed by team key: whether the team qualified, how, at which event and in which regional pool week.

Regional champs pool point, 1 operation

get_event_regional_pool_pointsGet event regional pool pointsGETFor 2025+ Regional events, this will return points towards the Championship qualification pool.

Robot, 1 operation

list_team_robotsList team robotsGETGets a list of year and robot name pairs for each year that a robot name was provided. Will return an empty array if the team has never named a robot.

Social media, 1 operation

list_team_social_mediaList team social mediaGETGets a list of Media (social media) for the given team.

Team media, 1 operation

list_event_team_mediaList event team mediaGETGets a list of media objects that correspond to teams at this event.

Zebra motionwork, 1 operation

get_match_zebra_motionworksGet match zebra motionworksGETGets Zebra MotionWorks robot tracking data for a match: sample timestamps and, per alliance, each team's x and y positions on the field.

Use The Blue Alliance from Claude Code, Cursor or Codex

Connect The Blue Alliance in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its The Blue Alliance operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect The Blue Alliance

Create your workspace
Sign up free. Nothing to install.
Connect The Blue Alliance once
Add your The Blue Alliance connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.