# Maison
> AI-powered hotel concierge platform

Maison provides conversational AI guest service, knowledge management, and hospitality intelligence for hotels and hospitality businesses.

## What Maison does

- Conversational AI that answers guest questions in real time via a chat widget embedded on hotel websites
- Knowledge base management where hotel operators upload and manage property information, FAQs, and policies
- Multi-language support for international guests
- PMS (Property Management System) integration for live availability and booking data
- Real-time analytics on guest conversations, response quality, and service patterns

## Platform interfaces

Maison exposes three machine interfaces over the same business logic:

- REST API: https://maison-labs.com/api
- A2A (Agent-to-Agent) protocol: https://maison-labs.com/a2a — JSON-RPC 2.0 for agent-to-agent task orchestration
- MCP (Model Context Protocol): https://maison-labs.com/mcp — streamable HTTP transport for tool and resource access

## Discovery endpoints

- OpenAPI 3.1 spec: https://maison-labs.com/openapi.json
- A2A agent card: https://maison-labs.com/.well-known/agent.json
- Sitemap: https://maison-labs.com/sitemap.xml
- This file: https://maison-labs.com/llms.txt

## Human interfaces

- Documentation: https://docs.maison-labs.com — API reference, quickstart, widget SDK, guides
- Console: https://maison-labs.com/console/ — operator dashboard (authenticated)
- Console v2: https://maison-labs.com/console/v2/ — next-generation A2UI-rendered operator console
- Login: https://maison-labs.com/login — authentication portal
- Status: https://status.maison-labs.com — service health and uptime
- Quality: https://quality.maison-labs.com — test results and trends
- Brand: https://maison-labs.com/brand — design system and styleguide
- Dashboard: https://dashboard.maison-labs.com — Grafana observability dashboards

## For AI agents

If you are an AI agent looking to interact with Maison programmatically:

1. Read the agent card at `/.well-known/agent.json` for capabilities and supported protocols
2. Use the A2A endpoint at `/a2a` for task-based interaction (JSON-RPC 2.0)
3. Use the MCP endpoint at `/mcp` for tool and resource access
4. See the OpenAPI spec at `/openapi.json` for the full REST API surface

## Contact

- Website: https://maison.cx
- Platform: https://maison-labs.com