tba

Instructions

Implementation Reference

• src/handlers.ts:332-344 (handler)

  The handler logic for the 'get_match' tool. Parses input args, fetches match data from TBA API using makeApiRequest, validates with MatchSchema, and returns JSON stringified response.

  case 'get_match': {
    const { match_key } = z.object({ match_key: z.string() }).parse(args);
    const data = await makeApiRequest(`/match/${match_key}`);
    const match = MatchSchema.parse(data);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(match, null, 2),
        },
      ],
    };
  }

• src/tools.ts:304-317 (schema)

  Input schema definition for the 'get_match' tool, specifying the required 'match_key' parameter.

  {
    name: 'get_match',
    description: 'Get detailed information about a specific match',
    inputSchema: {
      type: 'object',
      properties: {
        match_key: {
          type: 'string',
          description: 'Match key (e.g., 2023casj_qm1)',
        },
      },
      required: ['match_key'],
    },
  },

• src/schemas.ts:87-121 (schema)

  Output validation schema (MatchSchema) used in the 'get_match' handler to parse the API response.

  export const MatchSchema = z.object({
    key: z.string(),
    comp_level: z.string(),
    set_number: z.number(),
    match_number: z.number(),
    alliances: z.object({
      red: z.object({
        score: z.number(),
        team_keys: z.array(z.string()),
        surrogate_team_keys: z.array(z.string()).nullish(),
        dq_team_keys: z.array(z.string()).nullish(),
      }),
      blue: z.object({
        score: z.number(),
        team_keys: z.array(z.string()),
        surrogate_team_keys: z.array(z.string()).nullish(),
        dq_team_keys: z.array(z.string()).nullish(),
      }),
    }),
    winning_alliance: z.string().nullish(),
    event_key: z.string(),
    time: z.number().nullish(),
    actual_time: z.number().nullish(),
    predicted_time: z.number().nullish(),
    post_result_time: z.number().nullish(),
    score_breakdown: z.record(z.string(), z.any()).nullish(),
    videos: z
      .array(
        z.object({
          type: z.string(),
          key: z.string(),
        }),
      )
      .nullish(),
  });

• src/index.ts:45-68 (registration)

  MCP server request handlers registration. ListTools returns the tools array (including 'get_match' schema). CallTool dispatches to handleToolCall based on tool name.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return { tools };
  });
  
  server.setRequestHandler(CallToolRequestSchema, async (request) => {
    const { name, arguments: args } = request.params;
    await log('debug', `Processing tool request: ${name}`, server);
  
    try {
      return await handleToolCall(name, args);
    } catch (error) {
      const errorMessage = `Tool execution error for '${name}': ${error instanceof Error ? error.message : String(error)}`;
      await log('error', errorMessage, server);
      return {
        content: [
          {
            type: 'text',
            text: `Error: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
        isError: true,
      };
    }
  });