How to Use the ClubPlanner MCP in Windsurf

Q: How do I connect the ClubPlanner MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Once saved, Cascade auto-discovers the tools and lets you query your gym database immediately.

Q: Can Windsurf write new appointment schedules to ClubPlanner?

Yes, Cascade uses the createappointment tool to write bookings directly to your calendar. It can check staff availability first and then write the final booking in a single autonomous chain.

Q: How does Windsurf handle ClubPlanner membership sign-ups?

Cascade reads the active membership plans from listproducts and registers the lead using createprospect. It chains these steps together so you can process new gym sign-ups without leaving your IDE.

Run your entire fitness club's front desk inside Windsurf using our managed MCP Server to automate scheduling and member check-ins.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ClubPlanner MCP to Windsurf

Create your Vinkius account to connect ClubPlanner to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ClubPlanner with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Member Check-ins and Account Lookups

The `list_checkins` tool exposes live visitor traffic directly to Cascade so it can audit your front desk activity. When a member walks in, Cascade uses `create_checkin` to log their arrival and instantly pulls their profile using `get_member` to verify active status. You do not need to click through slow web portals to see who is currently in the gym. Just tell your IDE to check today's attendance, and this MCP connection will chain these queries to give you a clean, real-time list of active members.

Convert Prospects and Manage Memberships

The `create_prospect` tool registers new leads directly into your club database during chat sessions. Cascade reads incoming inquiries, matches them against available plans via `list_products`, and writes the prospect record without you opening a browser. If the lead wants to sign up immediately, the agent checks `list_contracts` to find the right agreement template. This turns your workspace into an active sales pipeline where data moves from chat to database in one step.

Windsurf MCP Server for Autonomous Staff Scheduling

The `create_appointment` tool books sessions directly onto your club calendar based on staff availability. Cascade queries `list_staff` to find open coaches, checks existing slots with `list_appointments`, and writes the new booking. You don't have to manually cross-reference multiple calendars to find an open slot. Our agent handles the planning loop, runs the conflict checks, and outputs the confirmed appointment details in your panel.

Setup guide

Set up ClubPlanner MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the ClubPlanner MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my ClubPlanner payment history." If connected, Cascade will call the ClubPlanner tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "clubplanner-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ClubPlanner. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ClubPlanner now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ClubPlanner MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Once saved, Cascade auto-discovers the tools and lets you query your gym database immediately.

Yes, Cascade uses the `create_appointment` tool to write bookings directly to your calendar. It can check staff availability first and then write the final booking in a single autonomous chain.

Cascade reads the active membership plans from `list_products` and registers the lead using `create_prospect`. It chains these steps together so you can process new gym sign-ups without leaving your IDE.

Yes, you can ask Cascade to list all active employees and their schedules. It runs `list_staff` and cross-references it with `list_appointments` to show you who is working.

Your gym's member profiles, check-in logs, and contact info are protected by Vinkius's zero-trust sandboxing. No raw database credentials ever touch your local IDE, and all API calls route through secure token-based endpoints.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript