MCP tools

Each tool calls one endpoint with your key. Ids carry their type, as in the API.

find_games

Find ice hockey games by date, date range, league, season or team, with scores, how each game ended, venue and attendance. With no filters it gives today's games.

• Calls GET /v1/games
• Takes date, from, to, league_id, season_id, team_id, status, stage, order, and per_page
• Plan: every plan, the free key included

get_game

One game in full by its game id (gm_...), with its odds on paid plans.

• Calls GET /v1/games/{game_id}
• Takes game_id (required)
• Plan: every plan, the free key included

game_odds

Odds for one game by its game id (gm_...): three-way, moneyline, puck line and totals, with opening, closing and average prices.

• Calls GET /v1/games/{game_id}/odds
• Takes game_id (required)
• Plan: Live and up

yesterdays_results

Every finished game from yesterday (UTC), optionally for one league.

• Calls GET /v1/results/yesterday
• Takes league_id, and per_page
• Plan: every plan, the free key included

find_leagues

Find leagues and competitions by country, kind, gender, age group or part of the name. Gives each league's id (lg_...).

• Calls GET /v1/leagues
• Takes country, kind, gender, age, q, and per_page
• Plan: every plan, the free key included

league_seasons

Every season of one league, newest first, with first and last game dates and the number of games. Gives each season's id (ss_...).

• Calls GET /v1/leagues/{league_id}/seasons
• Takes league_id (required), and per_page
• Plan: every plan, the free key included

find_teams

Find teams by part of the name, country, or the league or season they played in. Gives each team's id (tm_...).

• Calls GET /v1/teams
• Takes league_id, season_id, country, q, and per_page
• Plan: every plan, the free key included

get_standings

The regular season table of one season by its season id (ss_...): games, wins, losses, overtime and shootout results, goals and points, built from the results. The free key reads current seasons.

• Calls GET /v1/seasons/{season_id}/standings
• Takes season_id (required)
• Plan: every plan, the free key included

get_playoffs

The playoff series of one season by its season id (ss_...): the two teams, wins each, the winner and every game. The free key reads current seasons.

• Calls GET /v1/seasons/{season_id}/playoffs
• Takes season_id (required)
• Plan: every plan, the free key included

season_leaders

The leading players of one season by its season id (ss_...), ranked by points, goals, assists, plus-minus, penalty minutes or shots. Gives each player's id (pl_...).

• Calls GET /v1/seasons/{season_id}/leaders
• Takes season_id (required), category, limit
• Plan: Live and up

head_to_head

Every meeting of two teams by their team ids (tm_...), newest first, with the first team's record against the second.

• Calls GET /v1/teams/{team_id}/head-to-head/{other_id}
• Takes team_id (required), other_id (required), and per_page
• Plan: Live and up

game_scoring

Every goal of one game by its game id (gm_...): period, time, side, scorer, assists, strength and the score after it.

• Calls GET /v1/games/{game_id}/goals
• Takes game_id (required)
• Plan: every plan, the free key included

find_players

Find players by part of the name, position, nationality or birth year. Gives each player's id (pl_...).

• Calls GET /v1/players
• Takes q, position, nationality, born, and per_page
• Plan: every plan, the free key included

player_career

One player's career season by season by the player id (pl_...): every league and team, regular season and playoffs.

• Calls GET /v1/players/{player_id}/seasons
• Takes player_id (required)
• Plan: Live and up

my_usage

The plan this key is on, calls used today and this period, limits, reset times and which seasons the plan covers.

• Calls GET /v1/usage
• Takes nothing
• Plan: every plan, the free key included