AcesAPI MCP server

AcesAPI MCP server

The tennis data API. ATP and WTA singles matches with every set and tiebreak score, tournament draws round by round, player profiles, weekly rankings, head to head, surface splits, our own Elo by surface, and sportsbook moneylines on Grand Slam and Masters / WTA 1000 matches. REST API and MCP server. 500 free credits every month, no card.

Website: https://acesapi.com · Docs: https://acesapi.com/docs · Get a key: https://acesapi.com/signup

You:    "What is Carlos Alcaraz's record on clay against top-10 players?"
Claude: [calls get_surface_splits]

You:    "Who leads the Sinner and Alcaraz head to head, and how many of their meetings were finals?"
Claude: [calls get_head_to_head]

You:    "Which moneylines were posted for the 2025 US Open men's final?"
Claude: [calls get_matches, then get_match]

Skills

This repo also ships 16 free Claude skills in skills/ that turn Claude into a tennis analyst on top of the tools below: match and player lookup, surface Elo, head to head, ranking history, set-score modeling, odds math, edge detection and backtesting. They call the AcesAPI tools and keep to what the data holds (no serve statistics, moneylines on Slams, Masters and WTA 1000 only).

git clone https://github.com/noahowsh/acesapi-mcp.git

Or install them as a Claude Code plugin:

/plugin marketplace add noahowsh/acesapi-mcp
/plugin install acesapi-skills@acesapi

Or with the skills CLI: npx skills add noahowsh/acesapi-mcp.

Point Claude at the skills/ folder, add the MCP server (see Quick start), and ask a question such as "who is favored in tomorrow's Shanghai match and why?". Full catalog: skills/README.md. The skills also work on your own CSV or JSON without a key.

Useful pages

• Docs: every endpoint with parameters and live examples
• Tennis odds: upcoming ATP and WTA matches with each sportsbook's moneyline
• Data atlas: what exists and where coverage is partial
• Guides: Python walkthroughs for surface Elo, head to head, rankings, set scores and surface splits
• Data: results, rankings history, odds history
• Pricing: credits per call, 500 free every month
• Surface Elo explained
• Compare: API Tennis, ESPN's tennis feed, Sportradar, SportsDataIO

Quick start

This is a hosted (remote) MCP server over Streamable HTTP. There is nothing to install.

Claude Code

claude mcp add --transport http acesapi "https://mcp.acesapi.com/mcp?key=YOUR_API_KEY"

Claude Desktop, Cursor and other clients

{
  "mcpServers": {
    "acesapi": {
      "url": "https://mcp.acesapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

The key can also be sent as an x-api-key header or Authorization: Bearer. Connecting and listing tools works without a key; calling a tool needs one.

REST

curl -X POST https://mcp.acesapi.com/v1/list_tournaments -H "x-api-key: YOUR_API_KEY"

Every tool is POST /v1/{tool} with a JSON body.

Examples

Runnable Python (standard library only) and Node 18+ (no dependencies) examples live in examples/:

Shortened. The full README is on GitHub.