BALI RETREAT ARUBA
For AI Assistants
Reliable answers. A clearer picture of your stay.
Approved public villa information, with source links and complete related context.
Connect with MCP
Endpoint: https://baliretreataruba.com/api/v1/mcp.php
Transport: Streamable HTTP with stateless JSON responses. No authentication is required for public information. Supported versions: 2026-07-28, 2025-11-25 and 2025-06-18. Use an MCP client; the endpoint accepts POST and is not a browser page.
Modern clients use server/discover and per-request protocol metadata with matching headers. Legacy clients initialize first. Start with get_service_facts, or get_public_answer with id family-suite.
Three public tools
get_service_facts: approved property facts, including the villa, sleeping arrangements and amenities.
search_public_answers: search the 89 approved guest answers. Supply query (1–512 characters), optional limit (1–10, default 5), and optional service (villa).
get_public_answer: retrieve an exact public answer by id, with all required related answers. Unknown and non-public IDs have the same not-found response.
Use the complete answer
Read each answer together with every related_answers item. Cite the returned public URL and keep all qualifications. Review dates are null where no individual review date is recorded. An unanswered question is a reason to ask the team, never to invent a policy.
These tools cannot check live availability, quote, reserve, modify or cancel a stay, take payments or access guest records. Use the website to review stay dates and booking terms. These public information tools do not make bookings. Do not send personal details, passwords or payment information.
HTTP alternative
POST https://baliretreataruba.com/api/v1/query.php with Content-Type: application/json and this body:
{"name":"get_public_answer","arguments":{"id":"family-suite"}}
For search, use name search_public_answers and arguments {"query":"Bonsai Zen","limit":3}. For facts, use name get_service_facts and arguments {}. Extra fields and query-string parameters are rejected.
Limits and privacy
Requests are limited to 16 KiB. Complete responses, including the MCP envelope, are bounded to 64 KiB. If the required context will not fit, the tool returns context_too_large and public citations instead of truncating conditions.
The application does not record question text. It stores only short-lived keyed rate counters outside the public website folder: 90 requests per minute per network address and 1,200 overall. Counters are replaced with a new random key on the next minute’s request. Hosting access logs may record request metadata. Use POST bodies, never questions in URLs. On HTTP 429, follow Retry-After.