io.github.LayUp-Sport/sports-booking
Official4 toolsLayUp Sports Booking
Search bookable London courts, pitches, lanes and pickup games across every major UK provider.
Search and book London sports courts, pitches and pickup games across UK providers.
Captured live from the server via tools/list.
search_slots
Search bookable sports slots in London across every provider LayUp aggregates. Use when a user wants to find a court, pitch, lane, class or pickup game for football, tennis, squash, padel or swimming. Filter by sport, area/borough, date range, time of day and max price. Returns upcoming slots with venue, London-local time, price, provider and a booking link. Times default to the next 7 days.
Parameters (9)
- sportstring
One of Football, Tennis, Squash, Padel, Swimming.
- areastring
London borough, area or venue name to match (e.g. 'Hackney', 'Southwark', 'Clissold').
- date_fromstring
ISO date or datetime — earliest start. Defaults to now.
- date_tostring
ISO date or datetime — latest start. Defaults to 7 days out.
- time_fromstring
London-local earliest start time of day, 'HH:MM' (e.g. '18:00'). Samples the soonest upcoming slots; combine with date_from to target a specific day.
- time_tostring
London-local latest start time of day, 'HH:MM'.
- max_pricenumber
Maximum price in GBP. Published prices above this are removed; unpublished-price slots ('Check App', common for padel/tennis) are kept and flagged.
- booking_typestring
'spot' = book one place (pickup game / swim seat), 'court' = whole court, 'pitch' = whole pitch.
- limitinteger
Max results to return (1-30, default 15).
list_sports
List the sports LayUp covers with a count of slots available in the next 7 days. Useful as a quick overview before a more specific search.
No parameters.
get_venue
List upcoming bookable slots at a single venue, identified by its venue_slug (as returned by search_slots). Use to drill into one venue after a search.
Parameters (2)
- venue_slugstringrequired
The venue_slug from a search_slots result.
- limitinteger
Max slots to return (1-30, default 15).
create_alert
Set up an email alert for the user: LayUp watches for NEW matching slots (e.g. a cancellation freeing up a peak court) and emails them when one appears. Use when the user can't find a slot now and wants to be notified, or asks to 'monitor'/'watch'/'let me know when'. Requires their email. A confirmation email is sent first — the user must click confirm before any alerts fire (so always tell them to check their inbox). LayUp does the watching; the notification arrives by email, not in this chat.
Parameters (9)
- emailstringrequired
The user's email address (required — alerts are emailed here).
- sportstring
One of Football, Tennis, Squash, Padel, Swimming. Omit for any.
- areastring
London borough / area / neighbourhood to match (e.g. 'Hackney', 'Maida Vale'). NOT a venue name — to watch a specific venue use venue_names. Omit for all London.
- venue_namesarray
Pin the alert to specific venues BY NAME, exactly as shown in search results (e.g. ["Hay's Galleria", "Padel Box"]). Use this whenever the user names venues — the server resolves names to the right venue(s). Prefer this over venue_slugs.
- venue_slugsarray
Pin the alert to specific venues by their exact venue_slug (only if you already have slug values from search_slots). For most cases use venue_names instead. Omit for any venue.
- time_fromstring
Earliest London time-of-day, 'HH:MM' (e.g. '18:00').
- time_tostring
Latest London time-of-day, 'HH:MM'.
- days_of_weekarray
Only alert on these days (e.g. ['Sat','Sun'] for weekends). The alert is standing — it keeps watching these days every week until the user unsubscribes. Omit for any day.
- max_pricenumber
Only alert on slots at or under this GBP price.
README not available yet.
Install
claude_desktop_config.json
{
"mcpServers": {
"sports-booking": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.layupsport.com"
]
}
}
}Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.