How to Use the ClubPlanner MCP in Mastra AI

Q: How do I connect the ClubPlanner MCP Server to a Mastra AI agent?

Install @mastra/mcp@latest and initialize the client using new MCPClient. Register your Vinkius URL in the servers configuration, then call mcpClient.listTools() to supply your agent with the fitness management capabilities.

Q: How do I require manual sign-off before Mastra AI modifies ClubPlanner contracts?

Use the requireToolApproval setting on your agent. When the agent attempts to alter gym agreements found via listcontracts, the workflow pauses until your team approves the change using this MCP Server.

Q: How is sensitive fitness club data protected within Mastra AI?

Club account details retrieved via getme are processed inside isolated V8 sandboxes. Your gym's API keys and customer records stay encrypted, never leaking into the LLM training sets or public logs with this MCP setup.

Build automated gym workflows with Mastra AI to handle failed club memberships and automate prospect follow-ups.

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 Mastra AI

Create your Vinkius account to connect ClubPlanner to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Membership Recovery Workflows

Build a Mastra AI workflow that monitors expired gym memberships using `list_contracts` and triggers retries. If a ClubPlanner contract flag shows an unpaid status, Mastra initiates a multi-step recovery sequence with automatic backoffs. This TypeScript framework lets you write conditional branches to manage delinquent gym accounts. When a member's billing check fails, the Mastra agent pauses, checks `get_member` for updated contact info, and queues up a notification.

Human-Approved Prospect Escalation

Manage incoming ClubPlanner sales leads without letting Mastra make unchecked decisions in your CRM. When `list_prospects` flags a high-value lead, Mastra AI uses `requireToolApproval` to hold the action until a manager signs off using this MCP integration. Once approved, the Mastra agent invokes `create_prospect` to officially register the gym lead. This Mastra structure keeps your sales pipeline clean and prevents hallucinated contact entries from entering your ClubPlanner database.

Event-Driven Staff Scheduling via MCP Server

Coordinate gym staffing in Mastra AI when class bookings spike. A Mastra AI agent monitors booking volume using `list_appointments` and automatically flags when a class needs more instructors. The Mastra agent checks the roster with `list_staff` and schedules a gym shift. Because Mastra handles complex branching, you can write rules that prevent ClubPlanner scheduling conflicts or overworking your trainers.

Setup guide

Set up ClubPlanner MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All ClubPlanner tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "clubplanner-mcp-client",
  servers: {
    "clubplanner-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "ClubPlanner Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to ClubPlanner tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent ClubPlanner transactions"
);
console.log(result.text);

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 Mastra AI

Install `@mastra/mcp@latest` and initialize the client using `new MCPClient`. Register your Vinkius URL in the servers configuration, then call `mcpClient.listTools()` to supply your agent with the fitness management capabilities.

Yes, Mastra's built-in workflow engine handles transient network failures when calling `create_appointment`. It automatically retries the booking with exponential backoff before logging an error.

Use the `requireToolApproval` setting on your agent. When the agent attempts to alter gym agreements found via `list_contracts`, the workflow pauses until your team approves the change using this MCP Server.

Yes. Mastra automatically detects whether your Vinkius endpoint uses SSE or Streamable HTTP, allowing your agents to read `list_members` without manual transport configuration.

Club account details retrieved via `get_me` are processed inside isolated V8 sandboxes. Your gym's API keys and customer records stay encrypted, never leaking into the LLM training sets or public logs with this MCP setup.

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