tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsMore

MCP server

The same data as tools for Claude and other agents, over the Model Context Protocol. A tool call counts like the API call it matches and follows the same plan.

1Connect

claude mcp add --transport http tennis https://api.tennisdatabaseapi.com/mcp \
  --header "Authorization: Bearer $TDA_KEY"

Address: https://api.tennisdatabaseapi.com/mcp, Streamable HTTP (JSON-RPC over POST). Send your key as a Bearer token: any client that takes a header works, such as Claude Code and Cursor. Every tool is on MCP tools, and the agent skill teaches an agent the same calls.

2A worked example

You ask"Who won the 2025 US Open men's final, and what was the closing price?"
The assistant callsfind_tournament with search: "us open", then tournament_results for 2025, then match_detail on the final.
It answersFrom the match itself: the winner, the score and odds.closing, not from memory.

3Tools

ToolWhat it doesSame as
matches_on_dayMatches on a day, with scores and closing pricesMatches on a day
results_yesterdayYesterday's resultsYesterday's results
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 oneFixtures
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 statisticsMatch
match_statisticsServe and return figures for each player, for the match and each set, with the service games held and brokenMatch statistics
match_pointsEvery game and point of a match: who served, who won it, breaks, break points and set pointsPoint by point
match_pricesEvery bookmaker's closing and opening price for a match, and every market: games, sets, handicaps and correct scoreMatch prices
price_movesEach change of each bookmaker's match price before the start, timedPrice moves
find_playerFind players by nameFind players
player_profileA player, with their win and loss record by surfacePlayer profile
player_matchesA player's matches, newest firstPlayer matches
player_seasonsA player's won and lost by season, and by surface within each seasonPlayer seasons
player_statisticsA player's serve and return figures over every match held with statistics, and their opponents' against themPlayer statistics
player_titlesEvery final a player won and lost, by levelPlayer titles
ranking_historyA player's singles ranking and points, week by week, newest firstRanking history
elo_historyA player's Elo rating now, and before every match, overall and on the match's surface, with the chance it gave themElo history
head_to_headHead to head between two playersHead to head
rankingsThe current singles rankings, with each player's highest ranking and EloRankings
rankings_on_dateThe ranking list of the week of a date: singles, men from 1973 and women from 2003; women's doubles with list=doublesRankings on a date
elo_ratingsThe players our Elo rates highest, overall or on one surface, among those with a match in the last yearElo ratings
find_tournamentTournaments, by name, tour or tierFind tournaments
tournament_seasonsA tournament and every season heldTournament
tournament_championsThe champion and runner-up of every season of a tournament, and who has won it mostChampions
tournament_resultsEvery match of one season of a tournamentTournament season
season_drawOne season of a tournament round by round, from qualifying to the final, with seeds and entrySeason draw
events_this_weekThe events being played in the week of a date, every level, with surface, city and matches held so farThis week
doubles_on_dayEvery doubles match of one day, with both pairs, seeds, the score and closing pricesDoubles on a day
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)Doubles statistics
doubles_pointsEvery game and point of a doubles match: which pair served, who won it, breaks and break pointsDoubles point by point
doubles_pairA doubles pair, their record together and every match they played, newest firstDoubles pair
market_accuracyHow often the closing favourite won: by price, level, surface and season, and over the last 30 daysMarket accuracy
biggest_upsetsThe longest closing prices that won at Grand Slam and tour levelBiggest upsets
bookmaker_marginsEach bookmaker's average margin on its closing prices since the start of last yearBookmaker margins
all_time_leadersThe most matches won and the most titles, all timeAll-time leaders
season_leadersThe most matches won and the most titles in one seasonSeason leaders
searchPlayers and tournaments together, by nameSearch