get_event_awards
Read-onlyIdempotent
Get a complete list of awards for any FRC event, with details on each award's name, type, recipient team, and individual awardee. Use an event key to access results after the ceremony.
Instructions
List every award given out at a specific FRC event. Returns each award's name, type code, recipient team key, awardee name (for individual honors like Woodie Flowers Finalist or Dean's List), and year. Available once awards ceremony has concluded.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event_key | Yes | TBA event key combining the season year and event code (e.g., '2023casj' for the 2023 Silicon Valley Regional, '2024txhou' for the 2024 Houston Championship, '2024micmp4' for a Michigan State Championship division). Use get_events or get_events_keys to discover valid event keys for a year. |
Implementation Reference
- src/handlers.ts:360-372 (handler)Handler for 'get_event_awards' tool. Parses event_key from args, fetches /event/{event_key}/awards via API, validates with AwardSchema array, and returns JSON-stringified awards content.
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/schemas.ts:597-599 (schema)Input schema for get_event_awards: takes a single event_key string validated by EventKeySchema.
export const GetEventAwardsInputSchema = z.object({ event_key: EventKeySchema, }); - src/schemas.ts:159-170 (schema)AwardSchema - the Zod schema used to parse and validate each award object from the API response.
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/tools.ts:228-234 (registration)Tool registration entry for 'get_event_awards' with name, description, inputSchema (GetEventAwardsInputSchema), and annotations.
{ name: 'get_event_awards', description: "List every award given out at a specific FRC event. Returns each award's name, type code, recipient team key, awardee name (for individual honors like Woodie Flowers Finalist or Dean's List), and year. Available once awards ceremony has concluded.", inputSchema: toMCPSchema(GetEventAwardsInputSchema), annotations: { ...READ_ONLY_API, title: 'List Awards at an Event' }, },