io.github.livetennisapi/livetennisapi-mcp
NPM · LIVETENNISAPI-MCP · 2 COMPONENTS
Live tennis scores, players, rankings, odds and win-probability. ATP, WTA, Challenger, ITF, juniors.
Available components
Last scanned (9 hours ago)
Scores higher than 93% of npm servers
Category Entertainment and Games
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security81
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available. View diagnostics → Fail
- No install/post-install scripts declared.Pass
- 30 of 94 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to livetennisapi/livetennisapi-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 7 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability75
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 3263 tokens (~130/item across 25 items; 25 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 25 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 25 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 5 Nov 26 +1
- Stability: 0.97 → pass security
- 3 Nov 26 −1
- Stability: pass → 0.93 functional
- 29 Oct 26 +21
- Known CVEs: unverified → fail ▼ security
- Malware scan: unverified → pass ▲ security
- Dependency health: unverified → 0.86 ▲ functional
- 28 Oct 26 −20
- Malware scan: pass → unverified ▼ security
- Known CVEs: fail → unverified ▼ security
- Stability: 0.97 → pass security
- Schema quality: 2929 → 3263 ▼ functional
- Dependency health: 0.86 → unverified ▼ functional
- Security disclosure: unverified → pass ▲ functional
- Package version: 1.5.0 → 1.6.5 functional
- 27 Oct 26 +4
- Source repository: fail → pass ▲ security
- Stability: pass → 0.97 functional
- 24 Oct 26 −5
- CVE-2023-54404 affects this package: high ▼ security
- Known CVEs: pass → fail ▼ security
- 21 Oct 26 +1
- Stability: 0.97 → pass security
- 20 Oct 26 −1
- Stability: pass → 0.97 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Analysed npm/livetennisapi-mcp@1.6.5
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | livetennisapi/livetennisapi-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/livetennisapi/livetennisapi-mcp/.github/workflows/publish.yml@refs/tags/v1.6.5 |
| Rekor log index | 3533235938 |
| Predicate type | SLSA build provenance https://slsa.dev/provenance/v1 |
| Subject digest | sha512:c2bc8c23976bd3eeca67f0fec6140559467a87ac963507f6dda180fddb231efa0b3658379d376c325f85ab26601f87bd4f82cc3a4dd0c28843ed0cc2a |
Background: How many MCP packages publish verified provenance →
Vulnerabilities 1 finding
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-mrhx-c7xc-m3w5 | CVE-2023-54404 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | yes |
Background: What a vulnerability scan can and cannot prove →
Dependencies 94 packages
| Packages resolved | 94 |
|---|---|
| Stale | 30 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
check_api_status API status and plan ~43
Check whether the Live Tennis API is reachable and which plan the configured key is on. Use it to find out why other tools are refusing data. Works with no key.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| api_version | string|null | – | API version reported by the health check. |
| has_key | boolean | – | Whether a key was configured for this tool set. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| reachable | boolean | – | True when the API answered its health check. |
| tier | string|null | – | Detected plan: FREE, BASIC, PRO or ULTRA. Null when no key is configured. |
No examples provided.
get_archive_career Archive career aggregates ~119
One player's whole career over the results archive (1968 to 2022). W-L record in total and by surface/level/year, titles, and summed serve statistics. The corpus records serve stats from 1991 only, so matches_with_stats says 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.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Player name fragment, min 3 chars. Must resolve to exactly one person. |
| Name | Type | Req | Description |
|---|---|---|---|
| by_year | array | – | Per-season W-L. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| player_name | string|null | – | The resolved player. |
| record | object | – | The W-L record. |
| serve | – | – | Summed serve stats + derived ratios. matches_with_stats states the coverage. Ratios are null where the denominator is zero. |
| span | object | – | Career span inside the archive. |
No examples provided.
get_archive_match Archive result detail ~77
One result from the results archive (1968 to 2022), with per-match serve statistics where the era recorded them. Stats are null for most rows before 1991, never synthesised. Requires the BASIC plan or any History plan.
| Name | Type | Req | Description |
|---|---|---|---|
| archive_match_id | integer | yes | Archive match id, as returned by search_archive_matches. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| result | object | – | The archive result. |
| stats | – | – | Per-match serve statistics (aces, double_faults, serve_points, first_in, first_won, second_won, serve_games, bp_saved, bp_faced). Null for most pre-1991 rows. |
No examples provided.
get_charting_match Charting: one match, every stat family ~105
Every charting 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 to 2026). Most of these matches have no counterpart in the live tables. Requires the ULTRA plan.
| Name | Type | Req | Description |
|---|---|---|---|
| charting_match_id | integer | yes | Charting match id, in its own id space. Not a match_id. |
| Name | Type | Req | Description |
|---|---|---|---|
| charting_match_id | number|null | – | The charted match. |
| families | object | – | Every stat family, per player, with the per-set split. |
| gender | string|null | – | – |
| mcp_id | string|null | – | The charting dataset's own row identifier. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| players | – | – | Both players as charted. |
No examples provided.
get_charting_player Charting: player career profile ~153
Career profile from shot-level charting data, summed over the player's charted matches. Serve placement (deuce/ad x wide/body/T), return depth and outcomes, net play, and clutch break/game/set-point serving. Also winners and errors by wing, and rally-length tendencies. COVERAGE IS CURATED, not full-slate: 11,646 charted matches back to the 1960s, concentrated on the majors. An ambiguous name returns the candidates to choose from. Requires the ULTRA plan.
| Name | Type | Req | Description |
|---|---|---|---|
| gender | string | – | Disambiguates a name charted on both tours. |
| name | string | yes | Player name fragment, min 3 chars. Must resolve to one charted person. |
| Name | Type | Req | Description |
|---|---|---|---|
| coverage | string|null | – | A reminder that charting coverage is curated, not full-slate. |
| families | object | – | Per-family summed numeric columns: raw sums over the player's charted Total rows. |
| matches_charted | number|null | – | The sample every summed field covers. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| player | – | – | The resolved charted player. |
No examples provided.
get_fixtures Fixture schedule ~95
Upcoming scheduled tennis fixtures, earliest first. This is the forward schedule, filterable by tour. Use this for "what is on this week". Works on the FREE plan (no card needed).
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum fixtures to return (1-200). |
| tour | string | – | Tour filter. Each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used. |
| Name | Type | Req | Description |
|---|---|---|---|
| fixtures | array | – | Scheduled fixtures, earliest first. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
No examples provided.
get_h2h Head-to-head ~157
The all-time record between two players, across BOTH halves of the product. That is the results archive (1968 to 2022) plus the completed matches from 2023 onward. Names are the keys. An ambiguous fragment returns the candidate list to choose from, and nothing is guessed. 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.
| Name | Type | Req | Description |
|---|---|---|---|
| player1 | string | yes | First player name (fragment, min 3 chars), e.g. "federer". |
| player2 | string | yes | Second player name (fragment, min 3 chars), e.g. "nadal". |
| Name | Type | Req | Description |
|---|---|---|---|
| by_surface | object | – | Decided wins per surface. The keys are surface names plus "unknown". |
| meetings | array | – | Individual meetings, newest first, capped at 200. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| players | – | – | The resolved names. Null when no player matches the fragments. |
| totals | object | – | The headline record. |
No examples provided.
get_live_matches Live matches ~174
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).
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| 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. |
| tour | string | – | Tour filter. Each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used. |
| Name | Type | Req | Description |
|---|---|---|---|
| matches | array | – | The live matches, most relevant first. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
No examples provided.
get_match Match detail ~74
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).
| Name | Type | Req | Description |
|---|---|---|---|
| match_id | integer | yes | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
| Name | Type | Req | Description |
|---|---|---|---|
| analysis | object | – | Model analysis. Requires the ULTRA plan, absent otherwise. |
| market | object | – | Match-winner market. Requires the PRO plan, absent otherwise. |
| match | object | – | The match. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
No examples provided.
get_match_analysis Model analysis ~85
Model analysis for a match: predicted win probability, the model's thesis and the main factors behind it. Requires the ULTRA plan. Match rows carry has_analysis, so check it first. A match with no thesis or profile has nothing to return.
| Name | Type | Req | Description |
|---|---|---|---|
| match_id | integer | yes | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| profile | object | – | Quantitative view. |
| thesis | object | – | Narrative view. |
No examples provided.
get_match_events Match timeline ~73
Timeline of events for a match: breaks, games won, sets won, momentum runs. Requires the PRO plan.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum events to return (1-200). |
| match_id | integer | yes | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
| Name | Type | Req | Description |
|---|---|---|---|
| events | array | – | Events, newest first, as the API returns them. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
No examples provided.
get_match_odds Match market prices ~101
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, so check it first. A match with no market mapped has no prices to return.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum price points to return (1-200). |
| match_id | integer | yes | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
| Name | Type | Req | Description |
|---|---|---|---|
| market | object | – | The match-winner market. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
No examples provided.
get_match_score Match score ~77
Current score for one match. This is the fastest read, with the lowest latency. Use it when you only need the score and already know the match id. Works on the FREE plan (no card needed).
| Name | Type | Req | Description |
|---|---|---|---|
| match_id | integer | yes | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| score | object | – | The current score. |
No examples provided.
get_match_statistics Match statistics ~133
In-play (or final) statistics for one match, in TWO families kept separate on purpose. DERIVED is rebuilt from the point-by-point record (holds/breaks, break points, service/return points). MEASURED is counted per match. It 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.
| Name | Type | Req | Description |
|---|---|---|---|
| match_id | integer | yes | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| statistics | object | – | The statistics. |
No examples provided.
get_player Player profile ~52
One player's profile: ranking, country, handedness, date of birth and cached stats. Works on the FREE plan (no card needed).
| Name | Type | Req | Description |
|---|---|---|---|
| player_id | integer | yes | Player id, as returned by search_players. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| player | object | – | The player. |
No examples provided.
get_player_rankings Player rankings as of a date ~177
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 one 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.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | YYYY-MM-DD. The record in force on this date. Omit for the latest known. |
| player_ids | array | yes | Roster player ids, as returned by search_players. Max 50. |
| system | string | – | Restrict to one system. Omit for every system held for the player. |
| Name | Type | Req | Description |
|---|---|---|---|
| coverage | – | – | What resolved against what was asked (players_resolved, systems_resolved, oldest_available per system). Read before trusting an empty result. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| rankings | array | – | One record per player × system held. |
No examples provided.
get_rankings Rankings listing ~166
The FULL published ranking table in rank order for one system, from 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.
| Name | Type | Req | 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 | yes | Ranking system to list. utr has no listing, because it is a rating, not a ranking. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| rankings | array | – | The table in rank order. |
No examples provided.
get_recent_results Recent results ~212
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| from | string | – | Earliest play date: YYYY-MM-DD (a whole UTC day) or ISO-8601 datetime. |
| 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. |
| to | string | – | Latest play date: YYYY-MM-DD or ISO-8601. Must not precede from. |
| tour | string | – | Tour filter. Each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used. |
| Name | Type | Req | Description |
|---|---|---|---|
| matches | array | – | Completed matches, most recent first. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
No examples provided.
get_tournament Tournament detail ~78
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).
| Name | Type | Req | Description |
|---|---|---|---|
| tournament_id | string | yes | Stable tournament id, as returned by search_tournaments or carried on a match as tournament_id. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| tournament | object | – | The tournament. |
No examples provided.
get_upcoming_matches Upcoming matches ~226
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).
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| from | string | – | Earliest play date: YYYY-MM-DD (a whole UTC day) or ISO-8601 datetime. |
| 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. |
| to | string | – | Latest play date: YYYY-MM-DD or ISO-8601. Must not precede from. |
| tour | string | – | Tour filter. Each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used. |
| Name | Type | Req | Description |
|---|---|---|---|
| matches | array | – | Matches due to start, soonest first. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
No examples provided.
player_stats Player record and splits ~309
One player's record over completed singles matches from 2023 onward, by default the last 365 days. It gives W/L overall, over the last 12 months and by surface, venue, level and season. It also gives tiebreaks, deciding sets, the record after winning or losing the first set, comebacks, withdrawals and the last N matches. Every count carries its sample size, and a percentage on an empty sample is null, never 0. On ULTRA it adds serve_return: measured serve and return statistics summed over the window. Singles only, so a doubles-team id is refused. For 1968 to 2022 use get_archive_career. Requires the PRO plan (serve_return requires ULTRA).
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | – | Window start: YYYY-MM-DD (start of that day) or a UTC ISO-8601 instant. Default to minus 365 days. |
| last | integer | – | How many recent matches to list, newest first (1-50, default 20). |
| level | string | – | The match tour. A match with no stated tour matches no level. |
| player_id | integer | yes | Player id, as returned by search_players. |
| surface | string | – | hard, clay or grass read the match surface; indoor keeps matches stated indoor, on any surface. |
| to | string | – | Window end: YYYY-MM-DD (the whole of that day) or a UTC ISO-8601 instant. Default now. |
| Name | Type | Req | Description |
|---|---|---|---|
| by_level | – | – | W/L keyed by match tour, or unknown. |
| by_season | – | – | W/L keyed by UTC calendar year. |
| by_surface | – | – | W/L keyed hard, clay, grass, unknown. |
| by_venue | – | – | W/L keyed indoor, outdoor, unknown. |
| last_12_months | – | – | W/L over the 12 months ending at the window end. |
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| overall | – | – | W/L over the window. |
| player | object | – | The player. |
| recent | array | – | The last N matches, newest first. |
| serve_return | – | – | ULTRA only, null below: summed serve and return statistics, each ratio as numerator/denominator/pct with its match count. |
| sets | – | – | Set-based record: sample, tiebreaks, deciding_sets, after_winning_first_set, after_losing_first_set, comebacks, sets. |
| window | object | – | The window applied, UTC. |
| withdrawals | – | – | Retired / walkover / default, each as given (this player) and received (the opponent). |
No examples provided.
search_archive_matches Results archive (1968–2022) ~264
Search the results archive: completed-match RESULTS from 1968 through 2022. ATP and WTA, main draws, qualifying and the ITF/futures tiers. Each record has winner and loser, final score, and 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 the current results (get_recent_results) begin. Requires the BASIC plan or any History plan.
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | – | Earliest tournament START date, YYYY-MM-DD. |
| level | string | – | 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). |
| player_name | string | – | Case-insensitive fragment of EITHER player's name, min 3 chars, e.g. "borg". |
| round | string | – | Round code, e.g. F for finals. |
| to | string | – | Latest tournament START date, YYYY-MM-DD. |
| tour | string | – | atp or wta. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| results | array | – | Archive results, newest tournament first. |
No examples provided.
search_archive_players Archive player bios ~136
The people of the results archive (1968 to 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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum players to return (1-200). |
| query | string | yes | Full or partial player name, min 3 chars, e.g. "navratilova". |
| tour | string | – | atp or wta. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| players | array | – | Matching archive people, ordered by name. |
No examples provided.
search_players Search players ~76
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).
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum players to return (1-200). |
| query | string | yes | Full or partial player name, e.g. "alcaraz". |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| players | array | – | Matching players, best match first. |
No examples provided.
search_tournaments Tournament catalogue ~101
Search the tournament catalogue. Its ids are the tournament_id that match objects carry. Returns surface, indoor, host city/country and category where curated. Works on the FREE plan (no card needed).
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum tournaments to return (1-200). |
| query | string | – | Full or partial tournament name, e.g. "wimbledon". Omit to list all. |
| tour | string | – | Restrict to one tour. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable summary of the result, safe to relay to the user verbatim. |
| ok | boolean | yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network erro… |
| tournaments | array | – | Matching tournaments, name order. |
No examples provided.
How do I install the io.github.livetennisapi/livetennisapi-mcp server?
io.github.livetennisapi/livetennisapi-mcp runs locally as an npm package, launched with npx -y livetennisapi-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · livetennisapi-mcp
claude mcp add livetennisapi-livetennisapi-mcp -- npx -y livetennisapi-mcp
What is the io.github.livetennisapi/livetennisapi-mcp server?
io.github.livetennisapi/livetennisapi-mcp is listed in the public MCP registry as io.github.livetennisapi/livetennisapi-mcp. Live tennis scores, players, rankings, odds and win-probability. ATP, WTA, Challenger, ITF, juniors. This page covers its npm package (livetennisapi-mcp).
Is the io.github.livetennisapi/livetennisapi-mcp server safe to use?
io.github.livetennisapi/livetennisapi-mcp scores 90 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 5 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.livetennisapi/livetennisapi-mcp server expose?
io.github.livetennisapi/livetennisapi-mcp exposes 25 tools: get_live_matches, get_upcoming_matches, get_match, get_match_score, search_players, and 20 more. Their descriptions and schemas cost roughly 3,263 tokens of context every time the server is loaded.
Is the io.github.livetennisapi/livetennisapi-mcp server still maintained?
io.github.livetennisapi/livetennisapi-mcp is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.livetennisapi/livetennisapi-mcp server under?
io.github.livetennisapi/livetennisapi-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.