A TypeScript implementation of the NHL API using the Model-Context Protocol pattern. This MCP server provides access to NHL data including teams, players, standings, schedules, and statistics.
This library provides a clean interface to the NHL's official APIs using the Model-Context Protocol (MCP). It allows you to fetch data from the NHL's APIs and provides it in a structured, easy-to-use format through MCP tools.
As of March 10, 2025, the platform provides the following functionality:
-
Standings
- League-wide standings with division breakdowns
- Complete team record information
-
Teams
- Basic team identity information
- Current roster information with player details
- Team statistics (skaters and goalies)
- Prospect tracking
-
Players
- Player biographical information
- Current season and career statistics
- Award recognition
-
Schedules
- Current team schedules
- Date-specific league schedules
- Upcoming game information
-
Statistics
- Current statistical leaders (skaters and goalies)
- Team-specific statistical breakdowns
-
Game Information
- Live game scores and status
- Game schedules
-
Team Information Gaps
- Team division and conference information missing in team lookup
- Basic team data incomplete (city/location details absent)
-
Game Details
- Limited game state information for in-progress games
- Play-by-play data implementation needs further testing
-
Historical Data
- Seasonal historical data access needs verification
- Historical schedule retrieval requires additional testing
-
UI Integration
- No current UI components for data visualization
- Raw data format requires transformation for frontend display
- Fix team information API to include complete team details (division, conference, location)
- Implement more detailed game state tracking for live games
- Create data transformation layers for UI integration
- Complete testing of historical data endpoints
- Develop standard data visualization components
- Add player image integration
- Implement team logo/brand assets
- Create search functionality across all data types
- Build caching system for frequently accessed data
- Add fantasy hockey integration points
- Develop news/media integration
- Add social media content connections
-
Clone the repository:
git clone https://github.com/yourusername/nhl-mcp.git cd nhl-mcp -
Install dependencies:
npm install -
Configure API credentials:
cp .env.example .env # Edit .env with your API keys -
Start the development server:
npm run dev
The NHL-MCP platform provides the following core API endpoints:
get-team: Retrieve basic team informationget-team-roster: Get current team rosterget-team-stats: Get team statisticsget-team-prospects: Get team prospect information
get-player-landing: Get detailed player information
get-current-standings: Get current NHL standings
get-schedule: Get general schedule informationget-current-schedule: Get a team's upcoming scheduleget-date-schedule: Get schedule for a specific date
get-current-stat-leaders: Get current statistical leadersget-current-goalie-leaders: Get current goalie statistical leaders
get-scores-now: Get current scores and game states
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Project Maintainer: Dylan Groos
Note: This README documents the current state of the NHL-MCP project based on testing conducted on March 10, 2025. The platform accesses NHL data which is subject to terms and conditions set by the National Hockey League.