{ "protocolVersion": "0.3.0", "name": "Hotel Bergsonne Allgäu", "description": "Agent for Hotel Bergsonne Allgäu 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.2.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-08-20 to 2026-08-23 for 2 adults?", "GET https://bergsonne-allgaeu.de/api/booking?action=availability&checkIn=2026-08-20&checkOut=2026-08-23&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äu. 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, EUR 3.50 per person per night) is collected at the hotel. 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-08-20 to 2026-08-23.", "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": "request-flag", "flag": "test", "credentialsRequired": false, "description": "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 — no key, account or registration required", "selfServeCredential": "POST https://bergsonne-allgaeu.de/agent/auth — anonymous, instant, grants hotel:read and booking:read", "humanApprovalRequired": false, "contactSalesRequired": false, "sandbox": { "supported": true, "mode": "request-flag", "flag": "test", "credentialsRequired": false, "description": "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" } }