Live Tennis API MCP
livetennisapi-mcp is an MCP server that gives AI assistants like Claude, Cursor, and Zed access to live tennis data from the Live Tennis API. It solves the problem of integrating real-time scores, player info, and historical results into AI workflows. It is for developers building AI-powered tennis applications or assistants.
✨ Key features
- Live scores, upcoming matches, and full match details
- Player search and profile with ranking and country
- Historical results archive (1968–2022) and head-to-head
- In-play statistics, odds, and model win probability (PRO/ULTRA)
- Tier-aware error messages instead of cryptic 403s
- Works via stdio or hosted HTTP endpoint
🎯 Use cases
- Ask an AI assistant for live tennis scores and match details
- Build a tennis dashboard that shows current matches and results
- Query historical player careers and head-to-head records
- Integrate tennis odds and model analysis into betting tools
- Create a chatbot that answers tennis trivia from the archive
📦 Installation
🧰 Requirements: Requires Node 20+ and a free API key from livetennisapi.com (no card required).
Claude Code
claude mcp add livetennis -e LIVETENNISAPI_KEY=twjp_… -- npx -y livetennisapi-mcp
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"livetennis": {
"command": "npx",
"args": ["-y", "livetennisapi-mcp"],
"env": { "LIVETENNISAPI_KEY": "twjp_…" }
}
}
}
Cursor / Zed / others
Same command, same env var. No install step; npx fetches it on demand.
Get a free key (no card) at livetennisapi.com.
🚀 Usage
Once configured, you can ask your MCP client questions like:
"What tennis matches are live right now?" "Who's winning the Alcaraz match, and what does the model give him?" "Show me Sinner's ranking and recent results."
For a direct API call from the Messages API, see the README example.
⚠️ Good to know
The free plan is limited to 100 requests/day, and some tools require BASIC, PRO, or ULTRA plans.
❓ FAQ
How do I get an API key?
You can get a free API key (no card required) at https://livetennisapi.com/subscribe/free.
What are the rate limits?
Free plan allows 30 requests per minute and 100 requests per day. Higher plans have higher limits.
Is the server read-only?
Yes, every tool is a GET; nothing can modify anything.
Can I use it with Codex?
Yes, you can add it with codex mcp add livetennisapi --url https://mcp.livetennisapi.com/mcp --bearer-token-env-var LIVETENNISAPI_KEY.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.