get_team_events_all

Retrieve comprehensive event history for any FRC team across all competition years using team key format frcXXXX.

Instructions

Get all events a team has participated in across all years

Input Schema

TableJSON Schema

Name	Required	Description	Default
`team_key`	Yes	Team key in format frcXXXX (e.g., frc86)

Implementation Reference

src/handlers.ts:388-400 (handler)

Executes the tool: validates team_key input, calls TBA API /team/{team_key}/events, parses events array, returns JSON.

case 'get_team_events_all': {
  const { team_key } = z.object({ team_key: TeamKeySchema }).parse(args);
  const data = await makeApiRequest(`/team/${team_key}/events`);
  const events = z.array(EventSchema).parse(data);
  return {
    content: [
      {
        type: 'text',
        text: JSON.stringify(events, null, 2),
      },
    ],
  };
}

src/tools.ts:361-375 (registration)

Defines the MCP tool object with name, description, and input JSON schema; added to tools export used by server.

{
  name: 'get_team_events_all',
  description: 'Get all events a team has participated in across all years',
  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:4-6 (schema)

Zod schema for validating team_key input parameter.

export const TeamKeySchema = z
  .string()
  .regex(/^frc\d+$/, 'Team key must be in format frcXXXX');

src/schemas.ts:38-85 (schema)

Zod schema for parsing TBA Event API responses.

export const EventSchema = z.object({
  key: z.string(),
  name: z.string(),
  event_code: z.string(),
  event_type: z.number(),
  district: z
    .object({
      abbreviation: z.string(),
      display_name: z.string(),
      key: z.string(),
      year: z.number(),
    })
    .nullish(),
  city: z.string().nullish(),
  state_prov: z.string().nullish(),
  country: z.string().nullish(),
  start_date: z.string(),
  end_date: z.string(),
  year: z.number(),
  short_name: z.string().nullish(),
  event_type_string: z.string(),
  week: z.number().nullish(),
  address: z.string().nullish(),
  postal_code: z.string().nullish(),
  gmaps_place_id: z.string().nullish(),
  gmaps_url: z.string().nullish(),
  lat: z.number().nullish(),
  lng: z.number().nullish(),
  location_name: z.string().nullish(),
  timezone: z.string().nullish(),
  website: z.string().nullish(),
  first_event_id: z.string().nullish(),
  first_event_code: z.string().nullish(),
  webcasts: z
    .array(
      z.object({
        type: z.string(),
        channel: z.string(),
        date: z.string().nullish(),
        file: z.string().nullish(),
      }),
    )
    .nullish(),
  division_keys: z.array(z.string()).nullish(),
  parent_event_key: z.string().nullish(),
  playoff_type: z.number().nullish(),
  playoff_type_string: z.string().nullish(),
});

tba