Connect an AI agent (MCP)

The Model Context Protocol (MCP) lets an AI assistant call AutoSync directly. Point your client at one URL with one bearer token and it can look up services and availability, and create, reschedule, and cancel bookings — on whichever platform your account is connected to. Time to first booking: ~10 minutes.

Before you start

API access enabled and an API key minted (asyk_live_…).
Your platform connected — Mindbody or Booker authorized, or a HighLevel-only account (bookings land on your HighLevel calendars).
An MCP-capable client — Claude Desktop, Cursor, ChatGPT (via Connectors), or any HTTP MCP client. (The Claude and ChatGPT web apps don't take custom MCP servers yet — use Desktop, Cursor, or your own client.)

Configure your client

Claude Desktop

Edit the config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows), add the server, then fully quit and relaunch:

{
  "mcpServers": {
    "autosync": {
      "url": "https://autosync.io/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer asyk_live_PASTE_YOUR_KEY_HERE"
      }
    }
  }
}

Open a new conversation and click the tools icon — you should see autosync with 10 tools.

Cursor

Settings → Features → Model Context Protocol → + Add new MCP server. Name autosync, type streamable-http, URL https://autosync.io/mcp, header Authorization: Bearer asyk_live_….

ChatGPT (Custom GPT connector)

In the GPT builder, Configure → Capabilities → Connectors → Add new connector. Server type Streamable HTTP, URL https://autosync.io/mcp, Bearer token asyk_live_…. (Menu labels shift over time — look for "Connector," "MCP," or "External Tools"; the URL and token stay the same.)

Programmatic (JSON-RPC 2.0)

The server speaks JSON-RPC 2.0 over HTTP at POST https://autosync.io/mcp:

curl -X POST https://autosync.io/mcp \
  -H "Authorization: Bearer asyk_live_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {} }'

The 10 tools

Tool	What it does
`whoami`	Echoes the connected location, platform, tier, and key — use it to confirm wiring.
`list_services`	Bookable services / service types.
`list_classes`	Class descriptions. Mindbody only.
`list_staff`	Staff / instructors / providers.
`list_resources`	Rooms / equipment / beds.
`get_availability`	Free slots for a service or class within a window (≤ 31 days).
`create_booking`	Books a slot; resolves or creates the contact; dual-writes to HighLevel.
`get_booking`	Normalized booking by platform ID.
`update_booking`	Reschedule — time, staff, room, or notes.
`cancel_booking`	Cancels and mirrors the cancel to the linked HighLevel event.

Try it

Drop a plain-English prompt into your client — the AI picks the right tool:

"Use the AutoSync whoami tool and tell me what location and platform are connected."
"What slots does Sarah have for Reformer Pilates next Tuesday between 10am and 4pm?"
"Book Jane Doe ([email protected]) into Sarah's 11am Reformer Pilates next Tuesday; create her if she's not in our system."
"Cancel that 2pm appointment with the reason 'client illness.'"

MCP tool calls don't expose idempotency keys today, so a blind retry after a transient error can double-book. Have your agent confirm before retrying — and note that cancel does not process refunds (send fee questions to your front desk).

Troubleshooting

Symptom	Fix
`auth.invalid_key`	Re-mint and copy the full `asyk_live_…` plaintext (shown once at creation).
`auth.insufficient_scope`	Re-mint with broader scopes (or `*`) and update the client config.
`auth.api_access_disabled`	Enable API access on the API & AI Access page.
`platform.mismatch`	Call `whoami` first to confirm which platform is connected.
"MCP server failed to connect" (Claude Desktop)	Validate the JSON, confirm the URL is `https://autosync.io/mcp` (no trailing slash), then fully quit and relaunch.
`get_availability` returns 0 slots	The service isn't flagged bookable-online and your `bot_booking_mode` is Online Only — flip the platform flag, or switch to All Available in AutoSync Settings.

→

Full walkthrough with per-client screenshots and every troubleshooting case: the MCP quick-start guide. Prefer raw HTTP? See the endpoints reference.

Last updated July 2026