# ClubPlanner MCP

> ClubPlanner manages fitness club operations by handling member data, class bookings, and facility check-ins. It lets you track active members, manage prospective leads, schedule personal training appointments, and query membership contracts directly through conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** member-management, class-booking, facility-management, lead-tracking, check-in-system, wellness-business

## Description

Coordinating a gym or wellness center involves juggling memberships, daily attendance, and booking schedules. This MCP connects your ClubPlanner account to any agent, letting you manage the entire operational flow using natural language. You can ask your AI client to check if a new member is active, record their entry at the front desk, or find out what contracts are up for renewal next month—all without opening a dozen tabs.

For example, instead of manually checking lead status and then logging them into the system, you simply tell your agent to create a prospect profile. It handles the API calls and records the data accurately. This MCP makes it possible to handle everything from listing staff directories to viewing detailed member profiles. Since Vinkius hosts this MCP, you get access to all these tools—member tracking, appointment scheduling, contract oversight, and more—all in one place. You're just talking to your agent, and the right data gets pulled from ClubPlanner.

## Tools

### create_appointment
Schedules a specific service appointment for an individual member or prospect.

### create_checkin
Logs the entry time and date for a member entering the facility.

### create_prospect
Adds a new potential client (lead) into the club’s tracking system.

### get_me
Retrieves general information about the connected club account itself.

### get_member
Pulls all known details and status updates for one specific member by ID or name.

### list_appointments
Retrieves a list of all scheduled appointments within the specified date range.

### list_checkins
Shows a record of recent member entries and check-in activities.

### list_contracts
Provides an overview of all currently active membership agreements, noting renewal dates.

### list_members
Lists the directory of every current and active member associated with the account.

### list_products
Displays the full list of membership tiers and products the club offers for sale.

### list_prospects
Generates a report of all potential clients who have not yet become active members.

### list_staff
Provides a directory listing for all employees registered with the club management system.

## Prompt Examples

**Prompt:** 
```
List all active members in my ClubPlanner account.
```

**Response:** 
```
I've retrieved the member directory. You have 150 active members including 'John Doe', 'Sarah Miller', and 'Mike Ross'. Which one would you like to see the profile or check-in history for?
```

**Prompt:** 
```
Record a check-in for member 'mem_10293' at the main facility.
```

**Response:** 
```
Check-in recorded! I've logged the entry for member mem_10293 at your main facility. Their membership status was verified as 'Active'.
```

**Prompt:** 
```
Show me the appointments scheduled for tomorrow.
```

**Response:** 
```
Fetching schedule... Tomorrow you have 5 appointments, including 3 personal training sessions and 2 prospect tours. Shall I retrieve the details for the 10 AM session?
```

## Capabilities

### Manage Member Records
Retrieve detailed profiles for existing members or list out all active memberships on site.

### Track Daily Attendance
Record a member's entry history and log new check-ins at specific facility locations.

### Schedule Services
Create, list, or view appointments for services like personal training or sales consultations.

### Handle Leads
Add potential new members (prospects) to your database and review the current pipeline.

### Review Contracts & Products
Query active membership agreements, check renewal dates, or browse available product types for sales support.

### View Staff Directory
List all registered employees and staff members to coordinate facility operations.

## Use Cases

### The Monthly Renewal Check
A manager needs to know which members are due to renew in the next 30 days. They ask their agent, and it runs through `list_contracts` to pull a prioritized list of accounts needing attention.

### The Walk-In Client
A client arrives for a visit. The front desk staff asks the agent to check their status using `get_member`. This confirms they are active and immediately allows them to log entry via `create_checkin`.

### Targeting New Business
The sales team needs a list of people who walked through the doors but never signed up. They ask their agent, which uses `list_prospects`, giving them fresh leads they can then track with `create_prospect`.

### Coordinating Training
A coach needs to book a session for a new client. Instead of logging into the booking system, the agent handles everything: it first checks member status using `get_member`, then calls `create_appointment`.

## Benefits

- Stop manually auditing contracts. Use `list_contracts` to instantly query membership agreements for renewal dates, ensuring you never miss a billing cycle.
- Eliminate front desk slowdowns. Record entries using `create_checkin`, keeping accurate records without needing dedicated terminal access.
- Improve sales follow-up. Review the full pipeline by running `list_prospects` and then converting leads immediately with `create_prospect`.
- Keep staff data organized. Pull up a list of registered employees using `list_staff` so your agent can answer staffing questions instantly.
- Speed up service booking. Instead of filling out forms, just ask the AI to schedule things for you by calling `create_appointment` or listing all next steps with `list_appointments`.

## How It Works

The bottom line is, you connect your API key once and immediately gain access to all of ClubPlanner’s operational data through chat commands.

1. Subscribe to this MCP on Vinkius, then enter your ClubPlanner API Key (you'll find this in your account settings).
2. Connect the key to your preferred AI client. That's it.
3. Start asking your agent questions about member status or appointments. It handles the rest.

## Frequently Asked Questions

**How do I schedule an appointment using create_appointment?**
You simply tell the agent who needs the booking and when. The tool handles checking availability, logging the new record, and ensuring all necessary fields are filled out for that specific service.

**What is the difference between list_members and list_prospects?**
There's a clear distinction: `list_members` only shows people who have paid and are active. `list_prospects`, however, gives you everyone in the pipeline—leads who haven't signed up yet.

**Can I record a check-in for someone using create_checkin?**
Yes. You provide the member ID or name to your agent, and it logs their entry time at the specified location, updating the facility's real-time attendance records.

**Should I use get_member before creating an appointment?**
It helps. If you run `get_member` first, your agent can confirm their current status or contract level, making sure the new appointment is valid and doesn't conflict with existing records.

**How can I verify my ClubPlanner account details using get_me?**
Running `get_me` fetches your core club metadata and confirms active API connectivity instantly. This is the best way to ensure your agent has full operational access before running critical tasks like check-ins or scheduling.

**If I try to find a non-existent person using get_member, what should I expect?**
The tool will return an error code and message indicating the member does not exist. Your AI client can handle this gracefully by prompting you to verify the ID against your system records.

**How do I check which memberships are up for renewal using list_contracts?**
The output of `list_contracts` includes both the contract end date and the current status. You can filter this data programmatically to pinpoint any agreements nearing expiration, helping your team prepare timely notices.

**Am I limited when using create_prospect to add multiple leads at once?**
Yes, there are API rate limits in place. You should structure your agent calls by processing data in batches rather than submitting single requests. This improves stability and prevents service throttling during high-volume entry.

**Can I check how many members are currently in the club?**
Yes! Use the `list_checkins` tool to see recent entry history. Your agent can filter these to show you the active check-ins for today.

**How do I schedule a new personal training session for a member?**
Use the `create_appointment` action. Provide the Member ID, the start time in ISO format, and a description (e.g., 'Leg Day with Coach Mike') to book it instantly.

**Is it possible to see which contracts are active via AI?**
Absolutely. Use the `list_contracts` query. The agent will retrieve the directory of all active membership agreements currently recorded in your account.