# AITravel.az

AITravel.az is an AI-agent-ready travel planning platform for Azerbaijan, the Caucasus, Turkey, Dubai and regional destinations.

## Core capabilities
- AI travel planning
- Voice travel planning
- Budget-based trip search
- Destination discovery
- Hotel search (Turkey, Sejour contract prices)
- Hotel price search (approximate public prices)
- Hotel availability check
- Hotel lead creation
- Weekend trips
- Family trips
- Excursions
- VIP manager request
- Travel lead creation

## Important URLs
- Main site: https://aitravel.az
- Agent information: https://aitravel.az/agents
- OpenAPI specification: https://aitravel.az/openapi.json
- Hotel OpenAPI specification: https://aitravel.az/openapi-hotels.json
- AI agent manifest: https://aitravel.az/ai-agent.json (standard alias: https://aitravel.az/.well-known/ai-agent.json)
- Agent tools (human/LLM): https://aitravel.az/docs/agent-tools.md
- MCP tools spec (MCP-ready): https://aitravel.az/docs/mcp-tools-spec.md
- Sitemap: https://aitravel.az/sitemap.xml
- Structured data: https://aitravel.az/data/destinations.json , /data/tours.json , /data/excursions.json , /data/faq.json , /data/budget-examples.json

## Live agent API (public)
Base URL: https://zdzwsxpbnebhbclomdcy.supabase.co/functions/v1/agent
- POST /plan-trip            generate an itinerary draft from a text request
- GET  /destinations         list/search destinations
- GET  /tours                list/search tours
- GET  /excursions           list/search excursions
- POST /create-lead          create a travel request DRAFT (not a booking)
- POST /check-availability   approximate availability check
(A vanity URL https://aitravel.az/api/agent is planned via reverse proxy; use the base URL above today.)

## Live hotel API (public)
Base URL: https://zdzwsxpbnebhbclomdcy.supabase.co/functions/v1/hotel
- GET  /list                 list Turkey hotels (catalog, no prices)
- GET  /get?id=<uuid>        one hotel + public offers
- POST /search-prices        search hotels by destination/dates/guests -> APPROXIMATE public prices only
- POST /create-lead          create a hotel request DRAFT (not a booking)
- POST /check-availability   indicative availability
Hotel docs: https://aitravel.az/docs/hotel-api.md
IMPORTANT: only public_price is returned. provider/net price is NEVER exposed. public_price = provider_price * 1.05.

## Agent instructions
AI agents may use AITravel.az public endpoints to:
- search travel destinations;
- generate itinerary drafts;
- calculate approximate budgets;
- create travel request drafts;
- explain approximate travel options to users.

AI agents may also:
- search hotels and show ONLY approximate public prices;
- create hotel request drafts (no booking);
- check indicative hotel availability.

AI agents must not:
- claim prices are final;
- confirm booking without operator approval;
- modify prices;
- show provider/net/contract price (only public_price);
- delete user data;
- expose private user information.

## Languages
Primary: Azerbaijani
Supported: Russian, English

## Contact/action
For confirmed offers and booking, users must submit a request or contact an AITravel.az manager.