withinfocus avatar

The Blue Alliance

withinfocus/tba-mcp-server

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 tools

Public 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*secret

The 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


View the full README on GitHub

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

More from withinfocus