NHL API - Model Context Protocol

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.

Overview

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.

📊 Current State

As of March 10, 2025, the platform provides the following functionality:

✅ Working Features

1. Standings

   • League-wide standings with division breakdowns
   • Complete team record information

2. Teams

   • Basic team identity information
   • Current roster information with player details
   • Team statistics (skaters and goalies)
   • Prospect tracking

3. Players

   • Player biographical information
   • Current season and career statistics
   • Award recognition

4. Schedules

   • Current team schedules
   • Date-specific league schedules
   • Upcoming game information

5. Statistics

   • Current statistical leaders (skaters and goalies)
   • Team-specific statistical breakdowns

6. Game Information

   • Live game scores and status
   • Game schedules

❌ Issues Identified

1. Team Information Gaps

   • Team division and conference information missing in team lookup
   • Basic team data incomplete (city/location details absent)

2. Game Details

   • Limited game state information for in-progress games
   • Play-by-play data implementation needs further testing

3. Historical Data

   • Seasonal historical data access needs verification
   • Historical schedule retrieval requires additional testing

4. UI Integration

   • No current UI components for data visualization
   • Raw data format requires transformation for frontend display

📝 TODO List

High Priority

• 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

Medium Priority

• Develop standard data visualization components
• Add player image integration
• Implement team logo/brand assets
• Create search functionality across all data types

Low Priority

• Build caching system for frequently accessed data
• Add fantasy hockey integration points
• Develop news/media integration
• Add social media content connections

🚀 Getting Started

1. Clone the repository:

   git clone https://github.com/yourusername/nhl-mcp.git
   cd nhl-mcp
   

2. Install dependencies:

   npm install
   

3. Configure API credentials:

   cp .env.example .env
   # Edit .env with your API keys
   

4. Start the development server:

   npm run dev
   

🔧 API Reference

The NHL-MCP platform provides the following core API endpoints:

Teams

• get-team: Retrieve basic team information
• get-team-roster: Get current team roster
• get-team-stats: Get team statistics
• get-team-prospects: Get team prospect information

Players

• get-player-landing: Get detailed player information

Standings

• get-current-standings: Get current NHL standings

Schedule

• get-schedule: Get general schedule information
• get-current-schedule: Get a team's upcoming schedule
• get-date-schedule: Get schedule for a specific date

Statistics

• get-current-stat-leaders: Get current statistical leaders
• get-current-goalie-leaders: Get current goalie statistical leaders

Games

• get-scores-now: Get current scores and game states

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📞 Contact

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.

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!