bet-mcp

Instructions

Implementation Reference

• src/tools/fixtures.ts:12-22 (handler)

  The main handler function for the 'fixtures.list' tool. It calls the apiFootball client to get upcoming fixtures and returns a formatted JSON response.

  execute: async (args) => {
    const fixtures = await apiFootball.getUpcomingFixtures(args.days ?? 3);
    return JSON.stringify(
      {
        window_days: args.days ?? 3,
        fixtures,
      },
      null,
      2,
    );
  },

• src/clients/apiFootball.ts:74-89 (helper)

  Helper method in ApiFootballClient that fetches upcoming Serie A fixtures within the specified number of days using the API, maps the response, and returns FixtureSummary array.

  public async getUpcomingFixtures(days: number): Promise<FixtureSummary[]> {
    const now = new Date();
    const from = toIsoDate(now);
    const to = new Date(now);
    to.setDate(now.getDate() + days);
  
    const params = {
      league: config.apiFootball.leagueId,
      season: config.apiFootball.season,
      from: from,
      to: toIsoDate(to),
    };
  
    const data = await this.get<FixtureResponse>("/fixtures", params);
    return data.response.map(mapFixtureSummary);
  }

• src/tools/fixtures.ts:7-11 (schema)

  Tool schema including name, description, and Zod input parameter schema for 'days'.

  name: "fixtures.list",
  description: "Ritorna i prossimi match di Serie A entro X giorni (id, squadre, kickoff, venue).",
  parameters: z.object({
    days: z.number().int().min(1).max(10).default(3).describe("Numero di giorni in avanti da scandire"),
  }),

• src/tools/fixtures.ts:6-23 (registration)

  The server.addTool call that registers the 'fixtures.list' tool within the registerFixturesTool function.

  server.addTool({
    name: "fixtures.list",
    description: "Ritorna i prossimi match di Serie A entro X giorni (id, squadre, kickoff, venue).",
    parameters: z.object({
      days: z.number().int().min(1).max(10).default(3).describe("Numero di giorni in avanti da scandire"),
    }),
    execute: async (args) => {
      const fixtures = await apiFootball.getUpcomingFixtures(args.days ?? 3);
      return JSON.stringify(
        {
          window_days: args.days ?? 3,
          fixtures,
        },
        null,
        2,
      );
    },
  });

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

  Invocation of registerFixturesTool on the MCP server instance, effectively registering the tool.

  registerFixturesTool(server);