nhl-api-mcp

sam-parsons/nhl-api-mcp

3.1

If you are the rightful owner of nhl-api-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The NHL API MCP Server provides comprehensive access to NHL statistics and data through a FastMCP-based interface.

Tools
3
Resources
0
Prompts
0

🏒 NHL API MCP Server

CI Docker Hub Docker Image Size

A Model Context Protocol (MCP) server that provides comprehensive access to NHL statistics, game data, and hockey analytics through a FastMCP-based interface.

🏒 Overview

This MCP server acts as a bridge between AI applications and NHL data sources, enabling seamless integration of hockey statistics, team information, player data, game schedules, and performance analytics into AI workflows and applications.

✨ Features

🏒 NHL Data Access

  • Team Information: Complete team rosters, prospects, and franchise details across all NHL teams
  • Game Schedules: Daily, weekly, monthly, and season-long schedules for teams and leagues
  • Player Statistics: Comprehensive career stats, game logs, and performance metrics
  • Standings & Rankings: Current and historical league standings with flexible filtering
  • Playoff Data: Tournament brackets, series schedules, and championship history

🔧 MCP Tools

All NHL/statistics/game/player/team/etc. functionality is exposed as MCP tools, not as RESTful HTTP endpoints. These tools are accessible via the /mcp/ endpoint using the MCP protocol. For a list of available tools and their descriptions, visit /tools/ when the server is running.

Key MCP Tools
  • get_nhl_player_career_stats - Comprehensive player career statistics
  • get_nhl_player_game_log - Game-by-game performance data
  • get_nhl_goalie_stats_summary - Goalie performance metrics

For the full list and detailed descriptions, see /tools/ or /docs when the server is running.

🌐 HTTP Endpoints

The following HTTP endpoints are available:

  • / - Redirects to /docs
  • /docs - Interactive API documentation and tool listing
  • /health/ - Health check endpoint
  • /mcp/info - MCP server information
  • /tools/ - List of all available MCP tools
  • /mcp/ (POST) - MCP protocol endpoint for MCP-compatible clients

📦 Installation

Local Installation

  1. Clone the repository:
git clone https://github.com/sam-parsons/nhl-api-mcp.git
cd nhl-api-mcp
  1. Create and activate a virtual environment:
uv venv
source .venv/bin/activate
  1. Install dependencies:
uv pip install -e .

Docker Installation

  1. Clone the repository:
git clone https://github.com/sam-parsons/nhl-api-mcp.git
cd nhl-api-mcp
  1. Build the Docker image:
docker build -t nhl-api-mcp .
  1. Run the container (default timezone is UTC, uses Python 3.12):
docker run -p 8000:8000 nhl-api-mcp

🤝 Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

📄 License

This project is open source. Please check the license file for details.