The Blue Alliance MCP connector
Updated
The Blue Alliance is a comprehensive data platform for FIRST Robotics Competition events, teams, and matches. The Blue Alliance MCP connector allows AI agents to retrieve district, event, and team information, including rankings, rosters, and historical participation across seasons. It also supports accessing match results and event details, enabling deeper analysis of competition performance and scheduling.
Authentication type
- API Key - Requires a static API key to be configured before the agent can connect to the service.
Uses
Use the The Blue Alliance MCP connector to perform the following actions:
- Track team performance and rankings across multiple competition seasons
- Compare robot performance using calculated OPR, DPR, and CCWM metrics
- Monitor district standings to gauge playoff qualification progress
- Retrieve match schedules and results for upcoming competitions
- Analyze match predictions to anticipate competitive outcomes
- Identify award winners and recognitions from specific events
- Pull team rosters competing at a given event or district
- Surface elimination alliance selections for any event
Example prompts
Use the following example prompts to invoke The Blue Alliance MCP connector tools from your AI assistant or Boomi Connect workflow:
Show me all events happening in the 2024 season from The Blue Alliance.Which teams competed at the Houston district event in The Blue Alliance.Get the match schedule for the Central Valley Regional in The Blue Alliance.What are the current district rankings for the Pacific Northwest district?Pull the award winners from the Great Lakes district championship.Show me the OPR rankings for teams at the Newton Field event.List all elimination alliances formed at the World Championship.What teams are ranked in the Indiana district in The Blue Alliance?Find the match predictions for the Los Angeles regional.Show me every team that competed in the 2023 district events.
The Blue Alliance MCP connector tools
The The Blue Alliance MCP connector provides the following tools. Each tool maps to a specific action you can invoke from your AI agent or automation.
| Tool | Description |
|---|---|
| getDistrictEvents | Gets a list of events in the given district. |
| getDistrictEventsKeys | Gets a list of event keys for events in the given district. |
| getDistrictEventsSimple | Gets a short-form list of events in the given district. |
| getDistrictRankings | Gets a list of team district rankings for the given district. |
| getDistrictTeams | Gets a list of Team objects that competed in events in the given district. |
| getDistrictTeamsKeys | Gets a list of Team objects that competed in events in the given district. |
| getDistrictTeamsSimple | Gets a short-form list of Team objects that competed in events in the given district. |
| getDistrictsByYear | Gets a list of districts and their corresponding district key, for the given year. |
| getEvent | Gets an Event. |
| getEventAlliances | Gets a list of Elimination Alliances for the given Event. |
| getEventAwards | Gets a list of awards from the given event. |
| getEventDistrictPoints | Gets a list of team rankings for the Event. |
| getEventInsights | Gets a set of Event-specific insights for the given Event. |
| getEventMatches | Gets a list of matches for the given event. |
| getEventMatchesKeys | Gets a list of match keys for the given event. |
| getEventMatchesSimple | Gets a short-form list of matches for the given event. |
| getEventMatchTimeseries | Gets an array of Match Keys for the given event key that have timeseries data. |
| getEventOPRs | Gets a set of Event OPRs (including OPR, DPR, and CCWM) for the given Event. |
| getEventPredictions | Gets information on TBA-generated predictions for the given Event. |
| getEventRankings | Gets a list of team rankings for the Event. |
| getEventSimple | Gets a short-form Event. |
| getEventTeams | Gets a list of Team objects that competed in the given event. |
| getEventTeamsKeys | Gets a list of Team keys that competed in the given event. |
| getEventTeamsSimple | Gets a short-form list of Team objects that competed in the given event. |
| getEventTeamsStatuses | Gets a key-value list of the event statuses for teams competing at the given event. |
| getEventsByYear | Gets a list of events in the given year. |
| getEventsByYearKeys | Gets a list of event keys in the given year. |
| getEventsByYearSimple | Gets a short-form list of events in the given year. |
| getMatch | Gets a Match object for the given match key. |
| getMatchSimple | Gets a short-form Match object for the given match key. |
| getMatchTimeseries | Gets an array of game-specific Match Timeseries objects for the given match key or an empty array if not available. |
| getMatchZebra | Gets Zebra MotionWorks data for a Match for the given match key. |
| getStatus | Returns API status, and TBA status information. |
| getTeam | Gets a Team object for the team referenced by the given key. |
| getTeamAwards | Gets a list of awards the given team has won. |
| getTeamAwardsByYear | Gets a list of awards the given team has won in a given year. |
| getTeamDistricts | Gets an array of districts representing each year the team was in a district. |
| getTeamEventAwards | Gets a list of awards the given team won at the given event. |
| getTeamEventMatches | Gets a list of matches for the given team and event. |
| getTeamEventMatchesKeys | Gets a list of match keys for matches for the given team and event. |
| getTeamEventMatchesSimple | Gets a short-form list of matches for the given team and event. |
| getTeamEventStatus | Gets the competition rank and status of the team at the given event. |
| getTeamEvents | Gets a list of all events this team has competed at. |
| getTeamEventsKeys | Gets a list of the event keys for all events this team has competed at. |
| getTeamEventsSimple | Gets a short-form list of all events this team has competed at. |
| getTeamEventsByYear | Gets a list of events this team has competed at in the given year. |
| getTeamEventsByYearKeys | Gets a list of the event keys for events this team has competed at in the given year. |
| getTeamEventsByYearSimple | Gets a short-form list of events this team has competed at in the given year. |
| getTeamEventsStatusesByYear | Gets a key-value list of the event statuses for events this team has competed at in the given year. |
| getTeamMatchesByYear | Gets a list of matches for the given team and year. |
| getTeamMatchesByYearKeys | Gets a list of match keys for matches for the given team and year. |
| getTeamMatchesByYearSimple | Gets a short-form list of matches for the given team and year. |
| getTeamMediaByTag | Gets a list of Media (videos / pictures) for the given team and tag. |
| getTeamMediaByTagYear | Gets a list of Media (videos / pictures) for the given team, tag and year. |
| getTeamMediaByYear | Gets a list of Media (videos / pictures) for the given team and year. |
| getTeamRobots | Gets a list of year and robot name pairs for each year that a robot name was provided. |
| getTeamSimple | Gets a Team_Simple object for the team referenced by the given key. |
| getTeamSocialMedia | Gets a list of Media (social media) for the given team. |
| getTeamYearsParticipated | Gets a list of years in which the team participated in at least one competition. |
| getTeams | Gets a list of Team objects, paginated in groups of 500. |
| getTeamsKeys | Gets a list of Team keys, paginated in groups of 500. |
| getTeamsSimple | Gets a list of short form Team_Simple objects, paginated in groups of 500. |
| getTeamsByYear | Gets a list of Team objects that competed in the given year, paginated in groups of 500. |
| getTeamsByYearKeys | Gets a list Team Keys that competed in the given year, paginated in groups of 500. |
| getTeamsByYearSimple | Gets a list of short form Team_Simple objects that competed in the given year, paginated in groups of 500. |
