Hotel Bergsonne Allgäu

{
  "protocolVersion": "0.3.0",
  "name": "Hotel Bergsonne Allg\u00e4u",
  "description": "Agent for Hotel Bergsonne Allg\u00e4u in Sonthofen, Germany: room availability, live rates, room and property details, opening and check-in hours, contact data, and hand-off to direct booking.",
  "url": "https://bergsonne-allgaeu.de/api/booking-mcp",
  "preferredTransport": "JSONRPC",
  "supportedInterfaces": [
    {
      "url": "https://bergsonne-allgaeu.de/api/booking-mcp",
      "transport": "JSONRPC"
    },
    {
      "url": "https://bergsonne-allgaeu.de/api/booking",
      "transport": "HTTP+JSON"
    }
  ],
  "additionalInterfaces": [
    {
      "url": "https://bergsonne-allgaeu.de/api/booking-mcp",
      "transport": "JSONRPC"
    },
    {
      "url": "https://bergsonne-allgaeu.de/api/booking",
      "transport": "HTTP+JSON"
    }
  ],
  "version": "1.3.0",
  "provider": {
    "organization": "Sonne Imberg GmbH",
    "url": "https://bergsonne-allgaeu.de"
  },
  "iconUrl": "https://bergsonne-allgaeu.de/favicon.ico",
  "documentationUrl": "https://bergsonne-allgaeu.de/developers",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "supportsAuthenticatedExtendedCard": false,
  "securitySchemes": {
    "oauth2": {
      "type": "openIdConnect",
      "openIdConnectUrl": "https://bergsonne-allgaeu.de/.well-known/openid-configuration",
      "description": "OAuth 2.1 bearer token, required only for write operations (create_booking). Protected-resource metadata: https://bergsonne-allgaeu.de/.well-known/oauth-protected-resource",
      "scopes": {
        "hotel:read": "Read hotel metadata, room types, amenities, fact sheet and bookable extras.",
        "booking:read": "Read availability, rates and price quotes.",
        "booking:write": "Create a reservation on behalf of a named human guest."
      },
      "x-scopes-supported": [
        "hotel:read",
        "booking:read",
        "booking:write"
      ],
      "x-protected-resource-metadata": "https://bergsonne-allgaeu.de/.well-known/oauth-protected-resource",
      "x-authorization-server-metadata": "https://bergsonne-allgaeu.de/.well-known/oauth-authorization-server"
    },
    "agentBearer": {
      "type": "http",
      "scheme": "bearer",
      "bearerFormat": "JWT",
      "description": "Self-serve anonymous agent credential from POST https://bergsonne-allgaeu.de/agent/auth. Grants hotel:read and booking:read.",
      "scopes": {
        "hotel:read": "Read hotel metadata, room types, amenities, fact sheet and bookable extras.",
        "booking:read": "Read availability, rates and price quotes."
      }
    }
  },
  "security": [
    {},
    {
      "oauth2": [
        "hotel:read",
        "booking:read"
      ]
    },
    {
      "agentBearer": [
        "hotel:read",
        "booking:read"
      ]
    }
  ],
  "skills": [
    {
      "id": "get_room_availability",
      "name": "get_room_availability",
      "description": "Search live room availability and rates for a date range and party size. Returns roomId codes (SDZ, KDZ, KFZ, KAPDZ). No authentication required.",
      "tags": [
        "hotel",
        "availability",
        "rates",
        "public"
      ],
      "examples": [
        "Are rooms free from 2026-11-15 to 2026-11-15 for 2 adults?",
        "GET https://bergsonne-allgaeu.de/api/booking?action=availability&checkIn=2026-11-15&checkOut=2026-11-15&adults=2"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_room_details",
      "name": "get_room_details",
      "description": "Fetch room types, occupancy limits, amenities, images and property metadata for the 16 rooms of Hotel Bergsonne Allg\u00e4u. No authentication required.",
      "tags": [
        "hotel",
        "rooms",
        "public"
      ],
      "examples": [
        "What room types does the hotel offer?",
        "GET https://bergsonne-allgaeu.de/api/booking?action=hotel"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_price_quote",
      "name": "get_price_quote",
      "description": "Nightly price breakdown in EUR including VAT for a room and rate combination; city tax (Kurtaxe) of EUR 3.50 per person per night is already included in the rate and must not be added. No authentication required.",
      "tags": [
        "hotel",
        "pricing",
        "public"
      ],
      "examples": [
        "What does a Komfort double room cost for two nights in August?"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_opening_hours",
      "name": "get_opening_hours",
      "description": "Check-in and check-out times, reception and service hours. Read from the hotel metadata endpoint. No authentication required.",
      "tags": [
        "hotel",
        "hours",
        "public"
      ],
      "examples": [
        "When can I check in?"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_contact",
      "name": "get_contact",
      "description": "Contact channels of the hotel: servus@bergsonne-allgaeu.de and +49 8321 3360, address Imberg 12, 87527 Sonthofen, Germany. No authentication required.",
      "tags": [
        "hotel",
        "contact",
        "public"
      ],
      "examples": [
        "How do I reach the hotel?"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "start_direct_booking",
      "name": "start_direct_booking",
      "description": "Start a direct booking. Preferred path: hand the guest off to https://bergsonne-allgaeu.de/buchen (en: /en/book) for human confirmation of room, rate and payment. Programmatic creation via POST https://bergsonne-allgaeu.de/api/booking?action=bookings requires an OAuth 2.1 bearer token; see /.well-known/oauth-protected-resource and /.well-known/auth.md.",
      "tags": [
        "hotel",
        "booking",
        "requires-human-confirmation",
        "oauth"
      ],
      "examples": [
        "Book the Komfort double room for 2026-11-15 to 2026-11-15.",
        "https://bergsonne-allgaeu.de/buchen"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "security": [
        {
          "oauth2": [
            "booking:write"
          ]
        }
      ]
    }
  ],
  "additionalMetadata": {
    "languages": [
      "de",
      "en",
      "nl",
      "fr",
      "es",
      "pt",
      "it"
    ],
    "primaryLanguage": "de",
    "currency": "EUR",
    "authInstructions": "https://bergsonne-allgaeu.de/.well-known/auth.md",
    "mcpManifest": "https://bergsonne-allgaeu.de/webmcp.json",
    "apiCatalog": "https://bergsonne-allgaeu.de/.well-known/api-catalog",
    "knowledgeBase": "https://bergsonne-allgaeu.de/llms-full.txt",
    "developerPortal": "https://bergsonne-allgaeu.de/developers",
    "agentInstructions": "https://bergsonne-allgaeu.de/.well-known/agent-instructions.md",
    "openapi": "https://bergsonne-allgaeu.de/api/openapi",
    "whenToUse": "Availability, rates, room/property details, accessibility and care-room facts, opening hours, contact data and direct booking for Hotel Bergsonne Allgaeu in Sonthofen, Oberallgaeu, Germany.",
    "whenNotToUse": "Other hotels or multi-property search; cancelling or modifying existing bookings (email or phone only); payments, invoices, guest records or internal systems; bulk crawling without travel intent (rate limited).",
    "scopes_supported": [
      "hotel:read",
      "booking:read",
      "booking:write"
    ],
    "sandbox": {
      "supported": true,
      "mode": "server-url-or-request-flag",
      "baseUrl": "https://bergsonne-allgaeu.de/api/booking/sandbox",
      "flag": "test",
      "credentialsRequired": false,
      "description": "Call the sandbox base URL POST https://bergsonne-allgaeu.de/api/booking/sandbox?action=bookings (test mode forced server-side) or set \"test\": true in POST /api/booking?action=bookings. Identical validation and pricing, no real reservation, bookingId prefixed with TEST-.",
      "documentation": "https://bergsonne-allgaeu.de/developers"
    },
    "onboarding": {
      "readAccess": "open \u2014 no key, account or registration required",
      "selfServeCredential": "POST https://bergsonne-allgaeu.de/agent/auth \u2014 anonymous, instant, grants hotel:read and booking:read",
      "humanApprovalRequired": false,
      "contactSalesRequired": false,
      "sandbox": {
        "supported": true,
        "mode": "server-url-or-request-flag",
        "baseUrl": "https://bergsonne-allgaeu.de/api/booking/sandbox",
        "flag": "test",
        "credentialsRequired": false,
        "description": "Call the sandbox base URL POST https://bergsonne-allgaeu.de/api/booking/sandbox?action=bookings (test mode forced server-side) or set \"test\": true in POST /api/booking?action=bookings. Identical validation and pricing, no real reservation, bookingId prefixed with TEST-.",
        "documentation": "https://bergsonne-allgaeu.de/developers"
      }
    },
    "agentSkills": "https://bergsonne-allgaeu.de/.well-known/agent-skills/index.json",
    "authDocumentation": "https://bergsonne-allgaeu.de/.well-known/auth.md"
  }
}