get_schedule
Retrieve NHL game schedules for upcoming matches, with options to filter by specific dates or teams using official league data.
Instructions
Get NHL schedule for upcoming games. Can get schedule for a specific date or team.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Date in YYYY-MM-DD format (optional, defaults to current week) | |
| teamAbbrev | No | Team abbreviation to get specific team schedule (e.g., TOR, NYR) |
Implementation Reference
- src/index.ts:551-566 (handler)The handler for the 'get_schedule' MCP tool. It checks if a teamAbbrev is provided; if so, fetches the team schedule using getTeamSchedule, otherwise fetches the general schedule using getSchedule. Returns the JSON-stringified schedule data.case 'get_schedule': { if (parameters.teamAbbrev) { const schedule = await client.getTeamSchedule( parameters.teamAbbrev as string, parameters.season as string | undefined ); return { content: [{ type: 'text', text: JSON.stringify(schedule, null, 2) }], }; } else { const schedule = await client.getSchedule(parameters.date as string | undefined); return { content: [{ type: 'text', text: JSON.stringify(schedule, null, 2) }], }; } }
- src/index.ts:129-141 (schema)Input schema definition for the 'get_schedule' tool, defining optional 'date' and 'teamAbbrev' parameters.inputSchema: { type: 'object', properties: { date: { type: 'string', description: 'Date in YYYY-MM-DD format (optional, defaults to current week)', }, teamAbbrev: { type: 'string', description: 'Team abbreviation to get specific team schedule (e.g., TOR, NYR)', }, }, },
- src/index.ts:126-142 (registration)Registration of the 'get_schedule' tool in the TOOLS array, which is returned by ListToolsRequestHandler. Includes name, description, and input schema.{ name: 'get_schedule', description: 'Get NHL schedule for upcoming games. Can get schedule for a specific date or team.', inputSchema: { type: 'object', properties: { date: { type: 'string', description: 'Date in YYYY-MM-DD format (optional, defaults to current week)', }, teamAbbrev: { type: 'string', description: 'Team abbreviation to get specific team schedule (e.g., TOR, NYR)', }, }, }, },
- src/nhl-api.ts:161-164 (helper)Core helper function getSchedule in NHLAPIClient that fetches the NHL schedule data from the official API for a given date (defaults to today). Called by the tool handler.async getSchedule(date?: string): Promise<any> { const dateStr = date || new Date().toISOString().split('T')[0]; return this.fetchJSON(`${NHL_API_BASE}/schedule/${dateStr}`); }
- src/nhl-api.ts:153-156 (helper)Supporting helper getTeamSchedule used by the get_schedule handler when teamAbbrev is provided. Fetches team-specific schedule from the NHL API.async getTeamSchedule(teamAbbrev: string, season?: string): Promise<any> { const seasonStr = season || this.getCurrentSeason(); return this.fetchJSON(`${NHL_API_BASE}/club-schedule-season/${teamAbbrev}/${seasonStr}`); }