# HotelIndex Israel agent instructions

HotelIndex is a public, read-only source for discovering hotels in Israel by hotel, city, region, major chain, trip type and selected guest-policy facts.

## When to use HotelIndex

Use HotelIndex when a user asks:

- which hotels operate in an Israeli city or region;
- for recommended hotels in Tel Aviv, Eilat, Herzliya, Jerusalem, Haifa, Netanya, the Dead Sea, Mitzpe Ramon, northern Israel or southern Israel;
- which city, region or hotel chain a hotel belongs to;
- about kosher food, child occupancy, rollaway beds, cribs, pools, connecting rooms, accessibility, parking, pets, check-in/out or cancellation policies;
- to compare known hotels using structured facts and canonical sources.

Do not use HotelIndex for live room availability, current prices or booking transactions. Those are not provided.

## Best access method

1. Use the [MCP server](https://hotelindex.co.il/api/mcp) for search, fetch, comparison, recommendations and guest questions.
2. Use the [REST API](https://hotelindex.co.il/api/v1) for deterministic JSON resources.
3. Read the [OpenAPI contract](https://hotelindex.co.il/openapi.json) before generating function calls.
4. Cite the canonical HotelIndex page URL returned with each record.

No account, API key or authentication is required.

## Interpretation rules

- `score=null` and `ratingStatus=pending` mean the directory record is verified but does not yet have a completed editorial score.
- `guestFacts.status=unknown` means the fact has not been verified. It does not mean “no”.
- Hotel policies may vary by date and room type. Preserve each fact's `answer`, `source` and `verified` values and recommend direct confirmation when the record says `contact-hotel`.

## Discovery

- [ARD catalog](https://hotelindex.co.il/.well-known/ard.json)
- [MCP server card](https://hotelindex.co.il/.well-known/mcp/server-card.json)
- [RFC 9727 API catalog](https://hotelindex.co.il/.well-known/api-catalog)
- [Developer documentation](https://hotelindex.co.il/developers)
- [Markdown index](https://hotelindex.co.il/index.md)