nhl-mcp

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.