# livetennisapi-mcp

livetennisapi-mcp connects an AI coding client to live tennis scores, player data, fixtures and rankings. Use it to check matches in progress or look up past results.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 126 repo stars
- Author: livetennisapi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/livetennisapi/livetennisapi-mcp
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/livetennisapi-mcp

## What it does

The server connects Live Tennis API tools to an MCP client. An agent can find players and tournaments, check live matches and upcoming fixtures, and retrieve scores or details about completed matches. Historical results and head-to-head records are available too.

You need a `LIVETENNISAPI_KEY`. Some tools depend on the API plan: odds require PRO, while model-based win probabilities and match statistics require ULTRA. Your key determines which data you can access. `check_api_status` reports its plan.

In Claude Code, connect to the hosted HTTP server or run the package locally with `npx`. For a local setup, provide the API key as an environment variable. With HTTP, supply the key when making requests to the server.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.livetennisapi.com/mcp`
- Environment variables: `LIVETENNISAPI_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http livetennisapi-mcp https://mcp.livetennisapi.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env LIVETENNISAPI_KEY=<LIVETENNISAPI_KEY> --transport stdio livetennisapi-mcp -- npx -y livetennisapi-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add livetennisapi-mcp --url https://mcp.livetennisapi.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add livetennisapi-mcp --env LIVETENNISAPI_KEY=<LIVETENNISAPI_KEY> -- npx -y livetennisapi-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "livetennisapi-mcp": {
            "url": "https://mcp.livetennisapi.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "livetennisapi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "livetennisapi-mcp"
            ],
            "env": {
                "LIVETENNISAPI_KEY": "<LIVETENNISAPI_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "livetennisapi-mcp": {
            "type": "http",
            "url": "https://mcp.livetennisapi.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "livetennisapi-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "livetennisapi-mcp"
            ],
            "env": {
                "LIVETENNISAPI_KEY": "<LIVETENNISAPI_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http livetennisapi-mcp https://mcp.livetennisapi.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e LIVETENNISAPI_KEY=<LIVETENNISAPI_KEY> livetennisapi-mcp npx -y livetennisapi-mcp
```
Replace <…> with your own values

## When to use it
- check which tennis matches are live
- find a player and retrieve their ranking
- look up upcoming fixtures
- compare two players’ head-to-head record
- retrieve odds or match statistics when the API plan allows them

## Example prompts
- Show me the tennis matches happening right now.
- Find this player’s ranking and recent results.
- Check the odds and win probability for this match if my API plan includes those tools.

## Similar
- [sportscore-mcp](https://affpapa.org/en/nevibecode/mcp/sportscore-mcp.md) — MCP server · ★ 15 repo stars
- [discava – Business Directory for AI](https://affpapa.org/en/nevibecode/mcp/discava-business-directory-for-ai.md) — MCP server · 1940 installs
- [RallyIQ](https://affpapa.org/en/nevibecode/mcp/rallyiq.md) — MCP server
- [tennis-data](https://affpapa.org/en/nevibecode/skills/tennis-data.md) — skill · 771 installs
- [pp-digg](https://affpapa.org/en/nevibecode/skills/pp-digg.md) — skill · 410 installs
- [NessFlow](https://affpapa.org/en/nevibecode/mcp/nessflow.md) — MCP server · ★ 2 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
