Find UK padel courts, live availability and public games, then hand booking to the provider.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this only when the user explicitly wants to organise one to three selected court options with other people. Rechecks each selected slot, creates an expiring Zarvo plan, and returns separate guest and private organiser links. This changes Zarvo state but does not book a court.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Use this only when the user explicitly wants to organise one to three selected court options with other people. Rechecks each selected slot, creates an expiring Zarvo plan, and returns separate guest and private organiser links. This changes Zarvo state but does not book a court.
| Argument | Type | Description |
|---|---|---|
| mode* | string | |
| slot_ids* | array | |
| age_confirmed | boolean | |
| original_request* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"original_request",
"slot_ids",
"mode"
],
"properties": {
"mode": {
"enum": [
"choose_one",
"book_all"
],
"type": "string"
},
"slot_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"maxItems": 3,
"minItems": 1
},
"age_confirmed": {
"type": "boolean"
},
"original_request": {
"type": "string",
"maxLength": 4000,
"minLength": 3
}
}
}Use this when the user has selected a named provider club and wants its available courts on one date or across a bounded date range. Copy provider and club_name exactly from the selected search_clubs result; never infer provider from the club name. Results include Zarvo club IDs when matched and the total limit applies across all dates. number_of_players affects per-player price only; use singles_court to require explicit singles support. Do not use for a broad nearby search; use search_courts instead.
| Argument | Type | Description |
|---|---|---|
| date | string | |
| limit | integer | |
| provider* | string | |
| club_name* | string | |
| date_range | object | |
| earliest_time | string | |
| singles_court | boolean | When true, restrict results to courts or venues explicitly identified as supporting singles play. |
| latest_end_time | string | |
Use this directly after the user chooses a slot. It revalidates the provider slot and returns status unavailable with a reason if the slot was taken, or status available with a provider handoff URL and current price. The user completes login, booking, and payment on the provider site; Zarvo does not reserve inventory or complete checkout.
| Argument | Type | Description |
|---|---|---|
| slot_id* | string | |
| number_of_players | integer |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slot_id"
],
"properties": {
"slot_id": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"number_of_players": {
"type": "integer",
"default": 4,
"maximum": 4,
"minimum": 1
}
}
}Use this after a Zarvo club ID is known and the user wants its address, coordinates, facilities, racket rental, contact information, official website, or social links. This returns directory metadata, not live availability.
| Argument | Type | Description |
|---|---|---|
| club_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"club_id"
],
"properties": {
"club_id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
}
}
}Optional standalone check. get_booking_handoff already revalidates before returning a URL; call this only to confirm availability without proceeding to handoff. It never books, holds inventory, takes payment, or returns checkout.
| Argument | Type | Description |
|---|---|---|
| date | string | |
| slot_id* | string | |
| earliest_time | string | |
| latest_end_time | string | |
| duration_minutes | integer | |
| number_of_players | integer |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slot_id"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"slot_id": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"earliest_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
},
"latest_end_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
},
"duration_minutes": {
"type": "integer",
"maximum": 180,
"minimum": 30,
"multipleOf": 30
},
"number_of_players": {
"type": "integer",
"default": 4,
"maximum": 4,
"minimum": 1
}
}
}Use this when a player wants scheduled PadelStars activities such as coaching, training, intro sessions, socials, junior sessions, or competitions. Returns live session times, levels, vacancies, prices when published, and the provider booking page. It never joins, books, or pays on the user’s behalf.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| category | string | |
| location* | string | |
| provider | string | |
| radius_km | number | |
| start_date* | string | |
| search_days | integer | |
| availability | string | |
| player_level | number | |
| earliest_time | string |
Use this lightweight directory lookup to find clubs by location and facilities or resolve a club description, nearby landmark, or partial club name into candidate club_id, club_name, and provider values. Put only club-name wording in query; add location when an area was supplied. Use court_type for indoor/outdoor/covered courts, racket_rental for racket hire, and facility for a requested amenity. Preserve these filters when refining a search. Do not infer or pass provider from a club or brand-like name: provider is only an explicit booking-platform hint. If that hint conflicts with the directory, name resolution may return the canonical provider instead. It returns Zarvo club metadata, not live court availability. Follow with get_club for full metadata or get_availability for live slots at a selected provider club.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | |
| facility | string | |
| location | string | |
| provider | string | Only filter by provider when the user explicitly names a booking platform. Never infer this from the club name. |
| radius_km | number | |
| court_type | string |
Use this when a group wants bookable court options near a UK location on one date or across a bounded date range. Searches configured providers, normalizes known whole-court and per-player prices, adds catalogue venue IDs and coordinates, and returns at most the requested limit across all dates. Providers such as MATCHi may return a null anonymous price; those slots remain visible under a price ceiling with price_details.basis unknown and must not be presented as budget matches. Travel time is a straight-line heuristic with a 15% soft-filter tolerance near max_travel_minutes, not live routing. number_of_players affects per-player price only; use singles_court to require explicit singles support. Do not use for venue-only discovery or public games.
| Argument | Type | Description |
|---|---|---|
| date | string | |
| limit | integer | |
| location* | string | |
| provider | string | |
| radius_km | number | |
| court_type | string | |
| date_range | object | |
| travel_mode | string |
Use this when a player wants an existing public padel game with an open spot. Omit date, time, level, and limit filters unless the user requested them; by default it returns every matching game around the location across the next 14 UK days. Returns anonymous match metadata and the provider join page; it never reveals player identities or joins on the user’s behalf. Do not use for empty-court bookings.
| Argument | Type | Description |
|---|---|---|
| date | string | |
| limit | integer | |
| location* | string | |
| provider | string | |
| radius_km | number | |
| date_range | object | |
| player_level | number | |
| earliest_time | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"location"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1
},
"location": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"provider": {
"enum": [
"padelstars",
"playtomic",
"padelmates",
"matchi",
"clubspark"
],
"type": "string"
},
"radius_km": {
"type": "number",
"default": 10,
"maximum": 200,
"exclusiveMinimum": 0
},
"date_range": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"start": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"max_days": {
"type": "integer",
"default": 14,
"maximum": 14,
"minimum": 1
}
}
},
"player_level": {
"type": "number",
"maximum": 7,
"minimum": 1
},
"earliest_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
}
}
}| duration_minutes |
| integer |
| Omit to return every duration offered by the provider. |
| number_of_players | integer | Used to compute per-player price only. Does not filter court capacity; use singles_court for that. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"provider",
"club_name"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"provider": {
"enum": [
"padelstars",
"playtomic",
"padelmates",
"matchi",
"clubspark"
],
"type": "string"
},
"club_name": {
"type": "string",
"maxLength": 160,
"minLength": 2
},
"date_range": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"start": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"max_days": {
"type": "integer",
"default": 7,
"maximum": 14,
"minimum": 1
}
}
},
"earliest_time": {
"type": "string",
"default": "00:00",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
},
"singles_court": {
"type": "boolean",
"default": false,
"description": "When true, restrict results to courts or venues explicitly identified as supporting singles play."
},
"latest_end_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
},
"duration_minutes": {
"type": "integer",
"maximum": 180,
"minimum": 30,
"multipleOf": 30,
"description": "Omit to return every duration offered by the provider."
},
"number_of_players": {
"type": "integer",
"default": 4,
"maximum": 4,
"minimum": 1,
"description": "Used to compute per-player price only. Does not filter court capacity; use singles_court for that."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"location",
"start_date"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"category": {
"enum": [
"social",
"coaching",
"training",
"intro",
"junior",
"competition",
"league",
"tournament",
"other"
],
"type": "string"
},
"location": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"provider": {
"type": "string",
"const": "padelstars",
"default": "padelstars"
},
"radius_km": {
"type": "number",
"default": 10,
"maximum": 200,
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"search_days": {
"type": "integer",
"default": 7,
"maximum": 21,
"minimum": 1
},
"availability": {
"enum": [
"available",
"all"
],
"type": "string",
"default": "available"
},
"player_level": {
"type": "number",
"maximum": 7,
"minimum": 1
},
"earliest_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
}
}
}| racket_rental | boolean |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"facility": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"location": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"provider": {
"enum": [
"padelstars",
"playtomic",
"padelmates",
"matchi",
"clubspark"
],
"type": "string",
"description": "Only filter by provider when the user explicitly names a booking platform. Never infer this from the club name."
},
"radius_km": {
"type": "number",
"default": 10,
"maximum": 200,
"exclusiveMinimum": 0
},
"court_type": {
"enum": [
"indoor",
"outdoor",
"covered",
"unspecified"
],
"type": "string"
},
"racket_rental": {
"type": "boolean"
}
}
}| earliest_time | string |
| singles_court | boolean | When true, restrict results to courts or venues explicitly identified as supporting singles play. |
| latest_end_time | string |
| duration_minutes | integer | Omit to return every duration offered by the provider. |
| number_of_players | integer | Used to compute per-player price only. Does not filter court capacity; use singles_court for that. |
| max_travel_minutes | integer |
| max_price_per_player | number |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"location"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"limit": {
"type": "integer",
"default": 3,
"maximum": 20,
"minimum": 1
},
"location": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"provider": {
"enum": [
"padelstars",
"playtomic",
"padelmates",
"matchi",
"clubspark"
],
"type": "string"
},
"radius_km": {
"type": "number",
"default": 10,
"maximum": 200,
"exclusiveMinimum": 0
},
"court_type": {
"enum": [
"indoor",
"outdoor",
"covered",
"unspecified"
],
"type": "string"
},
"date_range": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"start": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"max_days": {
"type": "integer",
"default": 7,
"maximum": 14,
"minimum": 1
}
}
},
"travel_mode": {
"enum": [
"drive"
],
"type": "string",
"default": "drive"
},
"earliest_time": {
"type": "string",
"default": "00:00",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
},
"singles_court": {
"type": "boolean",
"default": false,
"description": "When true, restrict results to courts or venues explicitly identified as supporting singles play."
},
"latest_end_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
},
"duration_minutes": {
"type": "integer",
"maximum": 180,
"minimum": 30,
"multipleOf": 30,
"description": "Omit to return every duration offered by the provider."
},
"number_of_players": {
"type": "integer",
"default": 4,
"maximum": 4,
"minimum": 1,
"description": "Used to compute per-player price only. Does not filter court capacity; use singles_court for that."
},
"max_travel_minutes": {
"type": "integer",
"maximum": 180,
"exclusiveMinimum": 0
},
"max_price_per_player": {
"type": "number",
"maximum": 1000,
"exclusiveMinimum": 0
}
}
}