# livetennisapi/livetennisapi-mcp [Health: Active]

**Category:** 🏃 Sports  
**Repository:** https://github.com/livetennisapi/livetennisapi-mcp  
**GitHub Stars:** 147  
**npm Downloads (last month):** 0  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/livetennisapi-livetennisapi-mcp

## Description
Real-time tennis for ATP, WTA, Challenger and ITF — live scores, players, fixtures, model win-probability, and match-winner market prices. 12 read-only tools; a plan wall returns a plain-English explanation instead of a bare 403. Free tier, no card. npx -y livetennisapi-mcp

## Tools
Capabilities this server exposes over MCP:

- **get_live_matches** — 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).
- **get_upcoming_matches** — 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).
- **get_match** — 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).
- **get_match_score** — 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).
- **search_players** — 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).
- **get_player** — One player's profile: ranking, country, handedness, date of birth and cached stats. Works on the FREE plan (no card needed).
- **get_fixtures** — 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).
- **search_tournaments** — 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).
- **get_tournament** — 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).
- **get_recent_results** — 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.
- **search_archive_matches** — 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.
- **get_archive_match** — 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.
- **search_archive_players** — 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.
- **get_archive_career** — 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_h2h** — 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_match_events** — Timeline of events for a match — breaks, games won, sets won, momentum runs. Requires the PRO plan.
- **get_match_odds** — 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.
- **get_rankings** — 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_match_analysis** — 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.
- **get_player_rankings** — 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_match_statistics** — 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_charting_player** — 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_charting_match** — 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.
- **check_api_status** — 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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "livetennisapi-mcp": {
    "command": "npx",
    "args": ["-y","livetennisapi-mcp"],
    "env": {
      "LIVETENNISAPI_KEY": ""
    }
  }
}
```

**Requires environment variables:** `LIVETENNISAPI_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What livetennisapi/livetennisapi-mcp does

livetennisapi/livetennisapi-mcp MCP server exposes the Live Tennis API to AI clients as read-only tools. The data covers ATP, WTA, Challenger, ITF, and junior competitions. Core tools list matches in progress, matches starting soon, current scores, player profiles, tournament records, and the forward fixture schedule.

The server also supports completed results and historical research. BASIC or History access provides recent results, a 1968–2022 results archive, archive player records, career summaries, and cross-era head-to-head data. PRO access adds match events, match-winner prices, and full published ranking tables. ULTRA access adds model win probabilities, match statistics, point-in-time player rankings, and Match Charting Project data for players and individual matches.

## How it works

A client calls named MCP tools, and the server sends requests to the Live Tennis API using the configured key. Tools that need an identifier can use values returned by earlier searches: for example, search_players returns a player id for get_player, while tournament and match objects expose ids used by detail tools.

Archive player ids are separate from current roster ids. The archive covers completed results from 1968 through 2022, while the service’s own recent results begin in 2023. get_h2h combines both periods. Historical and point-in-time queries preserve the requested date boundary rather than substituting a newer record.

Plan restrictions are returned as plain-English results rather than only a bare authorization error. check_api_status reports reachability and the plan associated with the configured key. Responses can also expose rate-limit information; the documented quotas vary by plan, from 100 requests per day on FREE to 500,000 on ULTRA.

## Setup and configuration

Run the local server with Node.js and npx:

```bash
npx -y livetennisapi-mcp
```

Set the `LIVETENNISAPI_KEY` environment variable to an API key before starting it. A free key is available without a payment card. Claude Code can register the command with `claude mcp add`; Claude Desktop, Cursor, Zed, and other MCP clients use the same command and environment variable configuration.

The hosted Streamable HTTP endpoint is `https://mcp.livetennisapi.com/mcp`. It accepts a bearer token, an `X-API-Key` header, or a `token` query parameter. Headers are preferable when the client supports them because query parameters place the key in the connector configuration. The hosted endpoint has its own per-caller transport limit, separate from the upstream API quota.

## Tools and capabilities

- Query live, upcoming, recent, and archived matches.
- Retrieve scores, match details, events, odds, statistics, and model analysis.
- Search current players, archive players, tournaments, and charted matches.
- Retrieve player profiles, rankings, career archive summaries, and head-to-head records.
- Inspect tournament metadata, fixtures, charting profiles, and historical serve data.
- Check API reachability and the configured subscription plan.

## Limitations and notes

The livetennisapi/livetennisapi-mcp MCP server does not provide every capability on every plan. FREE covers the core match, player, fixture, and tournament tools; BASIC or a History plan is needed for completed results and archive queries; PRO is needed for events, odds, and ranking tables; ULTRA is needed for analysis, detailed statistics, point-in-time player rankings, and charting.

Archive serve statistics are unavailable for many records before 1991 and are omitted rather than generated. Match Charting Project coverage is curated and concentrated on major events, not a complete tennis schedule. Measured match-statistic fields vary by tour and absent values are not filled with zeroes. FREE access is limited to 100 daily requests, so frequent polling requires attention to the selected plan and quota.

_Full upstream README: https://allmcps.com/mcp/livetennisapi-livetennisapi-mcp/readme_