Breaker1 scheduling software logo

    For AI agents

    Schedule meetings on Breaker1 over MCP

    Breaker1 exposes a public Model Context Protocol server so AI agents — Claude, ChatGPT, Cursor, Cloudflare Agents, and others — can find a Breaker1 user, see mutually-free times on their calendar, and book a meeting on their behalf.

    Endpoint

    https://ssesweekhcliexsnshum.supabase.co/functions/v1/mcp

    JSON-RPC 2.0 over HTTP POST (MCP Streamable HTTP). Send Accept: application/json, text/event-stream and Content-Type: application/json on every request.

    Add Breaker1 to ChatGPT or Claude

    ChatGPT

    1. Settings → Connectors → Add custom connector.
    2. Name it Breaker1, paste the endpoint above.
    3. Auth: No authentication (per-user OAuth is on the way).
    4. Enable it in a chat, then ask: "Use breaker1 to find a time with @matt next week."

    Claude

    1. Settings → Connectors → Add custom connector.
    2. Paste the endpoint above, name it Breaker1, save.
    3. In a chat, tap the connector menu and enable Breaker1 for the conversation.

    The search and fetch tools follow the ChatGPT/Claude connector convention so Breaker1 shows up cleanly in the picker.

    Tools

    • search

      ChatGPT/Claude connector search. Free-text query (name, @username, or email) → list of { id, title, url } results. Pair with `fetch`.

    • fetch

      Given an id from `search` (e.g. `user:matt`), returns a compact document: display name, meeting durations, approval requirement, booking URL, and the next few open time slots.

    • find_user

      Look up a Breaker1 host by email or @username. Returns their booking URL, available meeting durations, and whether they require approval.

    • get_availability

      Return mutually-free meeting slots in UTC for a host, given a duration and date range. Working hours, time zone, buffers, and existing bookings are already applied.

    • propose_times

      Return N mutually-free slots already formatted for a natural-language reply ("Tue 2pm PT, Wed 10am PT…"). Use when a user says "find a time with @matt next week".

    • create_booking

      Book a slot. Status returns 'confirmed' or 'pending' if the host requires approval. Creates the calendar event + Google Meet link and emails both sides.

    • cancel_booking

      Cancel a booking using its id + the guest_email it was booked under. Sends the cancellation email and cleans up the host's calendar event.

    Quick test

    curl -X POST https://ssesweekhcliexsnshum.supabase.co/functions/v1/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

    Discovery

    Rate limits & etiquette

    • 120 calls/hour per IP across all tools
    • 10 booking attempts/hour per IP
    • 30 calls/hour per IP per target host
    • Pass agent_id on create_booking (e.g. "claude.ai") so hosts can see who booked them
    • Web Bot Auth (RFC 9421) Signature-Agent headers are recorded for observability; full key verification is on the roadmap
    Back to homeContact support