# ClubReady MCP for AI Agents MCP

> ClubReady MCP gives your AI agents full access to manage any fitness facility's core operations. Use it to search member profiles, process check-ins instantly, track billing balances for collections, schedule classes, and monitor staff roles—all through natural conversation.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** gym-management, member-management, fitness-scheduling, check-in-system, recurring-billing, facility-management

## Description

This connection links your gym’s entire operation into your AI client. You can run complex queries that used to take a full day of clicking between separate tabs. Need to know if John Smith is active and paid up? Ask your agent. Need the roster for tomorrow's spinning class, including waitlist spots? Ask it. The MCP lets you handle everything from billing status checks to logging daily check-ins, making sure every detail stays accurate. When you connect this through Vinkius, your AI client treats your gym data like a native system, letting you manage members, classes, and revenue streams instantly.

## Tools

### search_members
Searches gym members using criteria like name or email to retrieve profile, membership status, and check-in history.

### list_membership_plans
Retrieves details on all available pricing structures, including billing frequency and initiation fees.

### get_store_info
Fetches general location information for the gym facility.

### get_member
Retrieves a specific member's full profile details and current status within the system.

### get_member_billing
Provides critical billing information, useful for collections efforts, showing balances and payment history.

### list_check_ins
Generates a record of daily check-ins, detailing member name, time, barcode used, and membership type, with date filtering.

### do_check_in
Performs the actual check-in process: validating the member's status, recording the visit, and granting door access. It reports success or failure reasons.

### list_schedule
Displays the full group fitness schedule, allowing you to filter results by a specific date range.

### list_class_roster
Lists members for a specific class, showing who checked in, waitlist positions, and which membership plan they used.

### list_prospects
Provides the sales pipeline list of potential customers (leads), essential data for gym sales teams.

### list_staff
Lists all facility staff, including their specific role, certifications, and contact information within the gym.

## Prompt Examples

**Prompt:** 
```
Show me John Doe's status today.
```

**Response:** 
```
✅ **Profile Summary:**
👤 Name: John Doe (ID: 45231)
📋 Membership: Premium All-Access ($89/month)
💰 Billing Status: PAID through April 30.
🗓️ Last Check-in: Today, 10:15 AM. 
📊 This is his 47th visit this year.
```

**Prompt:** 
```
What's the plan for Advanced Cycling tomorrow?
```

**Response:** 
```
**Advanced Cycling Roster (Tomorrow)**
*   **Total Capacity:** 20 spots
*   **Members Booked:** 14
*   **Waitlist:** Empty
*   **Checked In So Far:** 3 members (Status: Active)
*   *Action:* Waitlist remains open until capacity is reached.
```

**Prompt:** 
```
Find all overdue accounts over $50
```

**Response:** 
```
🚨 **Billing Report:** Found 8 members with outstanding balances exceeding $50.
*   Michael R.: $150 past due (Premium Plan)
*   Emma W.: $89 past due (Student Plan)
*   James B.: $62 past due (Annual Membership)
Do you want me to draft automated payment reminders for these users?
```

## Capabilities

### Find member details
Search the database by name, email, or phone number to view a member's profile, status, and check-in history.

### Check in members at the door
Validate membership status against current rules, record the visit, and trigger physical door access for immediate entry.

### Review billing and collections data
Pull detailed information on a member's account balance, payment history, and past-due amounts to manage collections efforts.

### Manage class schedules and rosters
Get the group fitness schedule for any date range and list exactly which members are signed up or waiting for specific classes.

### List facility staff records
View profiles of trainers, managers, and front desk employees, including their certifications and roles at the gym.

## Use Cases

### A member arrives with a questionable status
A member claims they are active, but the system shows a billing issue. You ask your agent to check their records. The MCP uses `search_members` and then `get_member_billing` to confirm the profile is valid but flag an outstanding balance of $150, telling you exactly what's wrong.

### Quickly staffing a new class
You need to know who showed up for tomorrow’s Advanced Cycling. You ask your agent and it uses `list_class_roster` to show that 14 out of 20 spots are filled, and three people have already checked in early.

### Reviewing the day's attendance
The manager asks for a count of how many unique members used the facility today. Your agent uses `list_check_ins` to pull all records, filter them by date, and provide an immediate total headcount.

### Identifying new sales targets
The owner wants to know which leads are ready for a follow-up call. You ask your agent to list prospects using `list_prospects`, which instantly delivers the lead names, their source, and who owns them.

## Benefits

- Instant member insights. Instead of manually searching by name or barcode, you can ask your agent to find a member's profile details using the `search_members` tool instantly.
- Automated check-ins. The `do_check_in` function validates membership status and grants door access in one step, removing manual verification at the front desk.
- Streamlined collections. You can run reports on overdue accounts by calling `get_member_billing`, quickly identifying who needs a payment reminder without deep diving into separate finance software.
- Complete class visibility. Get accurate capacity counts and waitlist status by using `list_class_roster` for any group fitness session, improving resource planning.
- Staff oversight. The `list_staff` tool gives you an immediate directory of every employee's role and certifications when you need to verify credentials.

## How It Works

The bottom line is you talk to your AI client like talking to a front desk employee who knows every member's account details instantly.

1. Connect your AI client to this MCP within Vinkius. This gives your agent read/write access to all core fitness operations data.
2. Tell your agent what you need—for example, 'Check the billing status for John Smith' or 'List the roster for tomorrow's yoga class.'
3. Your agent executes the necessary tool call against the ClubReady system and returns a structured answer containing real-time membership, financial, or scheduling data.

## Frequently Asked Questions

**Can the ClubReady MCP help with daily check-ins and membership verification?**
Yes, it can. You simply ask your agent to perform a check-in. The MCP validates if the member's plan is active and paid up, then records the visit and triggers door access automatically.

**How do I use this ClubReady MCP for tracking billing and collections?**
You ask your agent to list members with specific billing criteria. It uses the underlying financial data to pull overdue amounts, helping you prioritize follow-up calls without leaving your chat interface.

**Does this MCP track class schedules and waitlists for my gym?**
Absolutely. You can ask it to list the roster for any specific fitness class. It shows who is booked, how many spots are left, and if there's a current waitlist.

**Is this MCP good for managing new leads or prospects?**
Yes, it keeps your sales pipeline organized. You can ask the agent to list all potential clients (prospects), seeing who they are, where they came from, and which salesperson owns that lead.

**Can I use this MCP with my AI client for staff management?**
Yes. It provides a full directory of your facility staff. You can pull up profiles listing their roles, certifications, and contact information instantly when needed.