Docs · MCP server

MCP server for AI agents

The Cadence MCP server lets an AI agent set up an org and manage bookings in plain language — find availability, book, reschedule, cancel, and (with an admin key) create services and practitioners. It speaks the Model Context Protocol, so it works with Claude and any MCP client.

Install & configure

The server runs locally via uvx and authenticates with your organization API key. Add it to Claude Code in one command:

Claude Code

bash
claude mcp add cadence --env CADENCE_API_KEY=ck_… -- uvx cadence-mcp

For any other MCP client, add this mcpServers block to its config (e.g. claude_desktop_config.json):

mcpServers config

json
{
  "mcpServers": {
    "cadence": {
      "command": "uvx",
      "args": ["cadence-mcp"],
      "env": {
        "CADENCE_API_KEY": "ck_…"
      }
    }
  }
}
Private betacadence-mcp is in private beta and not yet published to PyPI, so uvx cadence-mcp won't resolve just yet — this is the command you'll use once it's published. Want early access? Get in touch.

Where the key comes from

CADENCE_API_KEY is an organization API key (ck_…) from the dashboard under Settings. The tools act on that key's org. A read/write key can use every tool below; create a dedicated key for the agent so you can revoke it independently.

The 12 tools

Tools split into everyday booking operations and admin setup. The setup tools write org configuration, so point the agent at a key you're comfortable letting it administer.

Use — manage bookings

  • cadence_whoamiConfirm which org the key belongs to.
  • cadence_list_servicesList the org's bookable services.
  • cadence_list_practitionersList who delivers services.
  • cadence_get_availabilityFind open slots for a service (optionally a specific practitioner).
  • cadence_create_bookingBook an open slot for a customer (idempotent).
  • cadence_list_bookingsList bookings, filtered by status/time.
  • cadence_get_bookingFetch one booking by id.
  • cadence_reschedule_bookingMove a booking to a new time.
  • cadence_cancel_bookingCancel a booking and free its slot.

Set up — org configuration (admin key)

  • cadence_create_serviceCreate a service (name, duration, location type, optional price).
  • cadence_create_practitionerAdd a practitioner who delivers services.
  • cadence_set_weekly_hoursSet a practitioner's weekly working hours, which generate availability.

Example agent prompts

Once the server is connected, drive Cadence in natural language. The agent picks the right tools and fills in ids from cadence_list_services / cadence_get_availability:

Make a booking

Book me the earliest consultation next week.

Stand up a new offering (admin key)

Set up a new service called "Deep Clean", 90 minutes, in-home,
then add a practitioner named Sam working Mon–Fri 9am to 5pm.

Under the hood these map onto the same REST API documented in the API quickstart — the MCP server is a thin, agent-friendly wrapper over it.