NHL MCP Server

Instructions

Implementation Reference

• src/index.ts:472-485 (handler)

  MCP tool handler for 'get_live_games' that fetches games via NHLAPIClient.getTodaysScores, handles empty case, formats output using formatGameScore, and returns as MCP content.

  case 'get_live_games': {
    const games = await client.getTodaysScores(parameters.date as string | undefined);
    if (games.length === 0) {
      return {
        content: [
          { type: 'text', text: 'No games scheduled for this date' },
        ],
      };
    }
    const formatted = games.map(formatGameScore).join('\n\n');
    return {
      content: [{ type: 'text', text: formatted }],
    };
  }

• src/index.ts:22-34 (schema)

  Tool schema definition in the TOOLS array, including name, description, and inputSchema for date parameter.

  {
    name: 'get_live_games',
    description: 'Get live NHL game scores and status for today or a specific date. Shows current scores, period, game state, and venue information.',
    inputSchema: {
      type: 'object',
      properties: {
        date: {
          type: 'string',
          description: 'Date in YYYY-MM-DD format (optional, defaults to today)',
        },
      },
    },
  },

• src/index.ts:460-462 (registration)

  Registration of the tool list handler that returns the TOOLS array containing 'get_live_games'.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return { tools: TOOLS };
  });

• src/nhl-api.ts:115-119 (helper)

  Core implementation in NHLAPIClient that fetches live game scores from NHL API for a given date.

  async getTodaysScores(date?: string): Promise<GameScore[]> {
    const dateStr = date || new Date().toISOString().split('T')[0];
    const data = await this.fetchJSON(`${NHL_API_BASE}/score/${dateStr}`);
    return data.games || [];
  }

• src/index.ts:216-227 (helper)

  Helper function to format individual game score information for display.

  function formatGameScore(game: GameScore): string {
    const status =
      game.gameState === 'LIVE' || game.gameState === 'CRIT'
        ? `LIVE - Period ${game.period}`
        : game.gameState === 'FUT'
        ? 'Scheduled'
        : game.gameState === 'FINAL' || game.gameState === 'OFF'
        ? 'Final'
        : game.gameState;
  
    return `${game.awayTeam.abbrev} ${game.awayTeam.score} @ ${game.homeTeam.abbrev} ${game.homeTeam.score} - ${status}\nVenue: ${game.venue}\nDate: ${game.gameDate}\nGame ID: ${game.id}`;
  }