get_teams_by_year_keys
Read-onlyIdempotent
Retrieve paginated team keys for a specified FRC season year. Use this to build per-year team indices or drive downstream per-team data lookups.
Instructions
Paginated list of team keys that competed in a given FRC season year. Lightest variant; ideal for building per-year team indices or driving downstream per-team lookups.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | FRC competition season year. FRC began in 1992 and runs one game per year (e.g., 2023 = "Charged Up", 2024 = "Crescendo", 2025 = "Reefscape"). Must be between 1992 and next calendar year. | |
| page_num | Yes | Zero-indexed page number for paginated team listings. TBA returns up to 500 teams per page; increment until the response is empty to enumerate all teams. |
Implementation Reference
- src/handlers.ts:523-540 (handler)Handler for 'get_teams_by_year_keys' tool. Parses year and page_num from args, calls the API /teams/{year}/{page_num}/keys, and returns the list of team keys as JSON.
case 'get_teams_by_year_keys': { const { year, page_num } = z .object({ year: YearSchema, page_num: z.number().min(0), }) .parse(args); const data = await makeApiRequest(`/teams/${year}/${page_num}/keys`); const keys = z.array(z.string()).parse(data); return { content: [ { type: 'text', text: JSON.stringify(keys, null, 2), }, ], }; } - src/schemas.ts:640-643 (schema)Input schema for get_teams_by_year_keys: requires year (YearSchema) and page_num (PageNumSchema).
export const GetTeamsByYearKeysInputSchema = z.object({ year: YearSchema, page_num: PageNumSchema, }); - src/tools.ts:299-303 (registration)Registration of get_teams_by_year_keys tool with its name, description, input schema, and annotations.
name: 'get_teams_by_year_keys', description: 'Paginated list of team keys that competed in a given FRC season year. Lightest variant; ideal for building per-year team indices or driving downstream per-team lookups.', inputSchema: toMCPSchema(GetTeamsByYearKeysInputSchema), annotations: { ...READ_ONLY_API, title: 'List FRC Team Keys by Year' },