Connector & API Documentation

This page documents the Kozy Le Morne booking connector for conversational assistants and for reviewers. The accommodations, rates and availability it exposes are the same as the ones published on this website. Operated by DIGIPERF LTD, Le Morne Brabant, Republic of Mauritius.

STATUS

1. Live: accommodation discovery, real-time availability, stay quotes, reservation with secure payment link, and the local guide.
2. Questions and review requests: booking@le-morne.com.

ENDPOINT

1. Transport: Model Context Protocol (MCP) over HTTP, JSON-RPC 2.0, stateless.
2. Endpoint (POST): https://kozy-mcp-worker.petirico.workers.dev
3. A GET request on the same URL returns a service descriptor (operator, protocol versions, tool names), which is handy for a quick health check.
4. Protocol versions: 2025-06-18 (default) and 2025-03-26.
5. Supported methods: initialize, ping, tools/list, tools/call, plus the notifications/initialized notification and JSON-RPC batches.
6. No end-user account or authentication is required to browse accommodations, check availability or compute a quote.

AVAILABLE TOOLS

1. list_accommodations — the three self-catering units, with capacity, bed setup and starting nightly rate. Read-only.
2. get_villa_details — specifications, photos, 360° virtual tour, video tour, amenities and house rules for one unit. Read-only.
3. check_availability — real-time availability for a date range, consolidated across Airbnb, Booking.com, Expedia and direct reservations. Read-only.
4. calculate_stay_quote — total price, nightly breakdown, tourist tax and minimum-stay check, in a requested currency. Read-only.
5. create_booking_reservation — re-checks availability and price, then returns a secure payment link valid for 24 hours and a booking reference (KOZY-YYYY-XXXX). Requires an idempotency key: a repeated call returns the same reservation and the same link, never a second one. The dates are confirmed once the payment is completed; no payment, no reservation.
6. get_resort_guide_and_experiences — local guide: kitesurfing, Le Morne Brabant hiking, underwater waterfall, live webcam and practical information. Read-only.

RATES, TAXES AND CANCELLATION

1. Quotes include the nightly rate for the requested dates and the applicable tourist tax. Rates are seasonal and minimum-stay rules apply.
2. The cancellation policy is the one published in our Terms & Conditions and is stated to the guest before any payment.
3. Payments are processed by our payment provider over a secure checkout link. Card details never transit through the connector.

LIMITS AND AVAILABILITY

1. Rate limit: 60 requests per minute per client IP address. Exceeding it returns HTTP 429 with standard X-RateLimit-* headers.
2. Availability is read from live calendar feeds. Typical response time is under 1.5 seconds.
3. Freshness: a confirmed booking is written to our reservation calendar immediately and exported to the public feeds every 10 minutes. Availability may therefore lag reality by up to 10 minutes, exactly as it does on the website.

EXAMPLE CALL

1. List the tools: curl -X POST https://kozy-mcp-worker.petirico.workers.dev -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
2. Check availability: call tools/call with {"name":"check_availability","arguments":{"villaId":"seaview","checkIn":"2026-12-15","checkOut":"2026-12-18"}}
3. Accommodation identifiers: studio, lagoon, seaview.

DATA AND PRIVACY

1. Browsing, availability and quotes require no personal data.
2. Creating a reservation collects the guest name, email address and optional phone number, solely to fulfil the booking. See our Privacy Policy.