Live tennis scores, players, rankings, odds and win-probability. ATP, WTA, Challenger, ITF, juniors.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer twjp_… — your Live Tennis API key. Tools are listable without it; calling one needs it. Free key, no card: https://livetennisapi.com/subscribe/free
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
This tool takes no arguments.
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.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Player name fragment, min 3 chars — must resolve to exactly one person. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 3,
"description": "Player name fragment, min 3 chars — must resolve to exactly one person."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| archive_match_id* | integer | Archive match id, as returned by search_archive_matches. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"archive_match_id"
],
"properties": {
"archive_match_id": {
"type": "integer",
"description": "Archive match id, as returned by search_archive_matches."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| charting_match_id* | integer | Charting match id — its own id space, not a match_id. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"charting_match_id"
],
"properties": {
"charting_match_id": {
"type": "integer",
"description": "Charting match id — its own id space, not a match_id."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Player name fragment, min 3 chars — must resolve to one charted person. |
| gender | string | Disambiguates a name charted on both tours. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 3,
"description": "Player name fragment, min 3 chars — must resolve to one charted person."
},
"gender": {
"enum": [
"men",
"women"
],
"type": "string",
"description": "Disambiguates a name charted on both tours."
}
},
"additionalProperties": false
}Upcoming scheduled tennis fixtures, earliest first — the forward schedule, filterable by tour, player and date. Use this for "what is on this week". Works on the FREE plan (no card needed).
| Argument | Type | Description |
|---|---|---|
| tour | string | Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used. |
| limit | integer | Maximum fixtures to return (1-200). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"tour": {
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string",
"description": "Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 200,
"minimum": 1,
"description": "Maximum fixtures to return (1-200)."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| player1* | string | First player name (fragment, min 3 chars), e.g. "federer". |
| player2* | string | Second player name (fragment, min 3 chars), e.g. "nadal". |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player1",
"player2"
],
"properties": {
"player1": {
"type": "string",
"minLength": 3,
"description": "First player name (fragment, min 3 chars), e.g. \"federer\"."
},
"player2": {
"type": "string",
"minLength": 3,
"description": "Second player name (fragment, min 3 chars), e.g. \"nadal\"."
}
},
"additionalProperties": false
}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". Works on the FREE plan (no card needed).
| Argument | Type | Description |
|---|---|---|
| tour | string | Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used. |
| limit | integer | Maximum matches to return (1-200). |
| player | array | Player ids (from search_players), max 50 — keeps matches where ANY listed player is either participant. |
| country | string | Either participant's country — the lowercase 3-letter IOC-style code the Player object returns (e.g. ned, sui, gre), NOT ISO-3166. Players with no recorded country never match. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"tour": {
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string",
"description": "Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 200,
"minimum": 1,
"description": "Maximum matches to return (1-200)."
},
"player": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 50,
"description": "Player ids (from search_players), max 50 — keeps matches where ANY listed player is either participant."
},
"country": {
"type": "string",
"maxLength": 3,
"minLength": 3,
"description": "Either participant's country — the lowercase 3-letter IOC-style code the Player object returns (e.g. ned, sui, gre), NOT ISO-3166. Players with no recorded country never match."
}
},
"additionalProperties": false
}Full detail for one match by id: players, score, surface, round and status. Includes market prices on PRO and model analysis on ULTRA. Works on the FREE plan (no card needed).
| Argument | Type | Description |
|---|---|---|
| match_id* | integer | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id"
],
"properties": {
"match_id": {
"type": "integer",
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results."
}
},
"additionalProperties": false
}Model analysis for a match: predicted win probability, the model's thesis and the key factors behind it. Requires the ULTRA plan. Match rows carry has_analysis — check it first; a match with no thesis or profile has nothing to return.
| Argument | Type | Description |
|---|---|---|
| match_id* | integer | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id"
],
"properties": {
"match_id": {
"type": "integer",
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results."
}
},
"additionalProperties": false
}Timeline of events for a match — breaks, games won, sets won, momentum runs. Requires the PRO plan.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum events to return (1-200). |
| match_id* | integer | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 30,
"maximum": 200,
"minimum": 1,
"description": "Maximum events to return (1-200)."
},
"match_id": {
"type": "integer",
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results."
}
},
"additionalProperties": false
}Match-winner market prices for a match — implied probability per player, with bid, ask and mid. Requires the PRO plan. Match rows carry has_market — check it first; a match with no market mapped has no prices to return.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum price points to return (1-200). |
| match_id* | integer | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 200,
"minimum": 1,
"description": "Maximum price points to return (1-200)."
},
"match_id": {
"type": "integer",
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results."
}
},
"additionalProperties": false
}Current score for one match — the fastest, lowest-latency read. Use this when you only need the score and already know the match id. Works on the FREE plan (no card needed).
| Argument | Type | Description |
|---|---|---|
| match_id* | integer | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id"
],
"properties": {
"match_id": {
"type": "integer",
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| match_id* | integer | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id"
],
"properties": {
"match_id": {
"type": "integer",
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results."
}
},
"additionalProperties": false
}One player's profile: ranking, country, handedness, date of birth and cached stats. Works on the FREE plan (no card needed).
| Argument | Type | Description |
|---|---|---|
| player_id* | integer | Player id, as returned by search_players. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id"
],
"properties": {
"player_id": {
"type": "integer",
"description": "Player id, as returned by search_players."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| as_of | string | YYYY-MM-DD — the record in force on this date. Omit for the latest known. |
| system | string | Restrict to one system. Omit for every system held for the player. |
| player_ids* | array | Roster player ids, as returned by search_players. Max 50. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_ids"
],
"properties": {
"as_of": {
"type": "string",
"description": "YYYY-MM-DD — the record in force on this date. Omit for the latest known."
},
"system": {
"enum": [
"atp",
"wta",
"itf_jt",
"itf_mt",
"itf_wt",
"utr"
],
"type": "string",
"description": "Restrict to one system. Omit for every system held for the player."
},
"player_ids": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 50,
"minItems": 1,
"description": "Roster player ids, as returned by search_players. Max 50."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| as_of | string | YYYY-MM-DD — serves the newest published week at or before this date. Omit for latest. |
| limit | integer | Maximum ranking rows to return (1-200). |
| system* | string | Ranking system to list. utr has no listing — it is a rating, not a ranking. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"system"
],
"properties": {
"as_of": {
"type": "string",
"description": "YYYY-MM-DD — serves the newest published week at or before this date. Omit for latest."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 200,
"minimum": 1,
"description": "Maximum ranking rows to return (1-200)."
},
"system": {
"enum": [
"atp",
"wta",
"itf_jt",
"itf_mt",
"itf_wt"
],
"type": "string",
"description": "Ranking system to list. utr has no listing — it is a rating, not a ranking."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| to | string | Latest play date: YYYY-MM-DD or ISO-8601; must not precede from. |
| from | string | Earliest play date: YYYY-MM-DD (a whole UTC day) or ISO-8601 datetime. |
| tour | string | Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used. |
| limit | integer | Maximum matches to return (1-200). |
| player | array | Player ids (from search_players), max 50 — keeps matches where ANY listed player is either participant. |
| country | string | Either participant's country — the lowercase 3-letter IOC-style code the Player object returns (e.g. ned, sui, gre), NOT ISO-3166. Players with no recorded country never match. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"description": "Latest play date: YYYY-MM-DD or ISO-8601; must not precede from."
},
"from": {
"type": "string",
"description": "Earliest play date: YYYY-MM-DD (a whole UTC day) or ISO-8601 datetime."
},
"tour": {
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string",
"description": "Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 200,
"minimum": 1,
"description": "Maximum matches to return (1-200)."
},
"player": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 50,
"description": "Player ids (from search_players), max 50 — keeps matches where ANY listed player is either participant."
},
"country": {
"type": "string",
"maxLength": 3,
"minLength": 3,
"description": "Either participant's country — the lowercase 3-letter IOC-style code the Player object returns (e.g. ned, sui, gre), NOT ISO-3166. Players with no recorded country never match."
}
},
"additionalProperties": false
}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. Works on the FREE plan (no card needed).
| Argument | Type | Description |
|---|---|---|
| tournament_id* | string | Stable tournament id, as returned by search_tournaments or carried on a match as tournament_id. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tournament_id"
],
"properties": {
"tournament_id": {
"type": "string",
"description": "Stable tournament id, as returned by search_tournaments or carried on a match as tournament_id."
}
},
"additionalProperties": false
}List tennis matches scheduled to start soon, with players, tournament and start time. Use this for "who plays next" or to find a match id before it starts. Works on the FREE plan (no card needed).
| Argument | Type | Description |
|---|---|---|
| to | string | Latest play date: YYYY-MM-DD or ISO-8601; must not precede from. |
| from | string | Earliest play date: YYYY-MM-DD (a whole UTC day) or ISO-8601 datetime. |
| tour | string | Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used. |
| limit | integer | Maximum matches to return (1-200). |
| player | array | Player ids (from search_players), max 50 — keeps matches where ANY listed player is either participant. |
| country | string | Either participant's country — the lowercase 3-letter IOC-style code the Player object returns (e.g. ned, sui, gre), NOT ISO-3166. Players with no recorded country never match. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"description": "Latest play date: YYYY-MM-DD or ISO-8601; must not precede from."
},
"from": {
"type": "string",
"description": "Earliest play date: YYYY-MM-DD (a whole UTC day) or ISO-8601 datetime."
},
"tour": {
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string",
"description": "Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 200,
"minimum": 1,
"description": "Maximum matches to return (1-200)."
},
"player": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 50,
"description": "Player ids (from search_players), max 50 — keeps matches where ANY listed player is either participant."
},
"country": {
"type": "string",
"maxLength": 3,
"minLength": 3,
"description": "Either participant's country — the lowercase 3-letter IOC-style code the Player object returns (e.g. ned, sui, gre), NOT ISO-3166. Players with no recorded country never match."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| to | string | Latest tournament START date, YYYY-MM-DD. |
| from | string | Earliest tournament START date, YYYY-MM-DD. |
| tour | string | atp or wta. |
| level | string | Source tier code: G=grand slam, M=masters, A=tour, F=finals, D=davis cup, C=challenger, O=olympics, or a futures category code (e.g. 15). |
| limit | integer | Maximum results to return (1-200). |
| round | string | Round code, e.g. F for finals. |
| player_name | string | Case-insensitive fragment of EITHER player's name, min 3 chars, e.g. "borg". |
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.
| Argument | Type | Description |
|---|---|---|
| tour | string | atp or wta. |
| limit | integer | Maximum players to return (1-200). |
| query* | string | Full or partial player name, min 3 chars, e.g. "navratilova". |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"tour": {
"enum": [
"atp",
"wta"
],
"type": "string",
"description": "atp or wta."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 200,
"minimum": 1,
"description": "Maximum players to return (1-200)."
},
"query": {
"type": "string",
"minLength": 3,
"description": "Full or partial player name, min 3 chars, e.g. \"navratilova\"."
}
},
"additionalProperties": false
}Search tennis players by name. Returns id, country, ranking and tour. Use the returned id with get_player. Works on the FREE plan (no card needed).
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum players to return (1-200). |
| query* | string | Full or partial player name, e.g. "alcaraz". |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 200,
"minimum": 1,
"description": "Maximum players to return (1-200)."
},
"query": {
"type": "string",
"minLength": 1,
"description": "Full or partial player name, e.g. \"alcaraz\"."
}
},
"additionalProperties": false
}Search the tournament catalogue — the stable id space that match objects carry as tournament_id. Returns surface, indoor, host city/country and category where curated. Works on the FREE plan (no card needed).
| Argument | Type | Description |
|---|---|---|
| tour | string | Restrict to one tour. |
| limit | integer | Maximum tournaments to return (1-200). |
| query | string | Full or partial tournament name, e.g. "wimbledon". Omit to list all. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"tour": {
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string",
"description": "Restrict to one tour."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 200,
"minimum": 1,
"description": "Maximum tournaments to return (1-200)."
},
"query": {
"type": "string",
"description": "Full or partial tournament name, e.g. \"wimbledon\". Omit to list all."
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"description": "Latest tournament START date, YYYY-MM-DD."
},
"from": {
"type": "string",
"description": "Earliest tournament START date, YYYY-MM-DD."
},
"tour": {
"enum": [
"atp",
"wta"
],
"type": "string",
"description": "atp or wta."
},
"level": {
"type": "string",
"description": "Source tier code: G=grand slam, M=masters, A=tour, F=finals, D=davis cup, C=challenger, O=olympics, or a futures category code (e.g. 15)."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 200,
"minimum": 1,
"description": "Maximum results to return (1-200)."
},
"round": {
"enum": [
"F",
"SF",
"QF",
"R16",
"R32",
"R64",
"R128",
"RR",
"BR",
"Q1",
"Q2",
"Q3",
"Q4",
"ER"
],
"type": "string",
"description": "Round code, e.g. F for finals."
},
"player_name": {
"type": "string",
"minLength": 3,
"description": "Case-insensitive fragment of EITHER player's name, min 3 chars, e.g. \"borg\"."
}
},
"additionalProperties": false
}