tba

Instructions

Implementation Reference

• src/handlers.ts:542-554 (handler)

  The main handler function for the 'get_team_simple' tool. It validates input using TeamKeySchema, calls the TBA API endpoint /team/{team_key}/simple, parses the response with TeamSimpleSchema, and returns the JSON-formatted team data.

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

• src/tools.ts:519-532 (registration)

  Tool registration object defining the 'get_team_simple' tool, including its name, description, and input schema for MCP tool listing and execution.

    name: 'get_team_simple',
    description: 'Get simplified information about a specific team',
    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:369-377 (schema)

  Zod schema (TeamSimpleSchema) for validating the output data from the TBA API /team/{team_key}/simple endpoint, used 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:4-6 (schema)

  Zod schema (TeamKeySchema) for validating the team_key input parameter, matching the tool's inputSchema pattern, used in the handler for args parsing.

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