The Blue Alliance MCP Server provides programmatic access to FIRST Robotics Competition (FRC) data through The Blue Alliance API, enabling AI assistants to query comprehensive team, event, match, and historical information.
Capabilities:
Team Data: Retrieve detailed team profiles, participation history, awards, media, robots, social media, district affiliations, and event status for any FRC team (e.g., frc86)
Event Analysis: Access event details, participating teams, rankings, match schedules, elimination alliances, awards, OPR/DPR/CCWM analytics, predictions, insights, and district points for specific events (e.g., 2024casj)
Match Information: Get detailed match results including scores, alliances, breakdowns, and Zebra MotionWorks robot tracking data
District Operations: Access district listings, rankings, events, and teams for specific districts (e.g., 2023fim)
Historical Queries: Query data spanning 1992 to 2026 with year-specific filtering
Data Flexibility: Multiple formats available (detailed, simplified, keys-only) with pagination support for efficient browsing
API Monitoring: Check TBA API status and availability
Type Safety: All responses validated using Zod schemas for reliable data structures
Comprehensive Coverage: 35+ tools covering all major TBA API endpoints
Provides access to The Blue Alliance API for FIRST Robotics Competition data, enabling retrieval of comprehensive team profiles, event details, match results, rankings, awards, district information, and historical competition data from 1992 to present.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tbaget team 254's matches from the 2024 season"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
Docker
Pull the image from GitHub Container Registry:
Or build locally:
Configuration
Get an API key from The Blue Alliance
Set your API key as an environment variable:
Or create a .env file:
Usage
With npm
Add to your MCP client configuration (e.g., Claude Desktop):
With Docker
Add to your MCP client configuration:
Or run directly:
Available Tools
Team Information (24 tools)
Access comprehensive team data including profiles, participation history, events, matches, awards, and media.
Key tools: get_team, get_team_events, get_team_matches, get_team_awards, get_team_media
Event Information (19 tools)
Query event details, participants, rankings, matches, and analytics.
Key tools: get_event, get_events, get_event_teams, get_event_rankings, get_event_matches, get_event_oprs
Match Information (3 tools)
Retrieve detailed match data including scores, alliances, and robot tracking.
Key tools: get_match, get_match_simple, get_match_zebra
District Tools (8 tools)
Access district rankings, events, and team information.
Key tools: get_districts, get_district_rankings, get_district_events, get_district_teams
General/Utility Tools (6 tools)
Paginated team listings and API status information.
Key tools: get_teams, get_teams_by_year, get_status
Complete Documentation
All Tools - Complete reference for all 35+ tools with parameters and examples
Data Schemas - Detailed schema documentation for all response types
Quick Examples
Get team information
Analyze an event
Get match data
Contributing
Contributions are welcome! See CONTRIBUTING.md for development setup, testing guidelines, and how to add new tools.
Related Links
The Blue Alliance - Official FRC data source
TBA API Documentation - Official API docs
Model Context Protocol - MCP specification
FIRST Robotics Competition - Official FRC site