tba

Instructions

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();