bet-mcp

Instructions

Implementation Reference

• src/services/matchSnapshot.ts:4-35 (handler)

  Core handler function that fetches and assembles the match snapshot data including fixture, standings, team stats, and recent results for both teams.

  export const buildMatchSnapshot = async (matchId: number): Promise<MatchSnapshot> => {
    const fixture = await apiFootball.getFixture(matchId);
    if (!fixture) {
      throw new Error(`Fixture ${matchId} not found on API-Football`);
    }
  
    const standings = await apiFootball.getStandingsMap();
    const [homeStats, awayStats] = await Promise.all([
      apiFootball.getTeamStatistics(fixture.homeTeam.id),
      apiFootball.getTeamStatistics(fixture.awayTeam.id),
    ]);
  
    const [homeResults, awayResults] = await Promise.all([
      apiFootball.getRecentMatches(fixture.homeTeam.id),
      apiFootball.getRecentMatches(fixture.awayTeam.id),
    ]);
  
    const homeSnapshot = enrichTeamSnapshot(fixture.homeTeam.id, standings, homeStats, homeResults);
    const awaySnapshot = enrichTeamSnapshot(fixture.awayTeam.id, standings, awayStats, awayResults);
  
    return {
      match: fixture,
      home: {
        ...homeSnapshot,
        team: fixture.homeTeam,
      },
      away: {
        ...awaySnapshot,
        team: fixture.awayTeam,
      },
    };
  };

• src/tools/matchSnapshot.ts:5-17 (registration)

  Registers the 'match.snapshot' tool with FastMCP, including schema, description, and execute handler that delegates to buildMatchSnapshot.

  export const registerMatchSnapshotTool = (server: FastMCP) => {
    server.addTool({
      name: "match.snapshot",
      description: "Restituisce forma, classifica, gol fatti/subiti e ultimi risultati per il match richiesto.",
      parameters: z.object({
        match_id: z.number().int().describe("match_id fornito da API-Football"),
      }),
      execute: async (args) => {
        const snapshot = await buildMatchSnapshot(args.match_id);
        return JSON.stringify(snapshot, null, 2);
      },
    });
  };

• src/tools/matchSnapshot.ts:9-11 (schema)

  Zod schema defining the input parameter 'match_id' as integer.

  parameters: z.object({
    match_id: z.number().int().describe("match_id fornito da API-Football"),
  }),

• src/services/matchSnapshot.ts:37-52 (helper)

  Helper function to enrich team snapshot with league position, points, form, average goals, and recent results.

  const enrichTeamSnapshot = (
    teamId: number,
    standings: Map<number, { position: number; points: number; form?: string }>,
    stats: { avgGoalsFor: number; avgGoalsAgainst: number } | undefined,
    recentResults: TeamSnapshot["recentResults"],
  ): Omit<TeamSnapshot, "team"> => {
    const standing = standings.get(teamId);
    return {
      leaguePosition: standing?.position,
      points: standing?.points,
      form: standing?.form,
      avgGoalsFor: stats?.avgGoalsFor,
      avgGoalsAgainst: stats?.avgGoalsAgainst,
      recentResults,
    };
  };

• src/index.ts:17-17 (registration)

  Top-level call to register the match.snapshot tool in the main server setup.

  registerMatchSnapshotTool(server);