# Planyo Online Booking — how to use (mcp.ai)

Connect your Planyo Online Booking account and use 7 tools for scheduling and booking straight from your AI agent. Connect with your own API key. Planyo is an online reservation system which can be used by any business taking bookings: for days, nights, hours or minutes, or scheduled events.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/planyo_online_booking/add/reservation` — Tool to create a new reservation. Use after gathering resource, timing, and customer details.
  - body: { force?: boolean, site_id: integer, user_id?: integer, end_time?: string, language?: string, quantity: integer, last_name?: string, admin_mode?: boolean, first_name?: string, start_time?: string, user_email?: string, resource_id: integer, voucher_code?: string, custom_fields?: object }
- `POST https://api.mcp.ai/api/planyo_online_booking/add/user` — Tool to add a new user in Planyo. Use when you need to create a user account after gathering user details.
  - body: { fax?: string, zip?: string, city?: string, email: string, phone?: string, state?: string, mobile?: string, vat_id?: string, address?: string, company?: string, country?: string, last_name?: string, first_name?: string, custom_fields?: object }
- `POST https://api.mcp.ai/api/planyo_online_booking/get/addon/list` — Tool to retrieve a list of add-ons. Use when you need to inspect or manage add-ons for a specific resource or across the entire site after setting up credentials.
  - body: { site_id?: integer, user_id?: integer, password?: string, admin_mode?: boolean, login_name?: string, session_id?: string, resource_id?: integer }
- `POST https://api.mcp.ai/api/planyo_online_booking/get/coupon/list` — Tool to retrieve a list of coupons. Use when you need to fetch all coupons for a specific resource or the entire site (if no resource_id provided).
  - body: { page?: integer, site_id?: integer, admin_email?: string, resource_id?: integer, admin_password?: string }
- `POST https://api.mcp.ai/api/planyo_online_booking/get/resource/availability` — Tool to check resource availability within a specified date/time range. Use when validating if a resource can be reserved before creating a reservation.
  - body: { end_time?: string, quantity?: integer, test_mode?: integer, start_time?: string, end_user_id?: integer, ignore_cart?: boolean, resource_id: integer, min_duration?: integer, ignore_reservations?: boolean, check_specific_slots?: integer, preliminary_filtering?: integer }
- `POST https://api.mcp.ai/api/planyo_online_booking/get/resource/blackouts` — Tool to fetch blackout periods for a resource. Use when determining unavailable timeslots before booking.
  - body: { end_time?: integer, start_time?: integer, admin_email?: string, resource_id: integer, admin_password?: string }
- `POST https://api.mcp.ai/api/planyo_online_booking/get/resource/reviews` — Tool to fetch reviews and ratings for a specific resource. Use when you have a resource_id and need to display customer feedback.
  - body: { limit?: integer, resource_id: integer }

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

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