Statbotics MCP server

Statbotics MCP Server

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: getyear, getyears

Team Tools (2 tools)

Access team profiles and EPA ratings.

Tools: getteam, getteams

Team Year Tools (2 tools)

Get team statistics for specific seasons.

Tools: getteamyear, getteamyears

Event Tools (2 tools)

Query event details and predictions.

Tools: getevent, getevents

Team Event Tools (2 tools)

Get team performance at specific events.

Tools: getteamevent, getteamevents

Match Tools (2 tools)

Retrieve match data and predictions.

Tools: getmatch, getmatches

Team Match Tools (2 tools)

Get team-level match statistics.

Tools: getteammatch, getteammatches

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