Connection check
verified live · 27h ago
livetennisapi-mcp
Live tennis scores, players, rankings, odds and win-probability. ATP, WTA, Challenger, ITF, juniors.
Tools
24
GitHub stars
158
Installs / wk
105
Licence
MIT
Transport
streamable-http, stdio
Last checked
27h ago
Tools & capabilities
24 toolsRead from the running server on 27h ago.
check_api_status
read-only
Check whether the Live Tennis API is reachable and which plan the configured key is on. Useful for diagnosing why other tools are refusing data. Check whether the Live Tennis API is reachable and which plan the configured key is on. Useful for diagnosing why other tools are refusing data.
get_archive_career
read-only
name*
One player's whole career over the results archive (1968–2022): W-L record overall and by surface/level/year, titles, and summed serve statistics with honest coverage — the corpus… One player's whole career over the results archive (1968–2022): W-L record overall and by surface/level/year, titles, and summed serve statistics with honest coverage — the corpus records serve stats from 1991 only, so matches_with_stats states how many matches the serve block covers. The name must resolve to one person; an ambiguous fragment returns the candidate list to choose from. Requires the BASIC plan or any History plan.
get_archive_match
read-only
archive_match_id*
One result from the results archive (1968–2022), with per-match serve statistics where the era recorded them — stats are null for most rows before 1991, honestly, never synthesised… One result from the results archive (1968–2022), with per-match serve statistics where the era recorded them — stats are null for most rows before 1991, honestly, never synthesised. Requires the BASIC plan or any History plan.
get_charting_match
read-only
charting_match_id*
Every Match Charting Project stat family for ONE charted match, both players, with the per-set split (set 1, set 2, …, Total) exactly as charted. Charting ids are their own id spac… Every Match Charting Project stat family for ONE charted match, both players, with the per-set split (set 1, set 2, …, Total) exactly as charted. Charting ids are their own id space (1960–2026), mostly matches with no counterpart in the live tables. Requires the ULTRA plan.
get_charting_player
read-only
name*gender
Career shot-level profile from the Match Charting Project: serve placement (deuce/ad × wide/body/T), return depth and outcomes, net play, clutch break/game/set-point serving, winne… Career shot-level profile from the Match Charting Project: serve placement (deuce/ad × wide/body/T), return depth and outcomes, net play, clutch break/game/set-point serving, winners and errors by wing, rally-length tendencies — summed over the player's charted matches. COVERAGE IS CURATED (11,646 charted matches back to the 1960s, concentrated on the majors), not full-slate. An ambiguous name returns the candidates to choose from. Requires the ULTRA plan.
get_fixtures
read-only
tourlimit
Upcoming scheduled tennis fixtures, earliest first — the forward schedule. Upcoming scheduled tennis fixtures, earliest first — the forward schedule.
get_h2h
read-only
player1*player2*
The all-time record between two players, across BOTH halves of the product: the results archive (1968–2022) plus our own completed matches (2023 onward). Names are the keys — an am… The all-time record between two players, across BOTH halves of the product: the results archive (1968–2022) plus our own completed matches (2023 onward). Names are the keys — an ambiguous fragment returns the candidate list to choose from rather than guessing. Totals count only meetings with a known winner; walkovers and retirements are part of the record and each meeting carries its outcome. Requires the BASIC plan or any History plan.
get_live_matches
read-only
tourlimitplayercountry
List tennis matches currently in progress, with live scores. Covers ATP, WTA, Challenger, ITF and juniors. Use this for "what tennis is on right now". List tennis matches currently in progress, with live scores. Covers ATP, WTA, Challenger, ITF and juniors. Use this for "what tennis is on right now".
get_match
read-only
match_id*
Full detail for one match by id: players, score, surface, round and status. Includes market prices on PRO and model analysis on ULTRA. Full detail for one match by id: players, score, surface, round and status. Includes market prices on PRO and model analysis on ULTRA.
get_match_analysis
read-only
match_id*
Model analysis for a match: predicted win probability, the model's thesis and the key factors behind it. Requires the ULTRA plan. Model analysis for a match: predicted win probability, the model's thesis and the key factors behind it. Requires the ULTRA plan.
get_match_events
read-only
limitmatch_id*
Timeline of events for a match — breaks, games won, sets won, momentum runs. Requires the PRO plan. Timeline of events for a match — breaks, games won, sets won, momentum runs. Requires the PRO plan.
get_match_odds
read-only
limitmatch_id*
Match-winner market prices for a match — implied probability per player, with bid, ask and mid. Requires the PRO plan. Match-winner market prices for a match — implied probability per player, with bid, ask and mid. Requires the PRO plan.
get_match_score
read-only
match_id*
Current score for one match — the fastest, lowest-latency read. Use this when you only need the score and already know the match id. Current score for one match — the fastest, lowest-latency read. Use this when you only need the score and already know the match id.
get_match_statistics
read-only
match_id*
In-play (or final) statistics for one match, in TWO families kept deliberately separate: DERIVED is rebuilt from the point-by-point record (holds/breaks, break points, service/retu… In-play (or final) statistics for one match, in TWO families kept deliberately separate: DERIVED is rebuilt from the point-by-point record (holds/breaks, break points, service/return points); MEASURED is counted upstream and includes what no point record can yield — aces, double faults, the serve split, winners/unforced errors. Measured coverage varies by tour; absent fields are omitted, never zero-filled. Requires the ULTRA plan.
get_player
read-only
player_id*
One player's profile: ranking, country, handedness, date of birth and cached stats. One player's profile: ranking, country, handedness, date of birth and cached stats.
get_player_rankings
read-only
as_ofsystemplayer_ids*
Point-in-time ranking records for SPECIFIC players: per system, the newest record in force ON OR BEFORE as_of — never one dated after it. Every other ranking field in this API is t… Point-in-time ranking records for SPECIFIC players: per system, the newest record in force ON OR BEFORE as_of — never one dated after it. Every other ranking field in this API is the CURRENT value joined at read time; this is the historical answer. Systems are never collapsed: ATP/WTA and the ITF circuits carry rank+points, UTR a rating. ITF and UTR history begins 2026-07-29. Requires the ULTRA plan.
get_rankings
read-only
as_oflimitsystem*
The FULL published ranking table in rank order for one system — the newest week at or before as_of. Rows carry player_name as published and a null player_id for players outside our… The FULL published ranking table in rank order for one system — the newest week at or before as_of. Rows carry player_name as published and a null player_id for players outside our roster, so the table has no silent holes. ATP/WTA history runs deep; the ITF circuits begin 2026-07-29. For point-in-time records of SPECIFIC players use get_player_rankings. Requires the PRO plan.
get_recent_results
read-only
tofromtourlimitplayercountry
Recently completed tennis matches with final scores and winners. Filterable by tour, player, nationality and play date. Requires the BASIC plan or any History plan. Recently completed tennis matches with final scores and winners. Filterable by tour, player, nationality and play date. Requires the BASIC plan or any History plan.
get_tournament
read-only
tournament_id*
One tournament by its stable id — the tournament_id carried on match objects. Name, tour, surface, indoor, plus host city/country and category where curated. One tournament by its stable id — the tournament_id carried on match objects. Name, tour, surface, indoor, plus host city/country and category where curated.
get_upcoming_matches
read-only
tofromtourlimitplayercountry
List tennis matches scheduled to start soon, with players and tournament. List tennis matches scheduled to start soon, with players and tournament.
search_archive_matches
read-only
tofromtourlevellimitround
+1
Search the results archive — completed-match RESULTS from 1968 through 2022: ATP and WTA, main draws, qualifying and the ITF/futures tiers. Winner/loser-shaped records with final s… Search the results archive — completed-match RESULTS from 1968 through 2022: ATP and WTA, main draws, qualifying and the ITF/futures tiers. Winner/loser-shaped records with final score, seeds and ranks AT THE TIME of the match. Use this for historical questions ("Borg's Wimbledon finals"); the archive ends 2022-12-31 where our own results (get_recent_results) begin. Requires the BASIC plan or any History plan.
search_archive_players
read-only
tourlimitquery*
The people of the results archive (1968–2022): hand, date of birth, country, height, and career-high rank with the week it was first reached. Their ids are corpus person ids (the w… The people of the results archive (1968–2022): hand, date of birth, country, height, and career-high rank with the week it was first reached. Their ids are corpus person ids (the winner/loser player_id on archive results), not roster ids — for current players use search_players. Requires the BASIC plan or any History plan.
search_players
read-only
limitquery*
Search tennis players by name. Returns id, country, ranking and tour. Use the returned id with get_player. Search tennis players by name. Returns id, country, ranking and tour. Use the returned id with get_player.
search_tournaments
read-only
tourlimitquery