Enables AI assistants to retrieve FIRST Robotics Competition statistical data, EPA ratings, event predictions, and match analytics.
Also known as withinfocus/statbotics-mcp-server, statbotics-mcp-server, @withinfocus/statbotics-mcp-server
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.2.0
- Last commit
- Nov 12, 2026
- License
- MIT
What is Statbotics MCP?
Statbotics enables AI assistants to retrieve FIRST Robotics Competition statistical data, EPA ratings, event predictions, and match analytics.
Summary generated from the project's README
About Statbotics MCP server
Analyzing FIRST Robotics Competition data through an AI assistant is what this server enables. It provides access to the Statbotics API, allowing users to retrieve EPA ratings, win rates, and historical performance metrics for FRC teams. Developers and robotics enthusiasts can use this to examine statistical trends dating back to 2002.
Users can set this up locally using npm or via Docker. Once configured in an MCP client like Claude Desktop, the server provides a variety of specialized tools for querying data. These include tools for teams, specific years, events, and individual matches. No API key is required to access the data, as the Statbotics API is freely available.
The server offers granular access through tools like get_team, get_event, and get_match. It also includes team-specific tools such as get_team_year and get_team_match to drill down into performance at specific events or during particular seasons. All responses are validated with Zod schemas to ensure data integrity.
What you can do with it
- 1Evaluate team performanceAsk the AI to retrieve the EPA ratings and historical win rates for a specific FRC team.
- 2Predict event outcomesRequest event details and predictions to understand how teams might perform at an upcoming competition.
- 3Analyze match statisticsHave the assistant pull match results and predictions for a specific match ID.
- 4Track seasonal trendsQuery statistical trends and team performance across different years from 2002 to the present.
Written from the project's README. Every use case is checked against a quote from it.
How to install Statbotics MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Statbotics MCP in Claude Code
$ claude mcp add statbotics-mcp-server -- npx -y @withinfocus/statbotics-mcp-serverInstall Statbotics MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"statbotics-mcp-server": {
"command": "npx",
"args": [
"-y",
"@withinfocus/statbotics-mcp-server"
]
}
}
}Install Statbotics MCP in VS Code
.vscode/mcp.json
{
"servers": {
"statbotics-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@withinfocus/statbotics-mcp-server"
]
}
}
}Install Statbotics MCP in VS Code CLI
$ code --add-mcp '{"name":"statbotics-mcp-server","type":"stdio","command":"npx","args":["-y","@withinfocus/statbotics-mcp-server"]}'Install Statbotics MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"statbotics-mcp-server": {
"command": "npx",
"args": [
"-y",
"@withinfocus/statbotics-mcp-server"
]
}
}
}Install Statbotics MCP in Codex
$ codex mcp add statbotics-mcp-server -- npx -y @withinfocus/statbotics-mcp-serverInstall Statbotics MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.statbotics-mcp-server] command = "npx" args = ["-y", "@withinfocus/statbotics-mcp-server"]
Install Statbotics MCP in Gemini CLI
$ gemini mcp add -s user statbotics-mcp-server npx -- -y @withinfocus/statbotics-mcp-serverInstall Statbotics MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"statbotics-mcp-server": {
"command": "npx",
"args": [
"-y",
"@withinfocus/statbotics-mcp-server"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablewithinfocus/statbotics-mcp-server is public and reachablegithub.com/withinfocus/statbotics-mcp-server ↗Pass
- Package names this repository as its source@withinfocus/statbotics-mcp-server names withinfocus/statbotics-mcp-server as sourcenpmjs.com/package/@withinfocus/statbotics-mcp-server ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @withinfocus/statbotics-mcp-servernpmjs.com/package/@withinfocus/statbotics-mcp-server/v/1.2.0 ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/withinfocus/statbotics-mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @withinfocus/statbotics-mcp-serverPass
- No critical advisory in the package or its dependencies143 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubStatbotics 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: 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
Statbotics MCP questions
How do I add Statbotics MCP to Claude Code?
Run claude mcp add statbotics-mcp-server -- npx -y @withinfocus/statbotics-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Statbotics MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What kind of team data can I retrieve?
You can access EPA ratings, win rates, historical performance, and team-specific statistics for various seasons.
How far back does the historical data go?
The server allows you to query statistical trends dating back to 2002.