← MCP overview

MCP tool catalog

Tools exposed by the Calavai MCP server. Connect with https://www.calavai.com/api/mcp/pro using a key from your dashboard. Machine-readable catalog at /api/mcp/catalog.

read

List bookings

calavai_list_bookings

List the authenticated professional's bookings with optional status and date filters. Returns a page of up to 50 bookings ordered by start time descending, plus a nextCursor for pagination. Use this to answer questions about upcoming, past, or pending sessions.

scope: read:bookingsread-only

Get booking detail

calavai_get_booking

Retrieve a single booking by ID with full details including client contact, service, and payment summary. Only returns bookings owned by the authenticated professional.

scope: read:bookingsread-only

Get revenue summary

calavai_get_revenue

Get aggregate revenue for the authenticated professional over a named period (today, week, month, quarter, year, all). Returns gross, refunded, net, platform fee total, and booking count. Currency is the Pro's primary currency.

scope: read:revenueread-only

List clients

calavai_list_clients

List unique clients who have booked the authenticated professional, with their booking count and most recent session. Useful for follow-up workflows and client lifecycle questions.

scope: read:clientsread-only

Get schedule

calavai_get_schedule

Return the authenticated professional's weekly availability windows, active vacation blocks, and blocked slots. Optional `weekOf` ISO date scopes vacation/blocked items to a 7-day window starting at that date.

scope: read:scheduleread-only

List services

calavai_list_services

List the authenticated professional's services with pricing, duration, and type. Set activeOnly=false to also include disabled services. Service names and descriptions are sanitized.

scope: read:servicesread-only

List subscriptions

calavai_list_subscriptions

List the professional's recurring subscriptions (client name, service, status, period, sessions used/quota). Read-only; does not change billing state.

scope: read:bookingsread-only

List client packages

calavai_list_packages

List package purchases (e.g. '10 Coaching Sessions'). Returns client, sessions used vs. total, status, and expiry. Read-only.

scope: read:bookingsread-only

Get client lifetime revenue

calavai_get_client_revenue

Sum a single client's revenue across all confirmed/completed bookings in a date range (or all-time if omitted). Returns gross cents, count of bookings, and currency. Read-only.

scope: read:revenueread-only

Limits

  • 60 requests/min per key, 120 requests/min per account, 30 requests/min per individual tool.
  • Daily byte cap per key (anti-exfiltration). Resets at 00:00 UTC.
  • Keys auto-revoke after 90 days of inactivity.
  • Optional per-key IP allowlist (CIDR) configurable in the dashboard.