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 by default, private, revocable in one tap.

See available tools
Read-only by defaultRevoke anytimeNo contact details returned

What you can ask

Ask in your own words. Answers come from your real Ace data.

"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 city on Ace, with the booking link ready to tap.

Level change, explained

The numbers behind the change.

Why did my level drop on April 14?

You played a single set against opponents averaging level 4.2, which is 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 moved your level from 3.62 to 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 right away because 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 and ask about your matches, your level, or your community.

Configuration

Pick your tool, copy the snippet, 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 "https://www.aceplay.app/mcp" --header "Authorization: Bearer YOUR_KEY_HERE"

Replace YOUR_KEY_HERE with the key from the app.

Available tools

Read your Ace data. With your permission, join or leave matches and lessons, book or cancel a court, and create or link an open match.

Read access is on by default. Booking actions and profile changes need bookings:write. Joining or leaving lessons needs lessons:write. Joining, leaving, or creating matches needs matches:write. Linking a booking to an existing match needs both booking and match permissions.

Before each change, your AI client must show the details and ask for your explicit agreement in chat. The client is responsible for collecting that agreement.

If online payment is required, pay for a court through the FullClub checkout link or a lesson through the Ace checkout link. You never pay in chat.

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_join_match

Preview, then join an open match, request approval, or go on Stand by after you agree. The confirmed call must echo the preview facts unchanged. Stand by only sends notifications. Requires matches:write.

ace_leave_match

Preview, then leave a match, withdraw your request, or leave Stand by after you agree. The confirmed call must echo the preview facts unchanged. Some exits must finish in Ace. Requires matches:write.

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_search_coaches

Find coaches by city, club, sport, or name.

ace_get_coach

See a coach's public profile and reviews. Contact details stay private.

ace_search_open_lessons

Find open lessons by date, club, sport, or level.

ace_get_lesson

See lesson details and the number of occupied spots. Other players stay private.

ace_get_my_lessons

See your upcoming or past lessons.

ace_join_lesson

Preview, then join a lesson or send an approval request after you agree. A request does not reserve a place. Paid lessons return an Ace checkout link. Requires lessons:write.

ace_leave_lesson

Preview, then leave a lesson or withdraw your request after you agree. The coach’s cancellation rules still apply. Requires lessons:write.

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?'

ace_list_bookable_clubs

Find clubs where you can book a court through Ace, with booking rules and FullClub links.

ace_get_club_availability

Check available courts, exact times and prices for a club on a local date.

ace_hold_court

Temporarily hold your chosen court at its exact time and price. Requires bookings:write and a complete booking profile. The booking still needs confirmation or payment.

ace_confirm_booking

Confirm your held court after you agree to the details. Requires bookings:write. If online payment is required, finish through the FullClub checkout link.

ace_release_hold

Release your temporary court hold. Requires bookings:write.

ace_cancel_booking

Cancel your booking after you agree to the details, under the club’s cancellation and refund rules. Requires bookings:write.

ace_get_my_bookings

See your upcoming or past FullClub bookings and their booking links.

ace_get_booking

Read one of your bookings, including its price, payment state and cancellation rules.

ace_set_booking_profile

Save your first name, last name, phone and email for future FullClub bookings after you confirm all four values. Requires bookings:write. MCP never returns or logs these contacts.

ace_create_match

Publish an open padel match after you agree to its details. Requires matches:write. This does not reserve a court.

ace_create_match_from_booking

Create an open Ace match from your confirmed FullClub booking after you agree to the details. Requires matches:write.

ace_link_booking_to_match

Preview and link your confirmed booking to your existing compatible open match after you agree to the details. Requires both bookings:write and matches:write.

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 it and generate a new one.

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. Claude can also connect by signing in to Ace, with no key to copy.

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 default

No contact details returned

Your AI client sees booking contacts entered in chat. It sends them to MCP for saving only after you confirm. MCP never returns or logs them. Your key can edit only your own booking profile, and other players' contacts are never returned or readable. Venue addresses are public business info and are shared.

No location data

No coordinates, no IPs, no device IDs.

Key permissions

With your permission, join or leave matches, book or cancel a court, save your booking profile, and create or link an open match. These permissions let your AI act for you. Before each change, your AI client must show the exact details and ask for your explicit agreement. Confirmation depends on the client. If the club requires online payment, finish checkout in FullClub.

You're in control

Generate, revoke, or replace your key from your Profile, anytime.

Ready to plug in?

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