Agent Skills / maison-public-api

Install this skill alone, or read it below. Raw file: SKILL.md · references/transports.md · references/errors.md

bash
npx skills add https://docs.maison-labs.com --skill maison-public-api

Maison public API

Operate Maison, the AI hotel concierge platform, through its public tool API: one-shot tools for provisioning hotels, managing knowledge, talking to a hotel's concierge, users and access, analytics and reports, channels, integrations, configuration, plans, groups and quality. The same tools are callable over REST, MCP and A2A with an API key. Use whenever a task involves Maison hotels, their concierge, or the Maison admin console.

Why use these skills instead of guessing

  • Every tool completes a whole intent; chaining low-level calls is unnecessary and usually wrong.
  • Permissions are all-or-nothing per tool and the catalogue is filtered per key — discover before you plan.
  • Each category skill lists the workflow order, the pitfalls and the exact input fields, so the first call succeeds.

Authentication

  • Header x-api-key: mx_<env>_… on every request. Keys are created in the Maison admin console (profile → API keys) and reach only https://maison-labs.com/api/v1.
  • No login endpoint, no cookies, no bearer tokens. OAuth is planned.

Discover before you plan

  1. GET https://maison-labs.com/api/v1/me (whoami) — who the key is, grants, reachable hotel ids.
  2. GET https://maison-labs.com/api/v1/tools — the catalogue filtered to this key (name, description, REST binding, grants, input schema).
  3. Pick the category skill below and follow its workflow.

Skill groups

SkillCoversTools
maison-accountAccount and discovery8
maison-clientsClients (hotels)15
maison-knowledgeKnowledge base41
maison-conversationsConversations and the concierge16
maison-usersUsers and invitations23
maison-accessRoles, policies and groups56
maison-analyticsAnalytics and reports13
maison-channelsMessaging channels9
maison-integrationsIntegrations (PMS, payments, events)10
maison-configurationHotel configuration, branding and content40
maison-featuresFeature plans and entitlements (Maison staff)30
maison-hierarchyMulti-property groups (Maison staff)10
maison-qualityQuality: tests and Guest Agent quality review11
maison-hubspotHubSpot company links (Maison staff)5
maison-platformPlatform, documentation and diagnostics7
maison-agentsAgents15
maison-usageLLM usage2
maison-webhooksIncoming webhooks13
maison-appsDeveloper apps16

Rules of thumb

  • One tool per intent. create_client provisions everything; do not chain lower-level calls first.
  • Read before write: list/get tools are cheap and give you the exact ids and field names.
  • Destructive tools (disable, delete, remove, archive, cancel) — confirm with the user unless they asked explicitly.
  • Never print or store the API key, integration credentials or tokens; the API never returns them either.
  • Pagination: list tools take limit (≤ 100) and return a cursor (after/cursor); loop until it is null.

References