# Livetennisapi MCP (MCP server)

> Livetennisapi MCP is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Live tennis scores, players, rankings, odds and win-probability. It has 152 GitHub stars, is released under the MIT license and runs locally with npx -y livetennisapi-mcp.

Give Claude, Cursor, Zed or any MCP client live tennis scores, players and fixtures — for ATP, WTA, Challenger, ITF and juniors. Odds, rankings, match statistics, charting and model win-probability tools are included, and require the PRO and ULTRA plans.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/livetennisapi/livetennisapi-mcp |
| GitHub stars | 152 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio, streamable-http |
| Packages | npm: livetennisapi-mcp |
| Remote URL | https://mcp.livetennisapi.com/mcp |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code, Claude.ai, ChatGPT |
| Category | Other |
| Latest release | v1.5.0 (Sep 14, 2026) |
| Last commit | Oct 7, 2026 |
| MCP registry name | io.github.livetennisapi/livetennisapi-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env LIVETENNISAPI_KEY=your-value --transport stdio livetennisapi-mcp -- npx -y livetennisapi-mcp
```

### Cursor (.cursor/mcp.json)

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

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "livetennisapi_key",
      "description": "LIVETENNISAPI_KEY",
      "password": true
    }
  ],
  "servers": {
    "livetennisapi-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "livetennisapi-mcp"
      ],
      "env": {
        "LIVETENNISAPI_KEY": "${input:livetennisapi_key}"
      }
    }
  }
}
```

### Claude Code (remote)

```sh
claude mcp add --transport http livetennisapi-mcp "https://mcp.livetennisapi.com/mcp"
```

The same server is also hosted as a remote MCP endpoint, so nothing runs on your machine.

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `LIVETENNISAPI_KEY` (secret): Your Live Tennis API key (twjp_...). Get one free, no card, at https://livetennisapi.com/subscribe/free — the server runs without it but only the status check…

## Tools

- `get_live_matches`: Matches in progress, with live scores
- `get_upcoming_matches`: Matches starting soon
- `get_match`: Full detail for one match
- `get_match_score`: Current score only — the smallest payload
- `search_players`: Find players by name
- `get_player`: Profile, ranking, country, handedness
- `get_fixtures`: Forward schedule
- `search_tournaments`: Tournament catalogue — surface, location, category
- `get_tournament`: One tournament by its stable id
- `get_recent_results`: Completed matches and winners
- `search_archive_matches`: Results archive (1968–2022) — historical results with ranks and seeds at the time
- `get_archive_match`: One archive result, with serve stats where the era recorded them
- `search_archive_players`: Archive bios — hand, DOB, career-high rank
- `get_archive_career`: Career W-L, titles and serve aggregates over the archive
- `get_h2h`: Cross-era head-to-head — archive + current, one record
- `get_match_events`: Breaks, games, sets, momentum runs
- `get_match_odds`: Match-winner prices — bid / ask / mid
- `get_rankings`: Full published ranking table per system (ATP, WTA, ITF circuits), any week
- `get_player_rankings`: Point-in-time ranking records for specific players, as of any date
- `get_match_statistics`: In-play statistics — aces, serve split, hold/break %, break points
- `get_charting_player`: Career shot-level profile from the Match Charting Project
- `get_charting_match`: One charted match, every stat family, per-set split
- `get_match_analysis`: Model thesis, win probability, key factors
- `check_api_status`: Reachability + which plan your key is on

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/livetennisapi-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.