tennisdatabaseAPI

Tennis MCP server

Ask your assistant about any tennis match, and get the facts

36 tools over 2.3 million matches: results, players, head to heads, tournaments, closing prices, lines, statistics and every point. Your assistant answers from the data, not from memory.

MCPhttps://api.tennisdatabaseapi.com/mcp
Claude Code and Cursor Your normal key and plan Free key to start
Assistanttennis tools connected
Connect

Three steps, one minute

Any assistant that can send a header to an MCP server works. The key is the same one the API takes, so the plan, limits and allowance are the same too.

1
Get a keySign in with Google: a free key at once, 50 calls a day, no card.
2
Add the serverOne command in Claude Code, or a few lines in the settings of Cursor and other clients.
3
Ask"Who won yesterday's matches in Shanghai?" The assistant picks the tools by itself.
claude mcp add --transport http tennis https://api.tennisdatabaseapi.com/mcp \
  --header "Authorization: Bearer $TDA_KEY"
A tool call counts like the API call it matches. On the free key, prices and statistics come back on yesterday's matches; before play they are held back and the assistant is told which plan adds them.
Tools

36 tools, one for every question

Each tool is an API endpoint, made from the same list, so a tool and its endpoint never disagree.

matches_on_dayMatches on a day, with scores and closing pricesGET /v1/matches
every plan
results_yesterdayYesterday's resultsGET /v1/results/yesterday
every 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 oneGET /v1/fixtures
every 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 statisticsGET /v1/matches/{id}
every plan
match_statisticsServe and return figures for each player, for the match and each set, with the service games held and brokenGET /v1/matches/{id}/statistics
every plan
match_pointsEvery game and point of a match: who served, who won it, breaks, break points and set pointsGET /v1/matches/{id}/points
every plan
match_pricesEvery bookmaker's closing and opening price for a match, and every market: games, sets, handicaps and correct scoreGET /v1/matches/{id}/odds
every plan
price_movesEach change of each bookmaker's match price before the start, timedGET /v1/matches/{id}/moves
every plan
find_playerFind players by nameGET /v1/players
every plan
player_profileA player, with their win and loss record by surfaceGET /v1/players/{id}
every plan
player_matchesA player's matches, newest firstGET /v1/players/{id}/matches
paid plans
player_seasonsA player's won and lost by season, and by surface within each seasonGET /v1/players/{id}/seasons
every plan
player_statisticsA player's serve and return figures over every match held with statistics, and their opponents' against themGET /v1/players/{id}/statistics
paid plans
player_titlesEvery final a player won and lost, by levelGET /v1/players/{id}/titles
every plan
ranking_historyA player's singles ranking and points, week by week, newest firstGET /v1/players/{id}/rankings
paid plans
elo_historyA player's Elo rating now, and before every match, overall and on the match's surface, with the chance it gave themGET /v1/players/{id}/elo
paid plans
head_to_headHead to head between two playersGET /v1/h2h/{a}/{b}
paid plans
rankingsThe current singles rankings, with each player's highest ranking and EloGET /v1/rankings
every 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=doublesGET /v1/rankings/{date}
paid plans
elo_ratingsThe players our Elo rates highest, overall or on one surface, among those with a match in the last yearGET /v1/elo
every plan
find_tournamentTournaments, by name, tour or tierGET /v1/tournaments
every plan
tournament_seasonsA tournament and every season heldGET /v1/tournaments/{id}
every plan
tournament_championsThe champion and runner-up of every season of a tournament, and who has won it mostGET /v1/tournaments/{id}/champions
every plan
tournament_resultsEvery match of one season of a tournamentGET /v1/tournaments/{id}/{season}
paid plans
season_drawOne season of a tournament round by round, from qualifying to the final, with seeds and entryGET /v1/tournaments/{id}/{season}/draw
paid plans
events_this_weekThe events being played in the week of a date, every level, with surface, city and matches held so farGET /v1/calendar
every plan
doubles_on_dayEvery doubles match of one day, with both pairs, seeds, the score and closing pricesGET /v1/doubles
paid 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)GET /v1/doubles/matches/{id}/statistics
paid plans
doubles_pointsEvery game and point of a doubles match: which pair served, who won it, breaks and break pointsGET /v1/doubles/matches/{id}/points
paid plans
doubles_pairA doubles pair, their record together and every match they played, newest firstGET /v1/doubles/pairs/{id}
paid plans
market_accuracyHow often the closing favourite won: by price, level, surface and season, and over the last 30 daysGET /v1/markets/accuracy
every plan
biggest_upsetsThe longest closing prices that won at Grand Slam and tour levelGET /v1/markets/upsets
every plan
bookmaker_marginsEach bookmaker's average margin on its closing prices since the start of last yearGET /v1/markets/margins
paid plans
all_time_leadersThe most matches won and the most titles, all timeGET /v1/records
every plan
season_leadersThe most matches won and the most titles in one seasonGET /v1/records/{season}
every plan
searchPlayers and tournaments together, by nameGET /v1/search
every plan
Ask it

Questions it answers from the data

The assistant chains the tools by itself: it finds the player or event, then the matches, then the detail.

Who won the 2025 US Open men's final, and what was the closing price?
find_tournamenttournament_resultsmatch_detail
How has Sinner done against Alcaraz on clay?
find_playerhead_to_head
Which favourites lost at tour level yesterday?
results_yesterday
How many aces did the winner serve in the Wimbledon final, set by set?
find_tournamenttournament_resultsmatch_detail
What is Swiatek's record on grass?
find_playerplayer_profile
Did the price move before the match, and which way?
match_detail
For agents

The skill, and what each plan allows

The agent skill

One file that teaches an agent this API: what it holds, the calls for common questions, the limits and the errors. Save it as ~/.claude/skills/tennisdatabaseapi/SKILL.md, or upload it as a skill in Claude's settings.

Limits by plan

The same for the MCP server and the API, from one allowance.

Free key: yesterday to two days ahead, prices and statistics on yesterday's matches50 calls a day
Live: the last 45 days, prices and statistics300,000 a month
Archive: every season to yesterday300,000 a month
Complete: every season, live and archive1,000,000 a month
Questions

Before you connect

Which assistants work?

Any MCP client that can send a header: Claude Code, Cursor and others. Apps that only sign in with OAuth cannot connect yet.

Does a tool call cost more than an API call?

No. Each tool call counts as one call of the endpoint it matches, from the same allowance.

Will it make predictions?

No. The tools return facts: results, prices as offered and statistics. The assistant can reason over them, but nothing is a tip.

What happens on the free key?

Matches from yesterday to two days ahead, with every price, the statistics and point by point on yesterday's matches. Prices before play are held back, and the answer tells the assistant which plan adds them, so it can say so.

Give your assistant every tennis matchFree key in seconds. Upgrade when you need prices and history.