
The Blue Alliance
Connects Claude to The Blue Alliance API for querying FIRST Robotics Competition data going back to 1992. You get 35+ tools covering teams, events, matches, districts, and awards. Pull team profiles and participation history, grab event rankings and elimination brackets, or dig into match scores with alliance breakdowns. Includes zebra motion tracking data when available. Responses are validated with Zod schemas. You'll need a TBA API key from their site. Useful if you're analyzing FRC performance stats, building team scouting tools, or just need quick answers about competition results without hitting the API directly.
- GitHub stars
- 1
- tools
- 22
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Aug 7, 2026
Tools
22 toolsPublic tool metadata for what this MCP can expose to an agent.
get_teamGet detailed team profile.
Get detailed team profile.
No parameter schema in public metadata yet.
get_team_eventsGet a team's events in a year.
Get a team's events in a year.
No parameter schema in public metadata yet.
get_team_matches
No parameter schema in public metadata yet.
get_team_awardsGet a team's awards.
Get a team's awards.
No parameter schema in public metadata yet.
get_team_media
No parameter schema in public metadata yet.
get_eventGet event details.
Get event details.
No parameter schema in public metadata yet.
get_events
No parameter schema in public metadata yet.
get_event_teamsGet participating teams.
Get participating teams.
No parameter schema in public metadata yet.
get_event_rankingsGet rankings.
Get rankings.
No parameter schema in public metadata yet.
get_event_matches
No parameter schema in public metadata yet.
get_event_oprs
No parameter schema in public metadata yet.
get_event_alliancesGet elimination alliances.
Get elimination alliances.
No parameter schema in public metadata yet.
get_matchGet detailed match information.
Get detailed match information.
No parameter schema in public metadata yet.
get_match_simple
No parameter schema in public metadata yet.
get_match_zebraGet robot tracking data (if available).
Get robot tracking data (if available).
No parameter schema in public metadata yet.
get_districts
No parameter schema in public metadata yet.
get_district_rankings
No parameter schema in public metadata yet.
get_district_events
No parameter schema in public metadata yet.
get_district_teams
No parameter schema in public metadata yet.
get_teamsPaginated team listings.
Paginated team listings.
No parameter schema in public metadata yet.
get_teams_by_year
No parameter schema in public metadata yet.
get_statusAPI status information.
API status information.
No parameter schema in public metadata yet.
Sponsors
Configuration
TBA_API_KEY*secretThe Blue Alliance API key
Readme
The Blue Alliance MCP Server
A Model Context Protocol (MCP) server that provides access to The Blue Alliance API for FIRST Robotics Competition data. Enables AI assistants and other MCP clients to retrieve comprehensive FRC team, event, and match information.
Features
- Team Information: Get detailed team profiles, participation history, awards, and media
- Event Data: Access event details, rankings, matches, and elimination alliances
- Match Results: Retrieve match data with scores, alliances, and breakdowns
- Historical Data: Query data from 1992 to the current year
- Type Safety: All responses validated with Zod schemas
- Comprehensive Coverage: 35+ tools covering all major TBA API endpoints
Installation
npm (Recommended)
npm install -g @withinfocus/tba-mcp-server
Docker
Pull the image from GitHub Container Registry:
docker pull ghcr.io/withinfocus/tba-mcp-server:latest
Or build locally:
git clone https://github.com/withinfocus/tba-mcp-server.git
cd tba-mcp-server
docker build -t tba-mcp-server .
Configuration
Details
- Repository
- github.com/withinfocus/tba-mcp-server
- Website
- www.thebluealliance.com
- Package
@withinfocus/tba-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active