Where do I enable MCP for my organization?

Go to Settings, open MCP, enable it, then copy the organization MCP URL.

What does read-only mode do?

Read-only mode allows listing services and checking availability, but blocks hold and booking creation.

Do MCP bookings require user registration?

No. The public MCP flow can list services, check slots, create holds, and create bookings without user registration.

MCP Configuration

The Zimun MCP endpoint lets external MCP clients discover services, check availability, create holds, and submit bookings for one organization.

The organization context is part of the URL path, so clients should use the exact MCP URL shown in Settings.

This page covers the customer booking MCP. There is a separate management MCP for your own team, with its own switch on the same settings page.

Enable MCP for an organization

Open Settings → MCP.
Enable customer booking MCP for this organization and save.
Copy the organization MCP URL from that page.

Switching the channel on also asks for a confirmation checkbox on that page, and your organization's data processing agreement must be on record under Settings → Organization → Legal — the save is refused without them.

Client URL to configure

Use the organization MCP transport URL:

https://zimun.online/o/<org_id>/mcp

Example:

https://zimun.online/o/o_your-org-id/mcp

Supported booking tools

list_services
list_locations
get_availability
create_hold
create_booking
get_booking
cancel_booking
reschedule_booking

list_services returns price_state for each service: exact (price_cents is the fixed price), from (price_cents is a starting price; the final price can be higher) or none (no price). Never present a from amount as the price.

Reservations (fixed-price services). A hold or booking made through this interface for a service or resource with a fixed price is an appointment reservation within the meaning of the Terms (Part C, Section 13 (2)), not a contract for the service. The hold response and the booking response then carry kind: "reservation", contract: "on_site", the price in price_cents with price_label reading exactly „Preis der Organisation, zahlbar vor Ort; Preis und Vertrag werden vor Ort geregelt“ (the organisation's price, payable on site; price and contract are settled on site), and notice with this fixed text: „Terminreservierung: Mit dieser Reservierung ist noch kein Vertrag über die Leistung geschlossen. Preis der Organisation, zahlbar vor Ort; Preis und Vertrag werden vor Ort geregelt.“ (English: "Appointment reservation: this reservation does not yet conclude a contract for the service. The organisation's price, payable on site; price and contract are settled on site.") Your interface must show this notice to the end-customer, at the latest with the booking result; that is your duty under Part B, Section 8 (5) letter c of the Terms. The hold response carries it so that it can be shown before the end-customer submits the booking; a rendering in another language must be complete and faithful. Zimun neither obtains nor records any end-customer acceptance of its own terms on this interface, takes no online payment and no card, and sends a reservation notice, not a booking confirmation, to the e-mail address submitted with the booking.

Read-only mode

Read-only mode can be enabled in Settings → MCP.

Allowed: list services and locations, check availability, and look up an existing booking.
Blocked: create hold, create booking, cancel booking, and reschedule booking.

Operational notes

MCP is disabled by default per organization.
Rate limits apply to protect public booking flows.
Create booking uses an Idempotency-Key to prevent duplicate submissions.
Tool responses minimize customer PII.