get_team_year
Read-onlyIdempotent
Retrieve a single FRC team's performance summary for a specific season, including EPA ratings, win record, events attended, district points, and awards.
Instructions
Get one team's performance summary for one specific FIRST Robotics Competition (FRC) season. Returns the team's EPA breakdown for that year (start, pre-playoffs, end, max, mean, ranks/percentiles), win/loss/tie record and win rate, count and list of events attended, district points, and award totals. Use this to answer "how did team 2056 do in 2023?", "what was team 254's peak EPA in 2018?", or "how many events did team 1114 attend in 2024?". Requires both team number (integer, no prefix) and a 4-digit year >= 2002. For multi-team or multi-year browsing, use get_team_years.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team | Yes | Team number (no prefix), e.g. 86 | |
| year | Yes | Four-digit year (2002 onwards) |
Implementation Reference
- src/handlers.ts:91-97 (handler)Handler logic for the 'get_team_year' tool. Parses team and year from input, then calls the Statbotics API at /v3/team_year/{team}/{year}.
case 'get_team_year': { const { team, year } = GetTeamYearInputSchema.parse(args); const data = await makeApiRequest(`/v3/team_year/${team}/${year}`); return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], }; } - src/schemas.ts:121-124 (schema)Zod input schema for GetTeamYearInputSchema - validates team (integer >= 1) and year (integer >= 2002).
export const GetTeamYearInputSchema = z.object({ team: TeamNumberSchema, year: YearSchema, }); - src/tools.ts:100-115 (registration)Registration of the 'get_team_year' tool in the tools array, including its name, description, annotations, and inputSchema.
{ name: 'get_team_year', description: "Get one team's performance summary for one specific FIRST Robotics Competition (FRC) season. " + "Returns the team's EPA breakdown for that year (start, pre-playoffs, end, max, mean, ranks/percentiles), " + 'win/loss/tie record and win rate, count and list of events attended, district points, and award totals. ' + 'Use this to answer "how did team 2056 do in 2023?", "what was team 254\'s peak EPA in 2018?", or ' + '"how many events did team 1114 attend in 2024?". ' + 'Requires both team number (integer, no prefix) and a 4-digit year >= 2002. ' + 'For multi-team or multi-year browsing, use get_team_years.', annotations: { title: 'Get FRC Team Season Stats (Single Team-Year)', ...readOnlyAnnotations, }, inputSchema: toMCPSchema(GetTeamYearInputSchema), },