# entityindex.ai — guide for AI agents

Read-only index of verified businesses. Every fact carries its source URL and check date. entityindex.ai never books or charges: always send users to the official booking or reservation link. Licence CC BY 4.0 — cite "entityindex.ai".

## Verticals
- Hotels — Andorra: `/api/entities/andorra/hotels.json`, record `/api/entities/andorra/hotels/<slug>.json`
- Restaurants — Andorra (OpenStreetMap ODbL + official sites; levels basica/verificada/cliente, sponsored always labelled): `/api/restaurants.json`, record `/api/restaurants/<slug>.json`, search `/api/restaurants?parish=Canillo&cuisine=andorran&open_now=true`

## MCP (Streamable HTTP, no auth)
`POST https://entityindex.ai/mcp` — tools: search_hotels, get_hotel, list_areas, search_restaurants, get_restaurant, search_entities, get_entity, list_verticals. Descriptor: `/.well-known/mcp.json`.

## Other
- OpenAPI: `/openapi.json` · `/openapi.yaml` · API catalog: `/.well-known/api-catalog`
- Full text: `/llms.txt`, `/llms-full.txt` (also /en, /fr, /ca)
- Pages are static HTML (no JavaScript needed), with schema.org JSON-LD, canonical and hreflang.
- Do not invent prices, availability or rankings. Opening hours and menus may change: confirm on the official site.
