MCP tool spec (draft)

Draft specification. The MCP endpoint is not live yet; today use the read-only JSON API. Live availability is not provided.

Machine-readable: /api/mcp-spec.json

{
  "name": "staylattice-directory",
  "transport": "MCP (read-only)",
  "tools": [
    {
      "name": "search_merchants",
      "input": {
        "city": "Austin|Dallas",
        "type": "hotel|restaurant",
        "q": "string?"
      },
      "output": "list of merchant summaries (id,name,type,city)"
    },
    {
      "name": "get_merchant",
      "input": {
        "id": "string"
      },
      "output": "schema.org JSON-LD object incl. ReserveAction"
    },
    {
      "name": "get_booking_handoff",
      "input": {
        "id": "string",
        "date": "YYYY-MM-DD",
        "party_size": "int",
        "nights": "int?"
      },
      "output": {
        "handoff_url": "merchant official booking URL",
        "attribution_token": "opaque id for fee tracking (future)",
        "live_availability": "false in v0.1 - no merchant API access yet"
      }
    }
  ],
  "rest_equivalents": [
    "GET /api/merchants.json",
    "GET /api/merchants/{id}",
    "GET /api/handoff/{id}?date=&party="
  ],
  "policy": "No scraping of availability; only public pages; merchants can claim/opt out.",
  "status": "draft specification - endpoint not yet live"
}