get_event_awards
Retrieve award information for FIRST Robotics Competition events using event keys to access recognition data for teams and participants.
Instructions
Get awards from a specific event
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event_key | Yes | Event key (e.g., 2023casj) |
Implementation Reference
- src/handlers.ts:360-372 (handler)Handler case in handleToolCall that validates the event_key input, fetches awards data from TBA API `/event/{event_key}/awards`, parses with Zod, and returns formatted JSON response.case 'get_event_awards': { const { event_key } = z.object({ event_key: EventKeySchema }).parse(args); const data = await makeApiRequest(`/event/${event_key}/awards`); const awards = z.array(AwardSchema).parse(data); return { content: [ { type: 'text', text: JSON.stringify(awards, null, 2), }, ], }; }
- src/tools.ts:332-345 (registration)Tool registration in the exported tools array for MCP server, defining name, description, and input schema.{ name: 'get_event_awards', description: 'Get awards from a specific event', inputSchema: { type: 'object', properties: { event_key: { type: 'string', description: 'Event key (e.g., 2023casj)', }, }, required: ['event_key'], }, },
- src/schemas.ts:123-134 (schema)Zod schema for individual award objects returned by the TBA API, used to validate the response data.export const AwardSchema = z.object({ name: z.string(), award_type: z.number(), event_key: z.string(), recipient_list: z.array( z.object({ team_key: z.string().nullish(), awardee: z.string().nullish(), }), ), year: z.number(), });
- src/schemas.ts:8-9 (schema)Zod schema for event key input validation, used in the handler.export const EventKeySchema = z.string();