get_team_robots
Read-onlyIdempotent
Retrieve a list of robots a team has built and named each year, including year and robot name. Use this to build historical team profiles.
Instructions
List the named robots a team has built and registered each year (e.g., 'Stronghold' for 2016, 'Citrus Circuits Quokka' patterns). Returns robot records with year, robot_name, robot key, and team key. Useful for retrospective profiles and historical references.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team_key | Yes | FRC team key formatted as 'frc' followed by the team number with no leading zeros (e.g., 'frc86', 'frc254', 'frc1114'). Uniquely identifies a FIRST Robotics Competition team on The Blue Alliance. |
Implementation Reference
- src/handlers.ts:249-261 (handler)Handler for the 'get_team_robots' tool. Parses args for team_key, makes an API request to /team/{team_key}/robots, validates the response as an array of RobotSchema, and returns the robot data as JSON text.
case 'get_team_robots': { const { team_key } = z.object({ team_key: TeamKeySchema }).parse(args); const data = await makeApiRequest(`/team/${team_key}/robots`); const robots = z.array(RobotSchema).parse(data); return { content: [ { type: 'text', text: JSON.stringify(robots, null, 2), }, ], }; } - src/schemas.ts:278-283 (schema)RobotSchema defines the shape of each robot record returned by the API: year (number), robot_name (string), key (string), and team_key (string).
export const RobotSchema = z.object({ year: z.number(), robot_name: z.string(), key: z.string(), team_key: z.string(), }); - src/schemas.ts:569-571 (schema)Input schema for get_team_robots: requires only a team_key parameter.
export const GetTeamRobotsInputSchema = z.object({ team_key: TeamKeySchema, }); - src/tools.ts:179-185 (registration)Registration of the get_team_robots tool in the tools array, with its name, description, input schema (converted via toMCPSchema), and read-only annotations.
{ name: 'get_team_robots', description: "List the named robots a team has built and registered each year (e.g., 'Stronghold' for 2016, 'Citrus Circuits Quokka' patterns). Returns robot records with year, robot_name, robot key, and team key. Useful for retrospective profiles and historical references.", inputSchema: toMCPSchema(GetTeamRobotsInputSchema), annotations: { ...READ_ONLY_API, title: 'Get Team Robot Names' }, },