# Momence MCP

> Momence MCP Server manages every part of your fitness studio operations. Use natural conversation to view class schedules with `list_sessions`, search member records using `search_members`, manage membership plans via `list_memberships`, and track facility details with `list_locations`. It connects your AI client directly to core studio data.

## Overview
- **Category:** event-management
- **Price:** Free
- **Tags:** studio-management, class-booking, membership-management, fitness-industry, attendance-tracking

## Description

Momence MCP Server handles everything for your studio operations. You connect your agent to this server and you can manage client accounts, check class schedules, and track inventory using natural conversation. It's a direct line to your core business data.

### Managing Your Clients (Members & Staff)

You need deep info on any person in the system? The `search_members` tool lets you run an advanced query against the member database. You pull up profiles, checking active memberships, remaining credits, and full visit history for matching records. If you've got a specific ID, use `get_member` to immediately grab that individual’s current details without running a whole search. Need staff info? The `list_teachers` tool provides a directory of every instructor. You see their specialties and which classes they teach.

### Scheduling & Availability (Classes)

Checking class availability is simple. Ask your agent for a date, and it uses the `list_sessions` tool to return real-time capacity numbers, waitlist counts, and streaming links for that day's lineup. For a specific session, run `get_session` and you get all detailed information about one scheduled class by its unique ID. You can also check out every class type offered using `list_session_types`, which shows the default duration and the assigned teacher for each offering.

For booking tracking, use `list_bookings`. It lists every single reservation made across multiple sessions; you see who booked what and if they're currently checked in. You can review all scheduled classes within a date range by calling `list_sessions` to build your master schedule view.

### Operations & Administration (The Business Stuff)

When it comes to the physical space, use `list_locations`. This tool gives you a central list of every branch Momence manages. You get location details and local time zones for all sites. Want to know what plans you're selling? The agent calls `list_memberships` to display your catalog of available pricing tiers—that includes class packs, unlimited memberships, or intro offers. Need to see what gear you sell? `list_products` shows the inventory list for both physical retail items and digital goods sold at the studio.

To keep track of staff, run `list_teachers` to get specialties and assigned classes. If your business is multi-site, use `list_locations` to detail room setups across all branches. You can also check class availability by asking for a specific date; the agent uses `list_sessions` to return real-time capacity counts, waitlist numbers, and streaming links.

### Core Data Access Summary

*   **Get Specific People:** Use `get_member` when you have an ID. Use `search_members` for deep profile dives that include membership status, remaining credits, and visit logs.
*   **Manage Locations & Plans:** Check every branch with `list_locations`. Review pricing options by calling `list_memberships`. 
*   **View Inventory:** Pull the retail stock list using `list_products`.
*   **Track Schedules:** Get a comprehensive view of all classes in a date range via `list_sessions`. For specific booking status, run `list_bookings`.

## Tools

### list_sessions
Shows a comprehensive list of all scheduled classes within a specified date range.

### list_products
Displays the inventory list for retail items and digital goods sold at the studio.

### get_session
Retrieves all detailed information for one scheduled class session by ID.

### list_session_types
Lists every class type offered by the studio, along with its default duration and assigned teacher.

### search_members
Performs an advanced search on the member database, returning profile data, active memberships, credits, and visit history for matching records.

### get_member
Pulls the full profile details for a single, specific member ID.

### list_memberships
Retrieves the catalog of current membership plans offered (e.g., Unlimited, Intro Offer, Class Pack).

### list_bookings
Lists every single booking made across multiple sessions, showing who booked what and the current check-in status.

### list_teachers
Provides a directory of all instructors, including their specialties and the classes they are assigned to teach.

### list_locations
Provides a list of all studio branches managed by Momence, including location details and time zones.

## Prompt Examples

**Prompt:** 
```
How full are tomorrow's yoga classes?
```

**Response:** 
```
Tomorrow's yoga session fill rates:

🧘 7:00 AM **Sunrise Vinyasa** — 18/22 (82%) with Sarah ☀️
🧘 9:30 AM **Gentle Flow** — 8/18 (44%) with Ana
🧘 12:00 PM **Power Yoga** — FULL (waitlist: 3) with Jake 🔥
🧘 5:30 PM **Yin Restore** — 11/15 (73%) with Maria
🧘 7:00 PM **Hot Yoga** — 14/20 (70%) with Alex (online stream available)

Power Yoga is sold out! Yin Restore still has 4 spots — good candidate for a marketing push.
```

**Prompt:** 
```
List the upcoming classes for instructor Sarah.
```

**Response:** 
```
Sarah is scheduled to teach 'Sunrise Vinyasa' tomorrow at 7:00 AM, 'Core Pilates' on Thursday at 5:30 PM, and a special 'Yoga Retreat Workshop' this Saturday from 10:00 AM to 1:00 PM.
```

**Prompt:** 
```
How many active members are on the Unlimited Monthly plan?
```

**Response:** 
```
You currently have 342 active members on the Unlimited Monthly plan. This represents a 5% increase from last month, largely driven by the recent introductory trial conversions.
```

## Capabilities

### Check class availability
You ask the agent about a specific date, and it uses `list_sessions` to return real-time capacity, waitlist counts, and streaming links.

### Search and pull member history
The agent runs `search_members` to pull a full profile for any client, including their current membership status, remaining credits, and visit logs.

### List all studio locations
It uses `list_locations` to provide a centralized view of every branch the business operates, detailing room setup and local time zones.

### Review current membership plans
The agent calls `list_memberships` to display all available pricing tiers—class packs, unlimited memberships, or intro offers.

### Get a single member's profile
You provide an ID, and the tool executes `get_member`, immediately delivering that person’s current details without searching the whole database.

## Use Cases

### A member asks about their booking status.
The front desk staff doesn't know if the client is on the waitlist or if they are already checked in. They ask the agent, and the agent executes `list_bookings`. The result tells them exactly which session the member booked and whether a spot is confirmed.

### The owner needs to check class profitability.
The owner wants to see if their new 'Unlimited' membership plan is actually working. They ask the agent, who runs `list_memberships` combined with `search_members`. The resulting data shows how many active members are on that specific tier.

### A client needs a full history review.
A member is questioning their credit balance. Instead of having to fill out a form, they ask the agent to run `get_member`. The tool delivers their profile instantly, showing all credits and past attendance records.

### Scheduling conflicts across locations.
The operations manager needs to know if two classes are scheduled at the same time in different parts of the city. They use `list_locations` first to confirm zones, then run `list_sessions`, which aggregates data from all branches for a conflict check.

## Benefits

- Instant Staffing Clarity: Use `list_teachers` to quickly list all instructors. You'll see their bios, specialties, and exactly which classes they are scheduled for this month.
- Master Member Data: Instead of checking separate tabs, run `search_members`. This single tool pulls a profile, active memberships, credits count, and visit history all at once.
- See Studio Capacity At-a-Glance: Asking about tomorrow's schedule triggers `list_sessions`, which returns real-time fill rates, waitlists, and streaming links for every class.
- Location Management Simplified: If you run multiple studios, use `list_locations`. It gives a consolidated view of all branches and correctly handles different time zones.
- Inventory Visibility: Need to reorder supplies or update the website? Run `list_products` to get an immediate catalog of all retail items and digital content.
- Membership Oversight: Quickly compare your available plans by running `list_memberships`. This tells you if you need a new trial offer or just want to adjust class pack pricing.

## How It Works

The bottom line is: it turns complex studio database queries into natural, conversational questions.

1. First, you ask your agent a question—for example, 'What's happening at the downtown location next week?'
2. Your AI client maps that request to Momence and calls relevant tools like `list_locations` (to narrow down the place) and then `list_sessions` (to get the dates).
3. The agent processes the returned data, compiling a clean answer—like showing you the schedule for next week's classes at your chosen location.

## Frequently Asked Questions

**How do I use the list_bookings tool?**
You ask the agent to 'list all bookings.' It runs `list_bookings` and gives you a report showing every single person who booked a class, their name, and if they are currently checked in or waiting for a spot.

**Is get_member better than search_members?**
`get_member` is faster when you already have the member's unique ID. Use `search_members` when you only know their name, email, or phone number and need to find them first.

**What does list_locations show?**
`list_locations` gives you a map-like view of every single physical studio branch. It lists key details like room names and the correct time zone for that specific location.

**Can I check class availability with list_sessions?**
Yes, running `list_sessions` allows you to filter by date range. The output shows real-time capacity alongside the teacher's name and streaming link for every scheduled session.

**How does search_members help with membership issues?**
`search_members` pulls the member's profile, which includes their active memberships and remaining credits. This lets you confirm their status without calling billing department.

**What happens if I use the get_member tool for a member who doesn't exist?**
It returns a specific error code and an empty payload. Your AI client can then handle the failure gracefully instead of crashing, which is key for reliable automation.

**Are there rate limits when I use list_sessions to cover a very large date range?**
The API supports batch querying but high-volume requests may trigger throttling. We recommend checking the documentation for optimal date chunking and request pacing.

**How do I find out about class formats using the list_session_types tool?**
This tool returns definitions (like default duration or teacher) for every possible class format. It shows what's available, regardless of whether a specific session is currently scheduled.

**What is Momence?**
Momence is a next-generation studio management platform used by thousands of yoga, pilates, barre, and boutique fitness studios worldwide. It's known for its modern UX, powerful API, and rapid innovation — many studios are migrating from Mindbody to Momence.

**Does it support the Host API and Member API?**
This server uses the **Host API**, which provides access to all business management functions: sessions, members, bookings, memberships, teachers, and products. The Host API is the recommended choice for AI agents managing studio operations.

**Can it process payments for memberships?**
While it can query membership details and pricing, actual payment processing and checkout must be handled through Momence's secure payment gateway for compliance reasons.