KosmoKrator

other

Acuity Scheduling MCP Integration for Vercel AI SDK

Connect Acuity Scheduling to Vercel AI SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

8 functions 7 read 1 write Manual OAuth token auth
Submit Acuity Scheduling feedback View package source

Connect Acuity Scheduling to Vercel AI SDK

Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts.

Create an MCP client that starts or connects to the KosmoKrator gateway for the selected integration. The gateway is local, scoped to this integration, and starts with --write=deny so Vercel AI SDK can inspect read-capable tools without receiving write access by default.

Acuity Scheduling MCP Config for Vercel AI SDK

Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.

{
  "mcpServers": {
    "kosmokrator-acuity-scheduling": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=acuity-scheduling",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=acuity-scheduling --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Acuity Scheduling instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Acuity Scheduling Tools Visible to Vercel AI SDK

Vercel AI SDK sees stable MCP tool names generated from the Acuity Scheduling integration catalog.

MCP toolSource functionTypeDescription
integration__acuity_scheduling__acuity_list_appointments acuity-scheduling.acuity_list_appointments Read List appointments from Acuity Scheduling. Returns upcoming and past appointments with client details, date/time, and status. Use filters to narrow results by date range, calendar, or appointment type.
integration__acuity_scheduling__acuity_get_appointment acuity-scheduling.acuity_get_appointment Read Get full details of a specific appointment in Acuity Scheduling by its ID. Returns client info, date/time, location, forms, and status.
integration__acuity_scheduling__acuity_list_clients acuity-scheduling.acuity_list_clients Read List clients from Acuity Scheduling. Search by name, email, or phone. Returns client contact information and history.
integration__acuity_scheduling__acuity_list_calendars acuity-scheduling.acuity_list_calendars Read List all calendars in Acuity Scheduling. Returns calendar IDs, names, and timezone info. Use calendar IDs to filter appointments.
integration__acuity_scheduling__acuity_list_appointment_types acuity-scheduling.acuity_list_appointment_types Read List all appointment types (services) in Acuity Scheduling. Returns type IDs, names, duration, price, and category. Use type IDs to filter appointments or check availability.
integration__acuity_scheduling__acuity_cancel_appointment acuity-scheduling.acuity_cancel_appointment Write Cancel an existing appointment in Acuity Scheduling. Requires the appointment ID. The appointment will be marked as cancelled and the client will be notified according to notification settings.
integration__acuity_scheduling__acuity_get_availability acuity-scheduling.acuity_get_availability Read Get available time slots for booking in Acuity Scheduling. Returns open times for a given appointment type, date, and optional calendar.
integration__acuity_scheduling__acuity_get_current_user acuity-scheduling.acuity_get_current_user Read Get the currently authenticated Acuity Scheduling user profile. Returns user name, email, timezone, and account details.

Related Acuity Scheduling Pages

Acuity Scheduling CLIUse direct JSON commands instead of MCP discovery. Acuity Scheduling MCPFull gateway reference and MCP tool names. KosmoKrator for Vercel AI SDKClient-level gateway setup.