Playtomic

Authentication (handled automatically)

Playtomic uses email + password to mint a ~1-hour JWT. The AnythingMCP LOGIN_TOKEN engine handles login, caching, and refresh:

1. POST https://api.app.playtomic.io/v3/auth/login with { email, password, requested_user_roles: ["ROLE_CUSTOMER"] }.
2. The response contains access_token (JWT, ~1h TTL) and refresh_token (~60d).
3. Every tool call attaches Authorization: Bearer <access_token>.
4. The engine proactively re-logs in 60 s before expiry and on any 401. Tokens are cached encrypted in the connector_auth_cache DB table.

Credentials

• PLAYTOMIC_EMAIL — your Playtomic account email.
• PLAYTOMIC_PASSWORD — your plain account password. Stored encrypted; only sent over TLS to Playtomic's login endpoint.

When dedicated tools are not enough

The 13 tools below cover the common Playtomic workflows. Anything not exposed (e.g. accepting a join request, creating a match, paying for a booking) requires Playtomic's mobile app — there is no documented public booking write API and we deliberately don't expose write endpoints.

Public vs full connector

If you only want to search clubs and check availability (no personal data), use the playtomic-public (Playtomic Lite) connector instead — the same 4 read tools with a lighter scope. It still needs a free Playtomic account, since Playtomic closed anonymous API access.

Pricing notes

• price is a string like "48 EUR" — parse amount + currency.
• The same start_time may appear with several duration values (60/90/120 min). These are alternative bookings of the same slot, not separate free slots.
• duration is in minutes.
• If your account has linked club memberships, pricing returned by playtomic_get_availability reflects your member discount.

Time handling

• local_start_min / local_start_max are naive ISO-8601 in the tenant's local timezone (see tenant.address.timezone, e.g. Europe/Berlin). For a full day use T00:00:00 → T23:59:59 on the same date.
• Match/course/tournament date filters use the same naive ISO format unless otherwise noted.

Joining availability to courts

Every availability row has a resource_id. Map it back to tenant.resources[] (from playtomic_get_tenant) to know court name, indoor/outdoor, single/double, surface.

Levels & match recommendations

• level_value is your Playtomic skill rating (typically 0–7). level_confidence reflects how many matches the rating is based on.
• playtomic_match_recommendations returns open matches at your level near a coordinate. Empty array = no recommendations right now (it's normal).

Rate limits

Playtomic has no published SLA. Keep request volume reasonable (≤1 req/s steady state). The engine auto-handles 401 with a retry-after-relogin and gives up after one retry — if you see 401 twice, check that your credentials are correct.

Stability

This is an undocumented/internal API reverse-engineered from the Playtomic iOS app. Endpoints can change without notice. If a tool starts failing, check the AnythingMCP docs for a connector update.

Useful starter prompts

• "Find open padel matches at my level near Milan this weekend." → playtomic_match_recommendations
• "What's my current padel level on Playtomic?" → playtomic_get_my_level
• "How many padel matches have I won this year?" → playtomic_get_my_stats
• "At which clubs do I play the most?" → playtomic_get_top_clubs
• "Show me free crystal-court slots tomorrow afternoon within 20 km of my home." → playtomic_search_tenants + playtomic_get_availability
• "Are there any padel tournaments coming up near Barcelona?" → playtomic_list_tournaments

Network: routed through the connector proxy

Playtomic refuses requests from datacenter IP addresses: from a cloud server its login answers 403 with an HTML page. Every tool of this connector is therefore marked to go through the instance's connector proxy (CONNECTOR_PROXY_URL), and the login that mints the token goes through the same proxy. On AnythingMCP Cloud this is set up for you and the calls count towards the workspace's hourly proxy quota. Self-hosted from a home or office connection, it works without a proxy; from a datacenter, set CONNECTOR_PROXY_URL (see the proxy documentation). The proxy terminates TLS, so your Playtomic email and password pass through it on the way to Playtomic.