Statbotics

A Model Context Protocol (MCP) server that provides access to the Statbotics API for FIRST Robotics Competition statistical data and predictions. Enables AI assistants and other MCP clients to retrieve FRC team EPA ratings, event predictions, and match analytics.

Features

• Team Statistics: Get EPA ratings, win rates, and historical performance for FRC teams
• Event Data: Access event details, predictions, and team performance at events
• Match Analytics: Retrieve match predictions, results, and team-level match statistics
• Year-over-Year Data: Query statistical trends from 2002 to the current year
• Type Safety: All responses validated with Zod schemas
• No API Key Required: Statbotics API is freely accessible

Installation

npm (Recommended)

npm install -g @withinfocus/statbotics-mcp-server

Docker

Pull the image from GitHub Container Registry:

docker pull ghcr.io/withinfocus/statbotics-mcp-server:latest

Or build locally:

git clone https://github.com/withinfocus/statbotics-mcp-server.git
cd statbotics-mcp-server
docker build -t statbotics-mcp-server .

Usage

With npm

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "statbotics": {
      "command": "npx",
      "args": ["-y", "@withinfocus/statbotics-mcp-server"]
    }
  }
}

With Docker

Add to your MCP client configuration:

{
  "mcpServers": {
    "statbotics": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--init",
        "ghcr.io/withinfocus/statbotics-mcp-server:latest"
      ]
    }
  }
}

Available Tools

Year Tools (2 tools)

Query season-level statistical data.

Tools: get_year, get_years

Team Tools (2 tools)

Access team profiles and EPA ratings.

Tools: get_team, get_teams

Team Year Tools (2 tools)

Get team statistics for specific seasons.

Tools: get_team_year, get_team_years

Event Tools (2 tools)

Query event details and predictions.

Tools: get_event, get_events

Team Event Tools (2 tools)

Get team performance at specific events.

Tools: get_team_event, get_team_events

Match Tools (2 tools)

Retrieve match data and predictions.

Tools: get_match, get_matches

Team Match Tools (2 tools)

Get team-level match statistics.

Tools: get_team_match, get_team_matches

Quick Examples

Get team information

// Get team EPA ratings and statistics
get_team(team: 86)

// Get team's performance in a specific year
get_team_year(team: 86, year: 2024)

Analyze an event

// Get event statistics
get_event(event: "2024flor")

// Get all team performances at an event
get_team_events(event: "2024flor")

Get match data

// Get match predictions and results
get_match(match: "2024flor_qm20")

// Get team's performance in a match
get_team_match(team: 86, match: "2024flor_qm20")

Contributing

Contributions are welcome! See CONTRIBUTING.md for development setup, testing guidelines, and how to add new tools.

Related Links

• Statbotics - FRC statistical analysis
• Statbotics API Documentation - Official API docs
• Model Context Protocol - MCP specification
• FIRST Robotics Competition - Official FRC site