# Supersaas — how to use (mcp.ai)

Connect your Supersaas account and use 10 tools for scheduling and booking straight from your AI agent. Connect with your own API key. Appointment Scheduling for Every Situation.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_supersaas?ms=1787293560000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `supersaas_create_user`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/supersaas`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/supersaas/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/supersaas/create/user` — Tool to create a new user in SuperSaaS. Use when you need to add a user to the account. The username is required; all other fields are optional. If a foreign_key is provided, SuperSaaS will use it ins
  - body: { name: string, role?: string, email?: string, group?: integer, phone?: string, credit?: integer, mobile?: string, address?: string, country?: string, webhook?: boolean, password?: string, timezone?: string, duplicate?: string, full_name?: string, foreign_key?: string }
- `POST https://api.mcp.ai/api/supersaas/delete/user` — Tool to delete a SuperSaaS user by their ID. Use when you need to permanently remove a user from the system.
  - body: { id: string }
- `POST https://api.mcp.ai/api/supersaas/get/user` — Tool to read a single user by ID from SuperSaaS. Use when you need to retrieve detailed information about a specific user.
  - body: { id: string, form?: boolean }
- `POST https://api.mcp.ai/api/supersaas/list/field/list` — Tool to retrieve available fields on Schedule or User objects. Use when you need to discover what custom fields are configured for a schedule or user profile.
  - body: { schedule_id?: integer }
- `POST https://api.mcp.ai/api/supersaas/list/groups` — Tool to retrieve all user groups defined in a SuperSaaS account. Use when you need to list groups for managing user access or organizing users.
  - body: { account: string, api_key: string }
- `POST https://api.mcp.ai/api/supersaas/list/promotions` — Tool to list all promotional coupon codes in the account or retrieve a single promotion by code. Use when you need to view available promotions or check details of a specific promotion code.
  - body: { id?: string, limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/supersaas/list/schedules` — Tool to retrieve all schedules in a SuperSaaS account with their IDs and names. Use when you need to list available schedules or get schedule IDs for other operations.
- `POST https://api.mcp.ai/api/supersaas/list/super/forms` — Tool to retrieve all form definitions in a SuperSaaS account with their IDs and names. Use when you need to list available forms or get form IDs for other operations.
- `POST https://api.mcp.ai/api/supersaas/list/users` — Tool to list all users in the SuperSaaS account. Use when you need to retrieve users with optional pagination using limit and offset parameters.
  - body: { form?: boolean, limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/supersaas/update/user` — Tool to update an existing SuperSaaS user by ID. Use when you need to modify user details like name, email, phone, or role.
  - body: { id: string, name?: string, role?: string, email?: string, phone?: string, credit?: integer, mobile?: string, address?: string, full_name?: string }

## Example prompts
- "What can I do in Supersaas?"
- "Show me a summary of my Supersaas account"

## More
- Page: https://mcp.ai/supersaas
- Agent spec (llms.txt): https://mcp.ai/supersaas/llms.txt
- Postman collection: https://mcp.ai/supersaas/postman.json