NHL MCP Server
by sanchorelaxo
- mcp-server-sandbox
- __pycache__
nhl_mcp_server.cpython-310.pyc•12.8 kB
o
�Rh
1 � @ s� d Z ddlmZ ddlmZmZmZmZ ddlZddl m
Z
eddd�Z e
� Z e j
d ed
ed ed eeef fd
d��Ze j
d ed eeef fdd��Ze j
d ed eeef fdd��Ze j
d eeef fdd��Ze j
dhdee dee d eeef fdd��Ze j
dhd
ed edee dee d eeef f
dd��Ze j
dhdee dee d eeef fdd ��Ze j
dhd
ed edee dee d eeef f
d d ��Ze j
d eeef fd d ��Ze j
d!ed eeef fd"d#��Ze j
d eeef fd$d%��Ze j
d&ed eeef fd'd(��Ze j
d&ed eeef fd)d*��Z e j
d&ed
ed ed eeef fd+d,��Z e j
d&ed eeef fd-d.��Z e j
did&ed
ee d eeef fd/d0��Z e j
did&ed
ee d eeef fd1d2��Z e j
d eeef fd3d4��Z!e j
d!ed eeef fd5d6��Z"e j
d eeef fd7d8��Z#e j
d!ed eeef fd9d:��Z$e j
d eeef fd;d<��Z%e j
d!ed eeef fd=d>��Z&e j
d eeef fd?d@��Z'e j
didAee d eeef fdBdC��Z(e j
dDed eeef fdEdF��Z)e j
dDed eeef fdGdH��Z*e j
dDed eeef fdIdJ��Z+e j
dDed eeef fdKdL��Z,e j
d!ed eeef fdMdN��Z-e j
d eeef fdOdP��Z.e j
d eeef fdQdR��Z/e j
did
ee d eeef fdSdT��Z0e j
did
ee d eeef fdUdV��Z1e j
d eeef fdWdX��Z2e j
didYee d eeef fdZd[��Z3e j
d eeef fd\d]��Z4e j
d^ed eeef fd_d`��Z5e j
did!ee d eeef fdadb��Z6e j
d ee fdcdd��Z7e j
d eeef fdedf��Z8e9dgk�r�e �:� dS dS )jz�
NHL MCP Server
A Model Context Protocol server for the NHL API using FastMCP.
Provides access to all NHL API endpoints through MCP tools.
� )�FastMCP)�Dict�Any�Optional�ListN)� NHLAPIClientzNHL-API-Servera
This server provides comprehensive access to the NHL API endpoints.
Available functionality includes:
- Player information and statistics
- Team standings, stats, rosters, and schedules
- Game information including scores, play-by-play, and boxscores
- League schedules and TV information
- Playoff brackets and information
- Draft and season information
Use the appropriate tools to access specific NHL data.
All data is returned in JSON format from the official NHL API.
)�name� instructions� player_id�season� game_type�returnc C � t �| ||�S )z�
Get game log for a specific player, season, and game type.
Args:
player_id: Player ID (e.g., 8478402)
season: Season in YYYYYYYY format (e.g., 20232024)
game_type: Game type (2 for regular season, 3 for playoffs)
)�
nhl_client�get_player_game_log)r
r r � r �6/home/rjodouin/Documents/git/nhl-mcp/nhl_mcp_server.pyr $ �
r c C �
t �| �S )zu
Get detailed information for a specific player.
Args:
player_id: Player ID (e.g., 8478402)
)r �get_player_info�r
r r r r 0 �
r c C r )zx
Get current season game log for a specific player.
Args:
player_id: Player ID (e.g., 8478402)
)r �get_player_game_log_nowr r r r r : r r c C � t �� S )z'Get players currently in the spotlight.)r �get_player_spotlightr r r r r D � r �
categories�limitc C � t �| |�S )z�
Get current skater stats leaders.
Args:
categories: Optional categories filter (e.g., 'goals', 'assists', 'points')
limit: Optional limit (-1 for all results, default varies)
)r � get_current_skater_stats_leaders�r r r r r r K � r c C � t �| |||�S )a\
Get skater stats leaders for a specific season and game type.
Args:
season: Season in YYYYYYYY format (e.g., 20232024)
game_type: Game type (2 for regular season, 3 for playoffs)
categories: Optional categories filter (e.g., 'goals', 'assists', 'points')
limit: Optional limit (-1 for all results)
)r �get_skater_stats_leaders�r r r r r r r r# V � r# c C r )z�
Get current goalie stats leaders.
Args:
categories: Optional categories filter (e.g., 'wins', 'saves', 'shutouts')
limit: Optional limit (-1 for all results)
)r � get_current_goalie_stats_leadersr r r r r& e r! r& c C r" )a[
Get goalie stats leaders for a specific season and game type.
Args:
season: Season in YYYYYYYY format (e.g., 20232024)
game_type: Game type (2 for regular season, 3 for playoffs)
categories: Optional categories filter (e.g., 'wins', 'saves', 'shutouts')
limit: Optional limit (-1 for all results)
)r �get_goalie_stats_leadersr$ r r r r' p r% r' c C r )zGet current NHL standings.)r �get_standings_nowr r r r r( r r( �datec C r )zx
Get standings for a specific date.
Args:
date: Date in YYYY-MM-DD format (e.g., '2023-11-10')
)r �get_standings_by_date�r) r r r r* � r r* c C r )z*Get standings information for each season.)r �get_standings_seasonr r r r r, � r r, �teamc C r )z�
Get current statistics for a specific team.
Args:
team: Three-letter team code (e.g., 'TOR', 'MTL', 'NYR')
)r �get_club_stats_now�r- r r r r. � r r. c C r )z�
Get stats overview for each season for a specific team.
Args:
team: Three-letter team code (e.g., 'TOR', 'MTL', 'NYR')
)r �get_club_stats_seasonr/ r r r r0 � r r0 c C r )a
Get stats for a specific team, season, and game type.
Args:
team: Three-letter team code (e.g., 'TOR', 'MTL', 'NYR')
season: Season in YYYYYYYY format (e.g., 20232024)
game_type: Game type (2 for regular season, 3 for playoffs)
)r �get_club_stats)r- r r r r r r1 � r r1 c C r )z�
Get current scoreboard for a specific team.
Args:
team: Three-letter team code (e.g., 'TOR', 'MTL', 'NYR')
)r �get_team_scoreboardr/ r r r r2 � r r2 c C r )z�
Get roster for a specific team.
Args:
team: Three-letter team code (e.g., 'TOR', 'MTL', 'NYR')
season: Optional season parameter (defaults to current)
)r �get_team_roster�r- r r r r r3 � r! r3 c C r )z�
Get schedule for a specific team.
Args:
team: Three-letter team code (e.g., 'TOR', 'MTL', 'NYR')
season: Optional season parameter (defaults to current)
)r �get_team_scheduler4 r r r r5 � r! r5 c C r )zGet current NHL schedule.)r �get_schedule_nowr r r r r6 � r r6 c C r )zw
Get schedule for a specific date.
Args:
date: Date in YYYY-MM-DD format (e.g., '2023-11-10')
)r �get_schedule_by_dater+ r r r r7 � r r7 c C r )z Get current schedule calendar.)r �get_schedule_calendar_nowr r r r r8 � r r8 c C r )z�
Get schedule calendar for a specific date.
Args:
date: Date in YYYY-MM-DD format (e.g., '2023-11-10')
)r � get_schedule_calendar_by_dater+ r r r r9 � r r9 c C r )zGet current daily scores.)r �get_daily_scores_nowr r r r r: � r r: c C r )z{
Get daily scores for a specific date.
Args:
date: Date in YYYY-MM-DD format (e.g., '2023-11-10')
)r �get_daily_scores_by_dater+ r r r r; � r r; c C r )z#Get current overall NHL scoreboard.)r �get_scoreboard_nowr r r r r< r r< �includec C r )z{
Get streaming and broadcast information.
Args:
include: Optional include parameter for filtering
)r �get_where_to_watch)r= r r r r> r r> �game_idc C r )zv
Get play-by-play information for a specific game.
Args:
game_id: Game ID (e.g., 2023020204)
)r �get_play_by_play�r? r r r r@ r r@ c C r )zv
Get landing page information for a specific game.
Args:
game_id: Game ID (e.g., 2023020204)
)r �get_game_landingrA r r r rB ! r rB c C r )zr
Get boxscore information for a specific game.
Args:
game_id: Game ID (e.g., 2023020204)
)r �get_game_boxscorerA r r r rC + r rC c C r )zt
Get game story information for a specific game.
Args:
game_id: Game ID (e.g., 2023020204)
)r �get_game_storyrA r r r rD 5 r rD c C r )zz
Get TV schedule for a specific date.
Args:
date: Date in YYYY-MM-DD format (e.g., '2023-11-10')
)r �get_tv_schedule_by_dater+ r r r rE A r rE c C r )zGet current TV schedule.)r �get_tv_schedule_nowr r r r rF K r rF c C r )z!Get playoff overview information.)r �get_playoff_overviewr r r r rG R r rG c C r )zw
Get playoff schedule.
Args:
season: Optional season in YYYYYYYY format (defaults to current)
)r �get_playoff_schedule�r r r r rH W r rH c C r )zv
Get playoff bracket.
Args:
season: Optional season in YYYYYYYY format (defaults to current)
)r �get_playoff_bracketrI r r r rJ a r rJ c C r )z Get current season information.)r �get_season_infor r r r rK m r rK �yearc C r )zk
Get draft information.
Args:
year: Optional draft year (defaults to most recent)
)r �get_draft_info)rL r r r rM r r rM c C r )z Get NHL API meta information.)r �
get_meta_infor r r r rN ~ r rN � postal_codec C r )z�
Get information for a postal code (likely for regional content).
Args:
postal_code: Postal code to lookup
)r �get_postal_lookup)rO r r r rP � r rP c C r )z|
Get game replay information.
Args:
date: Optional date in YYYY-MM-DD format (defaults to current)
)r �get_game_replaysr+ r r r rQ � r rQ c C s g d�S )z2Get a list of common NHL team codes for reference.)!�ANA�ARI�BOS�BUF�CGY�CAR�CHI�COL�CBJ�DAL�DET�EDM�FLA�LAK�MIN�MTL�NSH�NJD�NYI�NYR�OTT�PHI�PIT�SJS�SEA�STL�TBL�TOR�UTA�VAN�VGK�WSH�WPGr r r r r �get_team_codes� r rs c C s dddd�ddddd �d
�S ) z8Get help information about season format and game types.z{Seasons are in YYYYYYYY format where first 4 digits are start year, last 4 are end year (e.g., 20232024 for 2023-24 season)zRegular season gamesz
Playoff games)�2�3z7Dates should be in YYYY-MM-DD format (e.g., 2023-11-10)i�^� i{D� i�B� )zConnor McDavidz
Sidney CrosbyzAlexander Ovechkin)�
season_format�
game_types� date_format�example_player_idsr r r r r �get_season_format_help� s ���rz �__main__)NN)N);�__doc__�fastmcpr �typingr r r r �json�nhl_api_clientr �mcpr �tool�int�strr r r r r r# r& r' r( r* r, r. r0 r1 r2 r3 r5 r6 r7 r8 r9 r: r; r< r> r@ rB rC rD rE rF rG rH rJ rK rM rN rP rQ rs rz �__name__�runr r r r �<module> s� �$ *
2*
2 $ &
& " " " " "
�
Latest Blog Posts
- MCP Moves to the Linux Foundation: Neutral Stewardship for Agentic InfrastructureBy Om-Shree-0709 on .mcpanthropicLinux Foundation
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sanchorelaxo/mcp-server-sandbox'
If you have feedback or need assistance with the MCP directory API, please join our Discord server