# Connect an agent

daybooked is an MCP server at `https://daybooked.io/api/mcp` over Streamable HTTP. Claude Code, Cursor and other MCP clients connect with an API key in the `Authorization` header; claude.ai and ChatGPT add it as a custom connector and sign in to daybooked with OAuth, no key needed. Every API operation is a tool.

URL: https://daybooked.io/docs/connect

MCP server: https://daybooked.io/api/mcp (Streamable HTTP)

## Claude Code
One command. Swap in a key from Dashboard → Developers.
```bash
claude mcp add --transport http daybooked https://daybooked.io/api/mcp --header "Authorization: Bearer daybooked_live_…"
```

## Cursor
One file. Other MCP clients take the same JSON. Save it as .cursor/mcp.json:
```json
{
  "mcpServers": {
    "daybooked": {
      "type": "http",
      "url": "https://daybooked.io/api/mcp",
      "headers": {
        "Authorization": "Bearer daybooked_live_…"
      }
    }
  }
}
```

## claude.ai
A custom connector with OAuth sign-in: no key to paste.
MCP URL: https://daybooked.io/api/mcp
1. Open Customize → Connectors and click Add custom connector. On Team and Enterprise plans, an Owner adds it under Organization settings → Connectors.
2. Paste the MCP URL and click Add. If asked how Claude identifies itself, choose Register automatically.
3. Click Connect, sign in to daybooked and choose Allow.
Allow lets the app act for your organization, like an API key.

## ChatGPT
A custom app in developer mode, with OAuth sign-in.
MCP URL: https://daybooked.io/api/mcp
1. In ChatGPT's settings, turn on Developer mode.
2. Create an app for a remote MCP server: paste the MCP URL and choose OAuth.
3. Sign in to daybooked when asked and choose Allow.
Allow lets the app act for your organization, like an API key.

## Tools
Every API operation is an MCP tool: 74 tools, named like the operation with an underscore, such as `bookings_create`. Reads are marked read-only; deletes and cancels, destructive.
Reference: https://daybooked.io/docs/api

## Booking for a guest
An assistant booking on a guest's behalf needs no key: each business has its own MCP server, which holds a place for the guest, who confirms it from an email.
MCP URL: https://daybooked.io/api/mcp/book/<slug>
- `offerings_list`: what the business offers, with the questions to ask the guest
- `availability_get`: an offering's times with room, a month at most
- `bookings_hold`: holds a place under the guest's name and email, with an `idempotency_key`; the guest gets an email to confirm it, or pay, before the hold runs out
- `bookings_status`: where a hold stands, by its `booking_id` and the guest's email
It can't confirm, cancel, move or read bookings. A business can switch it off in Settings → Booking page; its llms.txt names its URL.