wellpass-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WELLPASS_EMAIL | No | Your Wellpass account email, used for class search and booking (optional; studio search requires no login). | |
| WELLPASS_PASSWORD | No | Your Wellpass account password, used for class search and booking (optional; studio search requires no login). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_studiosA | Search EGYM Wellpass studios (gyms) near a location, with filters. Args: location: City or place name. Default "Munich". Ignored if latitude and longitude are both given. latitude: Optional exact latitude of the search point. longitude: Optional exact longitude of the search point. radius_km: Only return studios within this distance. Default 10 km. activities: Activity filters. Accept a slug ("activity-yoga"), a bare name ("yoga"), an activity type ("YOGA"), or a label ("Yoga"). Several activities are combined with OR. services: Service/amenity filters, same spelling rules (e.g. "sauna", "service-sauna", "free-parking"). Combined with AND across groups. plus_one: Only studios that allow a Plus1 guest. studio_types: Keep only these studio types (e.g. "PILATES", "WELLNESS"). gym_info: Require these gym-info flags (e.g. "COURSES_IN_ENGLISH", "ACCESSIBLE_TO_PREGNANT_WOMEN"). open_now: Only studios open at the current local time. limit: Max studios to return (1-50). Default 20. region: Catalog: "dach" (default), "all", "us", "fr-be", "dach-us". Returns: A dict with the resolved center, applied filters, and a ranked studio list (nearest first). Call list_studio_filters for valid filter values. |
| get_studio_detailsB | Get full details for one studio by its slug (from search_studios). |
| list_studio_filtersA | List every studio filter value: activities, services, toggles, categories. This is the ground truth for the |
| search_classesA | Search bookable Wellpass classes for a studio (or online), with filters. Needs WELLPASS_EMAIL and WELLPASS_PASSWORD in .env (classes are gated). Pick ONE target:
- studio_slug: a studio from search_studios (its classes).
- club_uuid: the Args:
studio_slug: Studio slug whose classes to list.
club_uuid: Netpulse club uuid (from search_studios Returns: A dict with the resolved club, the window, and a class list (soonest first). Each class has name, category, start/end, teacher, free spots, capacity, and online flag. |
| search_classes_nearA | Find bookable classes NEAR a location, across studios, with filters. Needs login (.env). Note: only a minority of studios expose structured classes (Netpulse-native, e.g. Fitness First); most small studios use external booking and are not included. Online classes are included by default. The first call near a new area is slower (it probes studios); later calls are fast (native studios are cached). Args:
location: City/place. Default Munich. Ignored if latitude+longitude set.
latitude, longitude: Exact search point.
radius_km: Only studios within this distance. Default 5 km.
date_from, date_to: ISO date/datetime window. Default: now .. now+7d.
category: Keep classes whose activity matches (e.g. "yoga", "cardio").
teacher: Keep classes by this instructor (substring, case-insensitive).
available_only: Keep only classes with a free spot.
include_online: Also include the online class catalogue. Default true.
include_studios_without_times: Also list nearby studios that offer
classes but expose no in-app schedule (external booking). They come
back under Returns: Classes (soonest first), each with studio, distance_km, club_uuid, and a class id — pass club_uuid + id to book_class. |
| book_classA | Book the user into a class. TWO-STEP and WRITES to the real account. Step 1 (confirm=false, default): returns the class details and cancellation window and does NOT book. Relay this to the user. Step 2 (confirm=true): actually books. Only send confirm=true AFTER the user has explicitly agreed to book this specific class. Args: club_uuid: The class's club_uuid (from a search result). class_id: The class id (from a search result). confirm: Must be true to actually book. Default false (preview only). spot: Optional spot id, for studios with spot selection. |
| cancel_bookingA | Cancel the user's booking for a class. TWO-STEP and WRITES to the account. confirm=false (default) previews; confirm=true cancels. Only cancel after the user explicitly agrees. Check the cancellation window first. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Most tools have clearly distinct purposes: studio lookup, filter catalog, studio search, class search, booking, and cancellation. The only real overlap is search_classes vs search_classes_near, but the descriptions clearly differentiate per-studio vs location-wide searching.
All tools follow a consistent snake_case verb_noun pattern (get_*, list_*, search_*, book_*, cancel_*). No mixed conventions or vague verbs.
Seven tools is well-scoped for a studio/class discovery and booking domain, with each tool earning its place and no redundancy.
The surface covers search, detail, filters, class discovery, booking, and cancellation with sensible two-step write semantics. The main gap is the absence of a tool to list the user's existing bookings, which would help before cancelling or rebooking.