Ace MCP server

Your padel data, in your AI

Plug Ace into Claude, ChatGPT, or any MCP-compatible AI. Ask why your level changed, find a match for tonight, summarise your last 10 games. Read-only, private, revocable in one tap.

See available tools
Read-onlyRevoke anytimeNo contact info shared

What you can ask

Real questions. Real data. Real answers.

"Why did my level drop?"

Claude reads your last matches and the rating mechanics, then tells you exactly what moved.

"Find me a match this Saturday"

Search open matches near your level, in your sport, in your area.

"Summarize my last 10 matches"

Wins, losses, partners, opponents, rating changes. One paragraph.

"Who's that player I keep losing to?"

Look up any player by name. Get their level and match count.

"What's coming up this week?"

List your upcoming matches, tournaments, and unread notifications.

"Explain how Ace's rating works"

Get a plain-text explainer of the TrueSkill model in your language.

"What padel courts are in Prague?"

Search venues by city. Get addresses, websites, online booking links, prices, and indoor/outdoor info.

"Where can I play in Brno tonight?"

Pull up clubs in any Czech or Slovak city, with the booking link ready to tap.

Level change, explained

Real numbers. Real mechanics. Not vibes.

Why did my level drop on April 14?

You played a single set against opponents averaging level 4.2 - higher than your 3.6 - and lost 6-3. Because Ace uses the single-set 0.6x dampening factor, the raw mu update was scaled down. Your mu fell from 25.10 to 24.78 (-0.32), and sigma dropped from 3.85 to 3.78 (the system is more confident in you). That mapped to level 3.62 -> 3.55 (-0.07). The per-match cap of 0.55 wasn't hit, so this was the standard TrueSkill update.

Powered by ace_explain_rating_system + ace_get_rating_constants + ace_get_my_recent_matches.

Three steps

From zero to talking to your data.

  1. 1

    Generate your key

    Open Ace, go to Profile, tap MCP Server. Hit Generate. Copy it once - we mask it after you leave.

  2. 2

    Add it to your AI

    Paste the snippet into Claude Desktop config, or run the one-liner in Claude Code.

  3. 3

    Ask anything

    Open Claude. Ask about your matches, your level, your community. Done.

Configuration

Pick your tool. Copy. Paste your key.

Claude Desktop

Add this to claude_desktop_config.json, then restart Claude.

{
  "mcpServers": {
    "ace": {
      "url": "https://www.aceplay.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY_HERE"
      }
    }
  }
}
Claude Code

Run this in your terminal.

claude mcp add ace --transport http --url "https://www.aceplay.app/mcp" --header "Authorization: Bearer YOUR_KEY_HERE"

Replace YOUR_KEY_HERE with the key from the app.

Available tools

Thirteen read-only tools the AI can call on your behalf.

ace_get_my_profile

Your profile summary: name, level, country, matches played.

ace_get_my_recent_matches

Your last 50 matches in the past 90 days, with rating deltas.

ace_get_my_upcoming_matches

Matches you've joined but haven't played yet.

ace_get_my_rating_history

Your level over time. Up to a year of history.

ace_get_my_notifications

Your last 20 notifications.

ace_search_open_matches

Find joinable matches by date, sport, level, or area.

ace_search_players

Look up players by name. Returns level and match count only.

ace_get_my_communities

Communities you're part of.

ace_get_my_tournaments

Tournaments you've joined, with your record.

ace_search_venues

Search padel/tennis venues by city, sport, or name. Returns address, website, booking link, price, court type, phone, and map coordinates.

ace_get_venue

Full details for a single venue by id. Use after a search to answer follow-ups like indoor/outdoor or how to book.

ace_explain_rating_system

Plain-text explainer of how Ace's TrueSkill rating works.

ace_get_rating_constants

Live TrueSkill numbers plus a plain-language glossary and a how-to-explain guide. One call, everything Claude needs to answer 'why did my level change?'

Authentication

Each player gets one personal API key. Generated server-side, hashed before storage, shown to you exactly once. Use it in any MCP-compatible AI client. Lost it? Revoke and regenerate. Done.

One key per player

Stored as a SHA-256 hash. The plaintext key never lives in our database.

Revoke anytime

One tap in the app. Old key stops working instantly.

Bearer token auth

Standard HTTP Authorization header. No OAuth dance, no extra setup.

Rate limits

60 requests per minute

A soft cap for bursts. Plenty for normal AI use.

200 requests per day

Hard cap. Resets at midnight UTC. Need more? Reach out.

Privacy

Read-only by design. No surprises.

No player contact info, ever

Email, phone, home address. Never returned for any player by any tool. Venue addresses are public business info and are shared.

No location data

No coordinates, no IPs, no device IDs.

Read-only access

The AI can read. It cannot create, edit, or delete anything in your Ace account.

You're in control

Generate, revoke, regenerate. All from your Profile screen, anytime.

Ready to plug in?

Open Ace, generate your key, copy the snippet. Two minutes.