# Vagaro

**Status:** Connect script implemented. Design: [design/mcp-integrations.md](../../design/mcp-integrations.md).

- **No public MCP** — REST + webhooks.
- Appointments, clients, services, staff.
- No unofficial scrape.
- **Connect:** operator `scripts/connect/connect-vagaro.sh`.

## Connect procedure

```bash
# Preview (default)
./scripts/connect.sh vagaro --dry-run

# Execute (prompts for credentials)
./scripts/connect.sh vagaro --apply
```

### What the script does

1. **Dry-run:** Shows API base URL, webhook port, and step-by-step procedure.
2. **Apply:**
   - Prompts for Vagaro API Key, API Secret, and optional Webhook Secret.
   - Stores credentials via `openshell provider set vagaro-*`.
   - Verifies API connectivity (best-effort curl to `/v1/me`).
   - Records status in `.local/capability_state.json`.
   - Provides webhook URL guidance.

### Owner steps (browser only)

1. Create a Vagaro developer account at [developer.vagaro.com](https://developer.vagaro.com).
2. Register an application to obtain API credentials.
3. Configure webhook URL in the Vagaro dashboard.
4. Provide credentials to the operator.

### API configuration

- **API Base:** `https://api.vagaro.com`
- **Webhook port:** `9876` (configurable via `LUMINA_VAGARO_WEBHOOK_PORT`)
- **Webhook URL:** `https://<your-host>:9876/vagaro/webhook`