# Bali Retreat Aruba – For AI Assistants

> 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). This is keyword matching: all non-stopword query tokens must match. Use 1–3 topic keywords rather than full sentences or dates.

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. Search results are keyword matches, not a guarantee that they answer the question. Every normal search response includes see_also links to existing public sources; these links are not search matches. Follow the published booking terms for payments, cancellations and date changes, and Book your stay for exact dated prices and availability. If the public sources do not answer the question, ask the team rather than 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:

```json
{"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.

## Public sources

- [Booking, payment and cancellation terms](https://baliretreataruba.com/terms-and-conditions)
- [Book your stay: check dates and review the exact quote](https://baliretreataruba.com/#plan)
- [Approved guest questions](https://baliretreataruba.com/help.html)
- [Public tool instructions and limits](https://baliretreataruba.com/for-ai-assistants.html)
- [Public answers JSON](https://baliretreataruba.com/knowledge/agent-answers.json)
- [Guest guide Markdown](https://baliretreataruba.com/knowledge/public-answers.md)
- [Property facts](https://baliretreataruba.com/facts.json)
- [OpenAPI contract](https://baliretreataruba.com/api/v1/openapi.json)
- [Exact tool definitions](https://baliretreataruba.com/api/v1/tools.json)
- [AI catalog](https://baliretreataruba.com/.well-known/ai-catalog.json)
- [MCP server card](https://baliretreataruba.com/.well-known/mcp-server-card.json)

## Booking and personal information

These tools provide public information only. Use the website to review dates and booking terms. Do not submit guest details or payment information to the public information endpoints.