// Handball API MCP tools

Every tool on the MCP server at https://handballapi.com/mcp, the endpoint it calls and the plan it needs. A tool call is an API call on your plan. Setting it up: MCP server

yesterdays_resultsGET /v1/results/yesterday

Yesterday's results. Every match finished yesterday (UTC), newest first.

latest_resultsGET /v1/results/latest

Latest results. Matches finished in the last days, newest first. Results only: served after full time.

results_on_dayGET /v1/results

Results on a day. Every match finished on one day (UTC). The free key reaches yesterday and today.

get_matchGET /v1/matches/{id}

One match. Score, half-time, date, venue, crowd, referees and shootout of one finished match.

match_playersGET /v1/matches/{id}/players

Player lines of a match. A line for every player listed for the match: goals, shots, 7m, assists, cards, and saves and shots faced for goalkeepers.

fixturesGET /v1/fixtures

Fixtures ahead. Matches scheduled in the coming days, soonest first, with throw-off in UTC and in the league's own time.

league_tableGET /v1/competitions/{id}/table

League table. The table of a competition and season, computed from the results held: played, won, drawn, lost, goals and points.

top_scorersGET /v1/competitions/{id}/scorers

Top scorers. The leading scorers of a competition and season, from the player lines held, with matches, 7m goals and goals a match.

head_to_headGET /v1/teams/{id}/head-to-head

Head to head. Every finished match between two teams, newest first, with a summary from the first team's side: won, drawn, lost and goals.

coverageGET /v1/meta/coverage

Coverage. What the archive holds, counted from the data: matches, results and player lines by country, and what is never collected.

search_matchesGET /v1/matches

Find matches. Matches by team, competition, season and dates, finished or scheduled. Give at least one of team, competition, season or from.

match_officialsGET /v1/matches/{id}/officials

Officials of a match. The referees of one finished match, each with our referee id where the name is known to us.

find_competitionsGET /v1/competitions

Competitions. Every competition with results, with country, men or women, league or cup, seasons and dates held.

competition_seasonsGET /v1/competitions/{id}/seasons

Seasons of a competition. Every season held for a competition, newest first: matches, teams, dates and how many matches have player lines.

top_goalkeepersGET /v1/competitions/{id}/goalkeepers

Goalkeepers of a season. The best save rates of a competition and season, among goalkeepers who faced at least min_shots shots.

home_away_tableGET /v1/competitions/{id}/home-away

Home and away tables. Two tables for a competition and season: home matches only and away matches only.

league_formGET /v1/competitions/{id}/form

Form table. Every team of a competition and season with its last five results and its current run.

season_statsGET /v1/competitions/{id}/stats

Season figures. A competition season in figures: goals a match, home and away goals, home win, draw and away win rates, average crowd.

find_teamsGET /v1/teams

Find teams. Teams by part of the name or by country, with matches held and dates.

team_resultsGET /v1/teams/{id}/results

Results of a team. Every result of a team, newest first, in every competition held.

team_fixturesGET /v1/teams/{id}/fixtures

Fixtures of a team. A team's matches still to be played, soonest first.

team_squadGET /v1/teams/{id}/squad

Squad of a season. Every player with a line for the team in a season, with matches and goals.

team_statsGET /v1/teams/{id}/stats

Season figures of a team. A team's season per competition: record, goals, home and away, goals a match, form and current run.

team_formGET /v1/teams/{id}/form

Form of a team. A team's last results in every competition, newest first, each marked won, drawn or lost.

player_leadersGET /v1/players/leaders

Leaders. The leading players across every competition held, or one season or country: goals, 7m goals, assists or 2 minute suspensions.

find_playersGET /v1/players

Find players. Players by part of the name, with matches, goals and their last match.

player_careerGET /v1/players/{id}/career

Career of a player. A player's career totals, and per competition, across everything held.

find_refereesGET /v1/referees

Find referees. Referees by part of the name or by country, with matches held and dates.

referee_statsGET /v1/referees/{id}/stats

Record of a referee. A referee's record: home win, draw and away win rates, goals a match, and 2 minute suspensions and 7m throws a match where player lines are held.

home_advantageGET /v1/stats/home-advantage

Home advantage. Home win, draw and away win rates and home and away goals a match, by country and season.