# Appointo — how to use (mcp.ai)

Connect your Appointo account and use 11 tools for scheduling and booking straight from your AI agent. Connect with your own API key. Appointo is an appointment booking application designed for Shopify stores, enabling businesses to integrate online booking systems seamlessly into their websites without any coding required.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_appointo?ms=1787295780000`
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. `appointo_authenticate`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/appointo`
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/appointo/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/appointo/authenticate` — Tool to authenticate with the Appointo API by validating the APPOINTO-TOKEN header. Use when verifying the token before subsequent API calls.
- `POST https://api.mcp.ai/api/appointo/cancel/booking` — Tool to cancel a booking or selected customers. Use when you need to revoke an entire booking or individual attendees after verifying booking details. Use after retrieving booking information.
  - body: { booking_id: integer, customer_ids?: integer[] }
- `POST https://api.mcp.ai/api/appointo/create/booking` — Tool to create a new booking. Use when scheduling a customer booking after confirming appointment availability.
  - body: { name: string, email: string, phone?: string, quantity?: integer, timestring: string, appointment_id: integer }
- `POST https://api.mcp.ai/api/appointo/get/appointment/availability` — Tool to get calendar availability for a specific appointment. Use when you need to fetch available time slots for an appointment within a date range.
  - body: { end_date?: string, start_date: string, appointment_id: integer, impersonated_tms?: integer[] }
- `POST https://api.mcp.ai/api/appointo/list/appointments` — Tool to list appointments. Use when fetching appointments with optional filters and pagination after confirming a valid API token.
  - body: { limit?: integer, offset?: integer, product_id?: integer, appointment_id?: integer }
- `POST https://api.mcp.ai/api/appointo/list/bookings` — Tool to list bookings. Use when you need to fetch bookings filtered by status, paging, or search term.
  - body: { limit?: integer, offset?: integer, status?: string, booking_id?: integer, search_term?: string }
- `POST https://api.mcp.ai/api/appointo/list/products` — Tool to fetch all available products. Use when browsing products with optional paging and search. Call after authenticating with Appointo API.
  - body: { limit?: integer, offset?: string, search_term?: string }
- `POST https://api.mcp.ai/api/appointo/list/subscription/contracts` — Tool to list subscription contracts. Use when retrieving contracts with optional search after confirming a valid API token.
  - body: { limit?: integer, offset?: integer, search_term?: string }
- `POST https://api.mcp.ai/api/appointo/reschedule/booking` — Tool to reschedule an existing booking to a new timeslot. Use after confirming new timeslot availability.
  - body: { override?: boolean, booking_id: integer, timestring: string, customer_ids?: integer[] }
- `POST https://api.mcp.ai/api/appointo/update/booking` — Tool to update buffer times for an existing booking. Use after confirming new buffer durations.
  - body: { booking_id: integer, end_buffer_time?: integer, start_buffer_time?: integer }
- `POST https://api.mcp.ai/api/appointo/upsert/appointment/config` — Tool to upsert availability config for an appointment. Use when setting or updating appointment availability settings.
  - body: { config: object, override: object[], appointment_id: integer, availabilities: object[] }

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

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