get_team_simple
Retrieve simplified team information for FIRST Robotics Competition teams by providing a team key like frc86. This tool accesses The Blue Alliance API to deliver essential FRC team data.
Instructions
Get simplified information about a specific team
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team_key | Yes | Team key in format frcXXXX (e.g., frc86) |
Implementation Reference
- src/handlers.ts:542-554 (handler)The main handler function for the 'get_team_simple' tool. It validates input using TeamKeySchema, calls the TBA API endpoint /team/{team_key}/simple, parses the response with TeamSimpleSchema, and returns the JSON-formatted team data.case 'get_team_simple': { const { team_key } = z.object({ team_key: TeamKeySchema }).parse(args); const data = await makeApiRequest(`/team/${team_key}/simple`); const team = TeamSimpleSchema.parse(data); return { content: [ { type: 'text', text: JSON.stringify(team, null, 2), }, ], }; }
- src/tools.ts:519-532 (registration)Tool registration object defining the 'get_team_simple' tool, including its name, description, and input schema for MCP tool listing and execution.name: 'get_team_simple', description: 'Get simplified information about a specific team', inputSchema: { type: 'object', properties: { team_key: { type: 'string', description: 'Team key in format frcXXXX (e.g., frc86)', pattern: '^frc\\d+$', }, }, required: ['team_key'], }, },
- src/schemas.ts:369-377 (schema)Zod schema (TeamSimpleSchema) for validating the output data from the TBA API /team/{team_key}/simple endpoint, used in the handler.export const TeamSimpleSchema = z.object({ key: z.string(), team_number: z.number(), nickname: z.string().nullish(), name: z.string(), city: z.string().nullish(), state_prov: z.string().nullish(), country: z.string().nullish(), });
- src/schemas.ts:4-6 (schema)Zod schema (TeamKeySchema) for validating the team_key input parameter, matching the tool's inputSchema pattern, used in the handler for args parsing.export const TeamKeySchema = z .string() .regex(/^frc\d+$/, 'Team key must be in format frcXXXX');