How to Use the Acuity Scheduling MCP in Mastra AI

Q: Does this support conditional logic based on class size?

You branch your workflow based on the output of listclasses. If enrolled count equals capacity, route the user to a different date.

Automate complex calendar workflows. Connect Acuity Scheduling to Mastra AI for conditional booking logic and automatic retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Acuity Scheduling MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Resilient Mastra AI Booking Pipelines

Workflows execute `check_availability_dates` to find open days before attempting any downstream actions. If the API hits a rate limit, Mastra kicks in with exponential backoff. Your agent tries again automatically over the MCP connection until it gets the calendar data. Once you have the dates, the system triggers `list_available_times`. You build conditional branches right here. If a specific time block is full, the workflow routes the user to a waitlist function instead of failing out.

Sync Provider Calendars via MCP Server

You pull specific instructor schedules using `list_calendars` to route incoming requests. A Mastra workflow reads the available providers and assigns the client based on custom logic. It handles the routing entirely in the background. Service details dictate the flow. The agent calls `list_appointment_types` to check the price and duration of a requested session. If the service requires payment upfront, the workflow branches to your billing system before confirming the slot.

Automate Class Enrollment Checks

The `list_classes` tool feeds live capacity data into your automated alerts. You set up a scheduled Mastra agent to check if a popular group session is nearing its limit. When spots drop below a threshold, the workflow fires off an email blast to your waitlist. Account audits run on their own schedule. Your system triggers `get_account` to verify business settings and `list_products` to check gift certificate inventory. Deploying this entire logic tree to your cloud provider takes exactly one command.

Setup guide

Set up Acuity Scheduling 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 Acuity Scheduling 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: "acuity-scheduling-mcp-client",
  servers: {
    "acuity-scheduling-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Acuity Scheduling 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 Acuity Scheduling. 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 Acuity Scheduling 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 Acuity Scheduling MCP in Mastra AI

Run npm install @mastra/mcp. Configure your MCPClient with the Vinkius URL, then spread mcpClient.listTools() into your agent's tool array.

Built-in exponential backoff manages API throttling automatically. If a calendar query fails, the framework waits and retries without breaking your workflow.

Use the requireToolApproval flag on your agent configuration. The workflow pauses when calling tools like list_appointments until an admin signs off.

You branch your workflow based on the output of list_classes. If enrolled count equals capacity, route the user to a different date.

Every tool execution happens in a zero-trust sandbox. Your business profile, staff calendars, and class rosters pass through an encrypted connection. The container destroys itself the moment the workflow finishes.

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