{
  "name": "VoiceCosmos hotel agent door",
  "description": "Lets an AI agent read a hotel's public offer (room types with their nightly from-rate, spa treatment names) and place room booking REQUESTS for a guest. Every request is reviewed by hotel staff, who confirm or decline it; nothing is confirmed or charged by the agent. Each key belongs to one hotel and is issued by that hotel's owner or administrator.",
  "url": "https://hospitality.voicecosmos.ai/api/mcp/agent",
  "version": "1.0.0",
  "provider": { "organization": "VoiceCosmos", "url": "https://voicecosmos.com" },
  "documentationUrl": "https://hospitality.voicecosmos.ai/.well-known/agent.json",
  "interfaces": [
    {
      "protocol": "mcp",
      "transport": "streamable-http",
      "url": "https://hospitality.voicecosmos.ai/api/mcp/agent",
      "notes": "Stateless; JSON responses over POST, no SSE stream. MCP protocol versions 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05."
    }
  ],
  "capabilities": { "streaming": false, "pushNotifications": false },
  "securitySchemes": {
    "hotelKey": {
      "type": "http",
      "scheme": "bearer",
      "description": "Authorization: Bearer vcak_… — a key issued by the hotel's owner or administrator in VoiceCosmos settings. It fixes the hotel and what the agent may do, and expires (at most 365 days)."
    }
  },
  "security": [{ "hotelKey": [] }],
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json"],
  "skills": [
    {
      "id": "get_hotel",
      "name": "Hotel offer",
      "description": "Hotel name, room types with their nightly from-rate, spa treatment names, and which requests the hotel accepts.",
      "tags": ["hotel", "rooms", "spa", "read"]
    },
    {
      "id": "request_room_booking",
      "name": "Request a room",
      "description": "Places a room booking request (guest name, email, room type, dates, guests). Requires an idempotency_key; a retry with the same key returns the first request. The answer is 'pending_hotel_approval' with a reference.",
      "tags": ["hotel", "booking", "request"]
    }
  ]
}