# Traveate — Open, Agent-Native Hospitality Data Core

> Traveate (https://traveate.com) is an open, agent-native data core for hospitality plus a stateless Model Context Protocol (MCP) bridge that lets AI agents read and act on property operations safely.

## Documentation Index

- [Documentation Portal (Interactive HTML Viewer)](/docs)
- [Overview & Architecture](/docs/README.md): Core philosophy, 14 canonical tables (including `property_knowledge`), two-step Preview -> Confirm write safety, continuous rejection-feedback learning, and audit logging.
- [Property Archetypes & Data Models](/docs/property-archetypes.md): How Traveate models Entire-Place Homestays (Hope Homestay) vs Full-Service Independent Hotels (Rock Hyrax Hotel), including occupancy-tiered pricing, flat channel fees, multi-board meal plans, and agent-assisted onboarding.
- [Connecting AI Agents, Dual-Persona Split & Living Property Playbook](/docs/mcp-and-agent-guide.md): How to connect Claude, Cursor, Antigravity, or custom agents via the Stateless MCP Bridge (`stdio`) or HTTP `/api/v1/agent-actions/:tool_name`, Dual-Persona Split (`guest_concierge` vs `host_copilot`), and Living Property Memory (`property_knowledge`).
- [REST API & MCP Tool Reference](/docs/api-reference.md): Complete reference for all 32 MCP tools and REST endpoints across Properties, UnitTypes, Availability/Rates (ARI), Bookings, Living Property Knowledge, Dual-Persona Chat, Reviews, Messaging, Open Channel Sync (Two-Way iCal + Gmail IMAP OTA Email Poller), and Data Portability.

## Live & Local Endpoints

- Official Production Domain (Marketing Website): `https://traveate.com` (`/site`)
- Operator Web App Clean Routes (`app.traveate.com`): `/overview`, `/reservations`, `/guests`, `/properties`, `/feed`, `/reviews`, `/messages`, `/copilot`, `/audit`
- Interactive Docs Viewer: `https://traveate.com/docs` (`http://localhost:3456/docs` locally)
- Operator Dashboard (Hope Homestay): `https://app.traveate.com/overview?property_id=hope-homestay`
- Operator Dashboard (Rock Hyrax Hotel): `https://app.traveate.com/overview?property_id=rock-hyrax-hotel`
- Standalone Guest Website Booking Widget: `GET /widget/:slug` (`/widget/hope-homestay`, `/widget/rock-hyrax-hotel`)
- Standalone Multi-Channel Reviews Widget: `GET /widget/reviews/:slug` (`/widget/reviews/hope-homestay`, `/widget/reviews/rock-hyrax-hotel`)
- Dynamic Official PDF Confirmation & Guarantee Letter: `GET /api/v1/bookings/:id/confirmation.pdf`
- Paystack / M-Pesa / Stripe Checkout & Webhook: `POST /api/v1/payments/checkout`, `GET /checkout/:reference`, `POST /api/v1/webhooks/payments/:provider`
- Live WhatsApp Cloud API Webhook: `GET / POST /api/v1/webhooks/whatsapp`
- Scheduled Background Cron Sync: `GET / POST /api/v1/cron/sync-all`
- Guest-Safe Website/WhatsApp Chat API: `POST /api/v1/public/properties/:slug/chat`
- Host Operations Copilot API: `POST /api/v1/host/copilot`
- Living Property Playbook API: `GET / POST /api/v1/properties/:id/knowledge`
- Channel-Specific Outbound iCal Feeds: `GET /api/v1/properties/:id/airbnb.ics` & `GET /api/v1/properties/:id/booking_com.ics`
- Gmail IMAP OTA Reservation Poller: `POST /api/v1/ota-emails/poll-gmail`
- Agent Action Gateway: `POST https://traveate.com/api/v1/agent-actions/:tool_name`
- Health Check: `GET https://traveate.com/health`