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.
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.
claude mcp add --transport http tennis https://api.tennisdatabaseapi.com/mcp \ --header "Authorization: Bearer $TDA_KEY"
{
"mcpServers": {
"tennis": {
"url": "https://api.tennisdatabaseapi.com/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
Address https://api.tennisdatabaseapi.com/mcp Transport Streamable HTTP (JSON-RPC over POST) Header Authorization: Bearer YOUR_KEY
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/matchesresults_yesterdayYesterday's resultsGET /v1/results/yesterdayfixturesThe 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/fixturesmatch_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}match_statisticsServe and return figures for each player, for the match and each set, with the service games held and brokenGET /v1/matches/{id}/statisticsmatch_pointsEvery game and point of a match: who served, who won it, breaks, break points and set pointsGET /v1/matches/{id}/pointsmatch_pricesEvery bookmaker's closing and opening price for a match, and every market: games, sets, handicaps and correct scoreGET /v1/matches/{id}/oddsprice_movesEach change of each bookmaker's match price before the start, timedGET /v1/matches/{id}/movesfind_playerFind players by nameGET /v1/playersplayer_profileA player, with their win and loss record by surfaceGET /v1/players/{id}player_matchesA player's matches, newest firstGET /v1/players/{id}/matchesplayer_seasonsA player's won and lost by season, and by surface within each seasonGET /v1/players/{id}/seasonsplayer_statisticsA player's serve and return figures over every match held with statistics, and their opponents' against themGET /v1/players/{id}/statisticsplayer_titlesEvery final a player won and lost, by levelGET /v1/players/{id}/titlesranking_historyA player's singles ranking and points, week by week, newest firstGET /v1/players/{id}/rankingselo_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}/elohead_to_headHead to head between two playersGET /v1/h2h/{a}/{b}rankingsThe current singles rankings, with each player's highest ranking and EloGET /v1/rankingsrankings_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}elo_ratingsThe players our Elo rates highest, overall or on one surface, among those with a match in the last yearGET /v1/elofind_tournamentTournaments, by name, tour or tierGET /v1/tournamentstournament_seasonsA tournament and every season heldGET /v1/tournaments/{id}tournament_championsThe champion and runner-up of every season of a tournament, and who has won it mostGET /v1/tournaments/{id}/championstournament_resultsEvery match of one season of a tournamentGET /v1/tournaments/{id}/{season}season_drawOne season of a tournament round by round, from qualifying to the final, with seeds and entryGET /v1/tournaments/{id}/{season}/drawevents_this_weekThe events being played in the week of a date, every level, with surface, city and matches held so farGET /v1/calendardoubles_on_dayEvery doubles match of one day, with both pairs, seeds, the score and closing pricesGET /v1/doublesdoubles_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}/statisticsdoubles_pointsEvery game and point of a doubles match: which pair served, who won it, breaks and break pointsGET /v1/doubles/matches/{id}/pointsdoubles_pairA doubles pair, their record together and every match they played, newest firstGET /v1/doubles/pairs/{id}market_accuracyHow often the closing favourite won: by price, level, surface and season, and over the last 30 daysGET /v1/markets/accuracybiggest_upsetsThe longest closing prices that won at Grand Slam and tour levelGET /v1/markets/upsetsbookmaker_marginsEach bookmaker's average margin on its closing prices since the start of last yearGET /v1/markets/marginsall_time_leadersThe most matches won and the most titles, all timeGET /v1/recordsseason_leadersThe most matches won and the most titles in one seasonGET /v1/records/{season}searchPlayers and tournaments together, by nameGET /v1/searchThe 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_detailHow has Sinner done against Alcaraz on clay?
find_playerhead_to_headWhich favourites lost at tour level yesterday?
results_yesterdayHow many aces did the winner serve in the Wimbledon final, set by set?
find_tournamenttournament_resultsmatch_detailWhat is Swiatek's record on grass?
find_playerplayer_profileDid the price move before the match, and which way?
match_detailOne 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.
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 matches | 50 calls a day |
| Live: the last 45 days, prices and statistics | 300,000 a month |
| Archive: every season to yesterday | 300,000 a month |
| Complete: every season, live and archive | 1,000,000 a month |
Any MCP client that can send a header: Claude Code, Cursor and others. Apps that only sign in with OAuth cannot connect yet.
No. Each tool call counts as one call of the endpoint it matches, from the same allowance.
No. The tools return facts: results, prices as offered and statistics. The assistant can reason over them, but nothing is a tip.
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.