A Model Context Protocol server that provides LLM agents (Claude, Cursor, Zed) with live tennis scores, player info, odds, and model win-probabilities for ATP, WTA, Challenger, and ITF tournaments via the Live Tennis API.

Stars

214

7-day growth

-35

Forks

84

Open issues

0

License

MIT

Last updated

2026-07-26

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It bridges real-time tennis data into AI assistants through the standardized MCP interface, with tier-aware error handling that returns actionable explanations instead of cryptic errors.

Who it is for

  • Developers building AI-powered tennis assistants or chatbots
  • Tennis enthusiasts who want live stats via natural language
  • Sports betting platforms needing programmatic odds and analysis
  • LLM users using tools like Claude Code or Cursor who want live sports data

Use cases

  • Query live scores and match details during a tournament
  • Search for player rankings, profiles, and recent results
  • Retrieve match odds and model win probability for analysis
  • Integrate tennis data into an AI agent's workflow for commentary or decision support

Strengths

  • Read-only and secure: API key stays local on the user's machine for the stdio server
  • Zero install: npx fetches the server on demand without manual setup
  • Tier-aware responses: endpoints return clear messages when a paid plan is required, avoiding model confusion
  • Comprehensive coverage: live matches, upcoming fixtures, player search, odds, events, and model analysis across multiple tournament levels

Considerations

  • Requires Node.js 18+ and an API key (free tier available, but some features need paid plans)
  • HTTP endpoint has rate limiting (60 req/min anonymous, 300 keyed) and multi-tenant design may add latency
  • Limited to tennis only; no other sports are supported

README quick start

livetennisapi-mcp

MCP server for the Live Tennis API.

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

Documentation · Get a free API key


Setup

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, or a paid plan at pricing.

Try it

"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." "What are the current odds on match 18953?"

Tools

ToolDoesPlan
get_live_matchesMatches in progress, with live scoresFREE
get_upcoming_matchesMatches starting soonFREE
get_matchFull detail for one matchFREE
get_match_scoreCurrent score only — fastest readFREE
search_playersFind players by nameFREE
get_playerProfile, ranking, country, handednessFREE
get_fixturesForward scheduleFREE
get_recent_resultsCompleted matches and winnersBASIC
get_match_eventsBreaks, games, sets, momentum runsPRO
get_match_oddsMatch-winner prices — bid / ask / midPRO
get_match_analysisModel thesis, win probability, key factorsULTRA
check_api_statusReachability + which plan your key is on

Tier awareness

The API gates endpoints by plan and returns a bare 403 {"error":"upgrade_required"}. Handed that, a model will usually invent a reason or retry pointlessly.

So every tool that can hit a tier wall returns a plain-English explanation

Description

MCP server for the Live Tennis API — give Claude, Cursor and other LLM agents real-time tennis scores, odds and model win-probability

Related repositories

Similar projects matched by category, topics, and programming language.

0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577
OneInterface
Featured
OneInterface GitHub avatar

stormy-cookbook

Stormy Cookbook provides copy-pasteable recipes for using the Stormy Social Data API and MCP server, which offers a unified REST API and MCP tools to search profiles, posts, and emails across TikTok, YouTube, Instagram, LinkedIn, X, and Reddit through a single HTTP contract.

AI & Machine LearningLarge Language Models
72
makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958