# AcesAPI MCP Server

13 tennis data tools for AI assistants. ATP and WTA tennis since 2007: set scores, draws, players, rankings, head to head, surface Elo. All tools return structured output schemas for reliable parsing.

## Server URL

```
https://mcp.acesapi.com/mcp?key=YOUR_API_KEY
```

Transport: Streamable HTTP

## Get an API Key

1. Sign up at https://acesapi.com/signup (free, 500 credits included)
2. Go to https://acesapi.com/dashboard/keys
3. Create a key (starts with `sk_live_`)

## Setup

### Claude Code

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

### Claude Desktop

Add to config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):

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

### Cursor

Add to `.cursor/mcp.json`:

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

### VS Code (GitHub Copilot)

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "acesapi": {
      "type": "streamable-http",
      "url": "https://mcp.acesapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### Cline

Settings > MCP Servers > Add Remote Server:
- Name: `acesapi`
- URL: `https://mcp.acesapi.com/mcp?key=YOUR_API_KEY`

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "acesapi": {
      "serverUrl": "https://mcp.acesapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

## Available Tools

| Category | Tools | Credits |
|----------|-------|---------|
| Static reference | list_tournaments, search_players | 1 |
| Basic lookup | get_tournament, get_matches, get_schedule, get_match, get_rankings, get_ratings | 2 |
| Multi-table | get_head_to_head, get_surface_splits, get_player_stats | 3 |
| Stats + aggregation | get_player, get_player_matches | 5 |

## Pricing

500 free credits on signup. Plans from $19/mo at https://acesapi.com/dashboard/billing.

## Documentation

Full API docs: https://acesapi.com/docs
MCP setup guide: https://acesapi.com/docs#claude-desktop