{
  "markdown": "# Statbotics MCP Server\n\nA 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.\n\n## Features\n\n- **Team Statistics**: Get EPA ratings, win rates, and historical performance for FRC teams\n- **Event Data**: Access event details, predictions, and team performance at events\n- **Match Analytics**: Retrieve match predictions, results, and team-level match statistics\n- **Year-over-Year Data**: Query statistical trends from 2002 to the current year\n- **Type Safety**: All responses validated with Zod schemas\n- **No API Key Required**: Statbotics API is freely accessible\n\n## Installation\n\n### npm (Recommended)\n\n```bash\nnpm install -g @withinfocus/statbotics-mcp-server\n```\n\n### Docker\n\nPull the image from GitHub Container Registry:\n\n```bash\ndocker pull ghcr.io/withinfocus/statbotics-mcp-server:latest\n```\n\nOr build locally:\n\n```bash\ngit clone https://github.com/withinfocus/statbotics-mcp-server.git\ncd statbotics-mcp-server\ndocker build -t statbotics-mcp-server .\n```\n\n## Usage\n\n### With npm\n\nAdd to your MCP client configuration (e.g., Claude Desktop):\n\n```json\n{\n  \"mcpServers\": {\n    \"statbotics\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@withinfocus/statbotics-mcp-server\"]\n    }\n  }\n}\n```\n\n### With Docker\n\nAdd to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"statbotics\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"--init\",\n        \"ghcr.io/withinfocus/statbotics-mcp-server:latest\"\n      ]\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Year Tools (2 tools)\n\nQuery season-level statistical data.\n\n**Tools**: `get_year`, `get_years`\n\n### Team Tools (2 tools)\n\nAccess team profiles and EPA ratings.\n\n**Tools**: `get_team`, `get_teams`\n\n### Team Year Tools (2 tools)\n\nGet team statistics for specific seasons.\n\n**Tools**: `get_team_year`, `get_team_years`\n\n### Event Tools (2 tools)\n\nQuery event details and predictions.\n\n**Tools**: `get_event`, `get_events`\n\n### Team Event Tools (2 tools)\n\nGet team performance at specific events.\n\n**Tools**: `get_team_event`, `get_team_events`\n\n### Match Tools (2 tools)\n\nRetrieve match data and predictions.\n\n**Tools**: `get_match`, `get_matches`\n\n### Team Match Tools (2 tools)\n\nGet team-level match statistics.\n\n**Tools**: `get_team_match`, `get_team_matches`\n\n## Quick Examples\n\n### Get team information\n\n```typescript\n// Get team EPA ratings and statistics\nget_team(team: 86)\n\n// Get team's performance in a specific year\nget_team_year(team: 86, year: 2024)\n```\n\n### Analyze an event\n\n```typescript\n// Get event statistics\nget_event(event: \"2024flor\")\n\n// Get all team performances at an event\nget_team_events(event: \"2024flor\")\n```\n\n### Get match data\n\n```typescript\n// Get match predictions and results\nget_match(match: \"2024flor_qm20\")\n\n// Get team's performance in a match\nget_team_match(team: 86, match: \"2024flor_qm20\")\n```\n\n## Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing guidelines, and how to add new tools.\n\n## Related Links\n\n- [Statbotics](https://statbotics.io/) - FRC statistical analysis\n- [Statbotics API Documentation](https://api.statbotics.io/docs) - Official API docs\n- [Model Context Protocol](https://modelcontextprotocol.io/) - MCP specification\n- [FIRST Robotics Competition](https://www.firstinspires.org/robotics/frc) - Official FRC site\n",
  "bytes": 3561,
  "sha": "d72df7d3cecd2b75cd4127542e3e74f40ea66b0f1ee02bf40e9e91f9eefd1b14",
  "repo_slug": "withinfocus/statbotics-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_withinfocus_statbotics_8a04f0a0/readme"
}