Server data from the Official MCP Registry
Zero-clone ATP tennis analytics: 200k+ matches since 1968, H2H, GSDI, NBI, and shot charting.
About
Zero-clone ATP tennis analytics: 200k+ matches since 1968, H2H, GSDI, NBI, and shot charting.
Security Report
Valid MCP server (1 strong, 3 medium validity signals). 4 known CVEs in dependencies Package registry verified. Imported from the Official MCP Registry.
4 files analyzed ยท 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: TML_DATA_DIR
Environment variable: TENNIS_MCP_CACHE_DIR
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"tennis-mcp": {
"command": "uvx",
"args": [
"tennis-mcp==0.1.1"
],
"env": {
"TML_DATA_DIR": "your-tml-data-dir-here",
"TENNIS_MCP_CACHE_DIR": "your-tennis-mcp-cache-dir-here"
}
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
๐พ tennis-mcp
Zero-clone Model Context Protocol (MCP) server for Open Era ATP tennis.
Query 200,105 ATP matches (1968โ2026), 7,622 player careers, 113,744 surface-split head-to-heads, 7,663 Match Charting Project shot/rally breakdowns, and curated dominance/drama indices (GSDI, NBI, Race to Greatness, Young Guns) directly inside Claude, Cursor, Antigravity, or VS Code โ without cloning the 265 MB data repo.
โก Quick Start (Zero Clone)
tennis-mcp runs via uvx (or pip install tennis-mcp) and lazily caches only the Parquet/JSON tables your questions need into ~/.cache/tennis-mcp/.
Claude Desktop / Cursor / Antigravity (mcpServers)
{
"mcpServers": {
"tennis-mcp": {
"command": "uvx",
"args": ["tennis-mcp"]
}
}
}
Claude Code (CLI)
claude mcp add tennis-mcp -- uvx tennis-mcp
VS Code (.vscode/mcp.json)
{
"servers": {
"tennis-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["tennis-mcp"]
}
}
}
pip Install / Offline tml-data Override
If you prefer pip or already cloned sorukumar/tml-data, install from PyPI and optionally point TML_DATA_DIR at your local data directory:
pip install tennis-mcp
TML_DATA_DIR=/path/to/tml-data/data tennis-mcp
๐ Available MCP Capabilities
15 Tools (Powered by DuckDB + Parquet + Story JSONs)
| Category | Tool | What It Queries |
|---|---|---|
| Warehouse | get_dataset_overview | Live row counts, date window, charting counts, and licenses |
| Players | search_players | Filter 7,622 ATP careers by name, country IOC code, or Slam champion status |
| Players | get_player_profile | Career W-L, surface splits, Top 10 win%, recent matches, and MCP charting profile |
| Rivalries | get_head_to_head | Surface-by-surface H2H breakdown (113,744 pairs) + individual match logs |
| Matches | search_matches | Parameterized SQL search over 200,105 enriched ATP matches |
| Shot / Rally | get_charting_profile | 475 players' serve/return, rally length (1โ3 / 4โ6 / 7โ9 / 10+), UF rate, Serve+1, and surface splits |
| Shot / Rally | get_match_charting_stats | Per-match winners, unforced errors, rally distributions across 7,663 charted matches |
| Compare | compare_players | Side-by-side comparison of 2โ6 players across career stats, charting, and age snapshots |
| Indices | get_gsdi_rankings | Grand Slam Dominance Index (231 title runs) |
| Indices | get_nail_biters | Nail-Biter Index (687 Grand Slam Finals & Semifinals) |
| Indices | get_greatness_race | Age-for-age title & Slam pace: Big 3, Alcaraz, Sinner, Borg, Sampras, McEnroe, Lendl, Agassi |
| Indices | get_young_guns_race | Fonseca, Mensik, Tien, Jodar benchmarked against Alcaraz & Sinner |
| Indices | get_gs_breakthrough | Career age, matches, and years before first Grand Slam title across 59 champions |
| Geography | get_country_profile | Top 100 / Top 10 ATP evolution across 50 years by IOC code or snapshot year |
| India | get_indian_tennis_stats | Open Era Indian ATP singles milestones & histories |
7 Resources (tennis://*)
tennis://overview,tennis://gsdi/top,tennis://nbi/top,tennis://greatness/summary,tennis://young-guns/summary,tennis://global/timeline,tennis://indian/notable
3 Prompt Templates
scouting_report(player_name)rivalry_breakdown(player1, player2)slam_campaign_audit(player_name, tournament)
๐ฌ Example Questions You Can Ask Your AI
- "Compare Jannik Sinner and Carlos Alcaraz on 1st-serve won%, unforced error rate, and Clay charting metrics."
- "Show me Novak Djokovic vs Rafael Nadal head-to-head by surface, plus their highest Nail-Biter Index Slam matches."
- "Which players won a Grand Slam with the fewest tour matches before their first major?"
- "How does Joao Fonseca at age 18โ20 track against Carlos Alcaraz in ATP wins and Top 50 wins?"
- "List the top 5 Grass-court Grand Slam comebacks since 2000 sorted by comeback score and duration."
๐ Architecture
Claude / Cursor / Antigravity / VS Code
โ (stdio MCP)
โผ
tennis-mcp (Python + FastMCP/MCPServer + DuckDB)
โ
โโโ TML_DATA_DIR set? โโโถ Local tml-data/data/*.parquet + *.json
โ
โโโ Otherwise โโโโโโโโโโโถ Lazy cache (~/.cache/tennis-mcp/, 7-day TTL)
fetched via HTTPS from sorukumar/tml-data
๐ License & Data Attribution
- Code: MIT License (LICENSE)
- ATP Match & Career Warehouse (
sorukumar/tml-data): Built on Tennismylife / TML-Database and Jeff Sackmann's ATP archive (MIT). - Match Charting Project Tables (
mcp_*.parquet): Derived from Jeff Sackmann's Match Charting Project, licensed under CC BY-NC-SA 4.0 (attribution required; non-commercial share-alike for charting tables).
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto ยท Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai ยท Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci ยท Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol ยท Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno ยท Developer Tools
Toleno Network MCP Server โ Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace ยท Developer Tools
Search and install MCP servers from inside your AI client.
