get_event_teams_simple
Retrieve simplified team information for a specific FIRST Robotics Competition event using the event key.
Instructions
Get simplified teams participating in an event
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event_key | Yes | Event key (e.g., 2023casj) |
Implementation Reference
- src/handlers.ts:774-786 (handler)The main handler logic for the 'get_event_teams_simple' tool. It validates the event_key input using Zod, makes an API request to The Blue Alliance (TBA) at `/event/${event_key}/teams/simple`, parses the response as an array of TeamSimpleSchema objects, and returns the JSON stringified data.case 'get_event_teams_simple': { const { event_key } = z.object({ event_key: EventKeySchema }).parse(args); const data = await makeApiRequest(`/event/${event_key}/teams/simple`); const teams = z.array(TeamSimpleSchema).parse(data); return { content: [ { type: 'text', text: JSON.stringify(teams, null, 2), }, ], }; }
- src/tools.ts:756-768 (registration)Tool registration in the exported tools array, including the name, description, and input schema definition for MCP tool listing.name: 'get_event_teams_simple', description: 'Get simplified teams participating in an event', inputSchema: { type: 'object', properties: { event_key: { type: 'string', description: 'Event key (e.g., 2023casj)', }, }, required: ['event_key'], }, },
- src/schemas.ts:369-377 (schema)Zod schema for simplified team data (TeamSimpleSchema), used to validate the output array from the TBA API 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:8-8 (schema)Zod schema for event key strings (EventKeySchema), used for input validation in the handler.export const EventKeySchema = z.string();