MCP tools

Every tool the MCP server offers, with its inputs.

The 15 tools of the MCP server, in the order the server lists them. Each is one endpoint of the REST API with paging left out; per_page sets how many records a list brings back. Ids are the API's own, such as those get_games and find_teams return.

get_games

Find games by day, date range, competition, season, team or status. Start here to get game ids.

Input	Type	Required	What it is
`date`	string (date)	No	A day as YYYY-MM-DD.
`from`	string (date)	No	A day as YYYY-MM-DD.
`to`	string (date)	No	A day as YYYY-MM-DD.
`competition`	string	No	A competition id, like cp_11A6HQXJ.
`season`	string	No	A season id, like ss_VMJG5K0W.
`team`	string	No	A team id, like tm_X3JM1FF7.
`status`	string	No	One of `scheduled`, `final`, `no_result`.
`per_page`	integer	No	How many records, 50 if left out.

yesterdays_results

Every final score from yesterday (UTC), optionally for one competition.

Input	Type	Required	What it is
`competition`	string	No	A competition id, like cp_11A6HQXJ.
`per_page`	integer	No	How many records, 50 if left out.

get_game

One game: teams, score by quarter, attendance and which detail it holds.

Input	Type	Required	What it is
`id`	string	Yes	The game id, like gm_GR6FFRP9.

get_boxscore

Both teams' box scores: every player's line and the team totals.

Input	Type	Required	What it is
`id`	string	Yes	The game id, like gm_GR6FFRP9.

get_play_by_play

Every event of a game in order, with the clock, team, player and running score.

Input	Type	Required	What it is
`id`	string	Yes	The game id, like gm_GR6FFRP9.

get_shots

Every shot of a game with its position in feet from the basket, its value and whether it went in.

Input	Type	Required	What it is
`id`	string	Yes	The game id, like gm_GR6FFRP9.

list_competitions

Every competition held, with its id, country, seasons and games.

Input	Type	Required	What it is
`per_page`	integer	No	How many records, 50 if left out.

find_teams

Teams by name, competition or season, to get team ids.

Input	Type	Required	What it is
`competition`	string	No	A competition id, like cp_11A6HQXJ.
`season`	string	No	A season id, like ss_VMJG5K0W.
`q`	string	No
`per_page`	integer	No	How many records, 50 if left out.

get_team

One team: its country, city, home arena, arena capacity, founding year, head coaches, and the competitions and seasons it played.

Input	Type	Required	What it is
`id`	string	Yes	The team id, like tm_X3JM1FF7.

get_standings

A season's table from its regular-season results: played, won, lost, points for and against, home, away, last ten and streak. Leave season out for the latest.

Input	Type	Required	What it is
`competition`	string	Yes	A competition id, like cp_11A6HQXJ.
`season`	string	No	A season id, like ss_VMJG5K0W.

get_team_form

A team's last games with margin, pace, ratings and results against the closing spread and total.

Input	Type	Required	What it is
`id`	string	Yes	The team id, like tm_X3JM1FF7.
`last`	integer	No
`venue`	string	No	One of `home`, `away`.
`competition`	string	No	A competition id, like cp_11A6HQXJ.

find_players

Players by name (3 letters or more) or team, to get player ids; the only way to a player id without a box score first.

Input	Type	Required	What it is
`q`	string	No
`team`	string	No	A team id, like tm_X3JM1FF7.
`competition`	string	No	A competition id, like cp_11A6HQXJ.
`season`	string	No	A season id, like ss_VMJG5K0W.
`per_page`	integer	No	How many records, 50 if left out.

get_player_games

A player's game log: one box line per game.

Input	Type	Required	What it is
`id`	string	Yes	The player id, like pl_JFEK5S5G.
`season`	string	No	A season id, like ss_VMJG5K0W.
`from`	string (date)	No	A day as YYYY-MM-DD.
`to`	string (date)	No	A day as YYYY-MM-DD.
`per_page`	integer	No	How many records, 50 if left out.

get_player_splits

A player's averages split home and away, by result, month, opponent or starting role.

Input	Type	Required	What it is
`id`	string	Yes	The player id, like pl_JFEK5S5G.
`by`	string	No	One of `venue`, `result`, `month`, `opponent`, `starter`.
`season`	string	No	A season id, like ss_VMJG5K0W.
`competition`	string	No	A competition id, like cp_11A6HQXJ.

get_usage

Your plan, calls used today and the limits. Does not count as a call.

It takes no inputs.