tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsMore

MCP tools

Every tool on the MCP server, made from the same list as the API, so a tool and its endpoint never disagree. A tool call counts like the API call it matches and follows the same plan.

ToolWhat it doesArgumentsSame asPlans
matches_on_dayMatches on a day, with scores and closing pricesdate tour tier tournament page per_pageMatches on a dayevery plan
results_yesterdayYesterday's resultstour tier page per_pageYesterday's resultsevery plan
fixturesThe matches set to be played, from those under way to two days ahead: start time, round, both players with ranking and Elo, the chance Elo gives each, and the price before play where the market has onetour tier tournament page per_pageFixturesevery plan
match_detailOne match: score, every bookmaker's price with its opening price, the games and sets lines, correct score prices, price movement and the full statisticsidMatchevery plan
match_statisticsServe and return figures for each player, for the match and each set, with the service games held and brokenidMatch statisticsevery plan
match_pointsEvery game and point of a match: who served, who won it, breaks, break points and set pointsidPoint by pointevery plan
match_pricesEvery bookmaker's closing and opening price for a match, and every market: games, sets, handicaps and correct scoreidMatch pricesevery plan
price_movesEach change of each bookmaker's match price before the start, timedidPrice movesevery plan
find_playerFind players by namesearch tour page per_pageFind playersevery plan
player_profileA player, with their win and loss record by surfaceidPlayer profileevery plan
player_matchesA player's matches, newest firstid season page per_pagePlayer matchespaid plans
player_seasonsA player's won and lost by season, and by surface within each seasonidPlayer seasonsevery plan
player_statisticsA player's serve and return figures over every match held with statistics, and their opponents' against themid season surfacePlayer statisticspaid plans
player_titlesEvery final a player won and lost, by levelid tierPlayer titlesevery plan
ranking_historyA player's singles ranking and points, week by week, newest firstid from to page per_pageRanking historypaid plans
elo_historyA player's Elo rating now, and before every match, overall and on the match's surface, with the chance it gave themid page per_pageElo historypaid plans
head_to_headHead to head between two playersa b page per_pageHead to headpaid plans
rankingsThe current singles rankings, with each player's highest ranking and Elotour page per_pageRankingsevery plan
rankings_on_dateThe ranking list of the week of a date: singles, men from 1973 and women from 2003; women's doubles with list=doublesdate tour list page per_pageRankings on a datepaid plans
elo_ratingsThe players our Elo rates highest, overall or on one surface, among those with a match in the last yeartour surface page per_pageElo ratingsevery plan
find_tournamentTournaments, by name, tour or tiersearch tour tier page per_pageFind tournamentsevery plan
tournament_seasonsA tournament and every season heldidTournamentevery plan
tournament_championsThe champion and runner-up of every season of a tournament, and who has won it mostidChampionsevery plan
tournament_resultsEvery match of one season of a tournamentid season page per_pageTournament seasonpaid plans
season_drawOne season of a tournament round by round, from qualifying to the final, with seeds and entryid seasonSeason drawpaid plans
events_this_weekThe events being played in the week of a date, every level, with surface, city and matches held so fardate tour tier page per_pageThis weekevery plan
doubles_on_dayEvery doubles match of one day, with both pairs, seeds, the score and closing pricesdate tour tier page per_pageDoubles on a daypaid plans
doubles_statisticsA doubles match's serve and return figures for each pair, for the match and each set, where the match has them (tour-level doubles from 13 November 2026)idDoubles statisticspaid plans
doubles_pointsEvery game and point of a doubles match: which pair served, who won it, breaks and break pointsidDoubles point by pointpaid plans
doubles_pairA doubles pair, their record together and every match they played, newest firstid page per_pageDoubles pairpaid plans
market_accuracyHow often the closing favourite won: by price, level, surface and season, and over the last 30 daysnoneMarket accuracyevery plan
biggest_upsetsThe longest closing prices that won at Grand Slam and tour levelnoneBiggest upsetsevery plan
bookmaker_marginsEach bookmaker's average margin on its closing prices since the start of last yearnoneBookmaker marginspaid plans
all_time_leadersThe most matches won and the most titles, all timetourAll-time leadersevery plan
season_leadersThe most matches won and the most titles in one seasonseason tourSeason leadersevery plan
searchPlayers and tournaments together, by nameqSearchevery plan

How to connect an assistant is on MCP server.