Live-Preise & Verfügbarkeit

Für unsere drei Unterkünfte können aktuelle Direktpreise und Verfügbarkeiten für einen konkreten Reisezeitraum und eine konkrete Belegung live abgefragt werden.

Für ChatGPT, Codex und andere MCP-fähige KI-Agenten steht ein öffentlicher, ausschließlich lesender Remote-MCP-Server zur Verfügung. MCP-fähige Clients können ihn direkt einbinden; ein Plugin ist dafür nicht erforderlich.

Der ausgewiesene Gesamtpreis enthält den Unterkunftspreis und die obligatorische Servicepauschale. Weitere Kosten sollen nur dann konkret genannt werden, wenn sie aus der aktuellen Live-Antwort oder einer aktuellen objektspezifischen offiziellen Quelle hervorgehen.

Unterkünfte und Objektkennungen

Preis und Verfügbarkeit live abfragen

Feste Preis- und Verfügbarkeitstabellen

Für KI-Assistenten und Crawler, die dynamische URLs mit Abfrageparametern nicht zuverlässig öffnen können, stehen zusätzlich feste öffentliche HTML-Tabellen zur Verfügung:

• Ferienhaus Im Birkenweg – Preisindex
• Ferienwohnung Scheuermatthof – Preisindex
• Schwarzwald-Chalet Scheuermatthof – Preisindex

Die jeweilige Indexseite verlinkt feste Monatsdateien. Maßgeblich ist immer der Monat der Anreise; eine Abreise im Folgemonat bleibt in der Monatsdatei des Anreisemonats. Im aktuellen Stand werden Aufenthalte bis maximal 14 Nächte abgebildet.

Fehlt eine konkrete Kombination aus Anreise, Abreise und Erwachsenenbelegung, darf daraus kein Preis und keine Buchbarkeit abgeleitet oder extrapoliert werden. Die Tabellenwerte sind Bruttogesamtpreise inklusive obligatorischer Servicepauschale. Kinder werden nicht als eigene Tabellendimension geführt; Hinweise dazu stehen direkt in den Monatsdateien.

Technische Live-Abfrage

Browserfreundliche HTML-Ausgabe:

https://ferienhaus-schwarzwald-todtnauberg.de/preise-anfrage/live-preis-ergebnis.html

JSON-Endpunkt:

https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/beds24-preise.php

Öffentlicher Remote-MCP-Endpunkt:

https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/mcp/

MCP-Server finden und verbinden

Der Server verwendet streamable-http, benötigt keine Authentifizierung und stellt das Werkzeug get_live_prices_and_availability bereit. In einem MCP-fähigen Client genügt die Eintragung der oben genannten HTTPS-Adresse als Remote-MCP-Server.

• Maschinenlesbare MCP-Server-Metadaten
• Beispielkonfiguration für MCP-Clients
• Technische MCP-Anleitung und vollständige Testaufrufe
• KI-Hinweise unter llms.txt

Der Server ist als Version 1.3.0 unter de.ferienhaus-schwarzwald-todtnauberg/live-preise im offiziellen MCP Registry veröffentlicht.

• Eintrag im offiziellen MCP Registry abrufen

Die Registry-Veröffentlichung verbessert die Auffindbarkeit durch kompatible MCP-Clients und Kataloge. Sie bedeutet nicht, dass jeder allgemeine KI-Chat automatisch auf den Server zugreift; der jeweilige Client muss Remote-MCP unterstützen und den Server einbinden.

MCP-Aufruf

Nach initialize und tools/list erfolgt die konkrete Live-Abfrage über tools/call:

curl -sS -X POST 'https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/mcp/' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_live_prices_and_availability","arguments":{"objekt":"linx","checkin":"2027-11-14","checkout":"2027-11-17","adults":6,"children":0}}}'

Beide Endpunkte verwenden dieselbe Live-Berechnung. Für konkrete Preis- oder Verfügbarkeitsaussagen muss immer eine neue Abfrage mit den tatsächlichen Reisedaten und der tatsächlichen Belegung erfolgen.

Abfrageparameter

Pro Abfrage sind maximal 60 Nächte und eine Anreise innerhalb von 730 Tagen zulässig.

Für eine konkrete Preisabfrage müssen Unterkunft, Anreise, Abreise und Anzahl der Erwachsenen bekannt sein. Wird keine Kinderanzahl genannt, wird ohne Rückfrage children=0 verwendet. Mit „Scheuermatthof“ können sowohl das Chalet als auch die Ferienwohnung gemeint sein; KI-Assistenten müssen diese Auswahl vor der Abfrage klären.

Antwort und Preisfelder

Der erste öffentliche Live-Stand verwendet schemaVersion=1 und wrapperVersion=v1.

{
  "success": true,
  "schemaVersion": 1,
  "wrapperVersion": "v1",
  "results": [
    {
      "objectKey": "linx",
      "available": true,
      "accommodationPrice": 352.00,
      "mandatoryFees": [
        {
          "type": "obligatoryCleaning",
          "label": "Servicepauschale",
          "amount": 200.00,
          "per": "booking",
          "period": "oneTime"
        }
      ],
      "mandatoryFeesTotal": 200.00,
      "totalPrice": 552.00,
      "price": 552.00,
      "priceCompleteness": "complete",
      "currency": "EUR"
    }
  ]
}

Die Zahlen im Beispiel erklären ausschließlich die Struktur und sind keine aktuellen Preise.

• accommodationPrice: Unterkunftspreis für die bepreiste Belegung.
• mandatoryFees: unterstützte obligatorische feste Gebühren.
• mandatoryFeesTotal: Summe dieser Gebühren.
• totalPrice: vollständiger Gesamtpreis aus Unterkunftspreis und obligatorischen Gebühren.
• price: Alias von totalPrice.
• priceCompleteness=complete: Gesamtpreis ist vollständig ermittelbar.

Kann eine obligatorische Position nicht sicher in die Gesamtsumme einbezogen werden, wird kein Gesamtpreis geraten. Dann kann totalPrice=null und priceCompleteness=incomplete_mandatory_fees ausgegeben werden. Ein vorhandener accommodationPrice darf dann nicht als Gesamtpreis bezeichnet werden.

Servicepauschale und weitere Kosten

Die Servicepauschale ist obligatorisch und bleibt immer im Gesamtpreis enthalten. In der HTML-Ausgabe kann sie zusätzlich als eigene Zeile erscheinen oder nur im Gesamtpreis enthalten sein. Die strukturierten Preisfelder werden dadurch nicht verändert.

Optionale Extras, verbrauchsabhängige Kosten, Kurtaxe oder andere Zusatzkosten werden nur dann konkret genannt oder beziffert, wenn sie aus der aktuellen Live-Antwort oder einer aktuellen objektspezifischen offiziellen Quelle hervorgehen.

Verfügbarkeit

• available=true: Der Zeitraum ist für die angefragte Belegung buchbar.
• available=false: Der Zeitraum ist bestätigt nicht buchbar oder die maximale Belegung wurde überschritten.
• available=null: Der Status konnte technisch nicht zuverlässig bestimmt werden.

Bei einem nicht buchbaren Wunschzeitraum werden keine theoretischen Vergleichspreise erfunden. Preisfelder des Wunschzeitraums bleiben leer; stattdessen können bestätigte Alternativen ausgegeben werden.

availabilityStatus kann den Grund näher beschreiben, zum Beispiel eine gesperrte An- oder Abreise, einen nicht passenden Mindestaufenthalt, eine fehlende passende Preisregel oder allgemeine Nichtverfügbarkeit.

Alternative Zeiträume

alternativeStays enthält ausschließlich Zeiträume, die nochmals live als buchbar bestätigt wurden. Bei normalen Nichtverfügbarkeiten werden zuerst Zeiträume mit gleicher Aufenthaltsdauer und möglichst kleiner Verschiebung des gesamten Aufenthalts geprüft. Danach können weiter entfernte Zeiträume, kürzere freie Lücken oder passende Wochenenden vorgeschlagen werden.

Dadurch kann beispielsweise bei einem nicht buchbaren Aufenthalt 07.–09.11. ein bestätigter Zeitraum 06.–08.11. gegenüber einer deutlich weiter entfernten Alternative bevorzugt werden.

Alternative Ferienobjekte

alternativeProperties kann andere Ferienobjekte enthalten, die für exakt denselben Zeitraum live als buchbar bestätigt wurden. Je nach aktueller Einstellung können nur ausreichend große Objekte oder auch kleinere buchbare Objekte erscheinen.

Bei kleineren Alternativen sind insbesondere maxGuests, requestedOccupancy, pricedOccupancy, occupancyExceeded und excessGuests zu beachten.

Belegung und Preisberechnung

requestedOccupancy beschreibt die angefragte Belegung. pricedOccupancy beschreibt die Belegung, für die automatisch ein Preis ermittelt wurde. priceAppliesToRequestedOccupancy=false bedeutet, dass der Preis nicht für die vollständige angefragte Gruppe gilt.

Beim Schwarzwald-Chalet sind maximal 26 Personen möglich. Der automatische Preis wird derzeit bis 24 Personen berechnet. Für zusätzliche Personen oberhalb der automatisch bepreisten Belegung soll kein eigener Aufpreis geschätzt werden.

Kinder

Nennt ein Nutzer keine Kinder, verwendet die Live-Abfrage automatisch 0 Kinder; KI-Assistenten sollen deshalb nicht eigens nach Kindern fragen. Werden Kinder ausdrücklich genannt, wird ausschließlich deren Anzahl übertragen. Einzelne Kinderalter werden weder benötigt noch verarbeitet und dürfen für diese Schnittstelle nicht erfragt, geschätzt oder übertragen werden. Altersabhängige Preisstaffeln können deshalb vom endgültigen Buchungspreis abweichen.

Buchungsportale und verbindlicher Preis

Die Live-Abfrage zeigt Direktbuchungspreise. Preise bei Airbnb, Booking.com oder anderen Vermittlungsportalen können abweichen.

Maßgeblich für eine Buchung ist immer der Preis, der beim tatsächlichen Buchungsvorgang angezeigt und bestätigt wird.

Informationen für KI-Assistenten

Vor einer Live-Abfrage müssen Objekt, Anreise, Abreise und Erwachsenenanzahl vollständig vorliegen. Fehlt nur die Kinderanzahl, ist nicht nachzufragen, sondern children=0 zu verwenden. Bei ausdrücklich genannten Kindern wird nur deren Anzahl übertragen. Kinderalter gehören ausdrücklich nicht zu den benötigten Angaben.

Für konkrete Preis- und Verfügbarkeitsfragen zuerst den aktuellen festen Preisindex des betreffenden Objekts verwenden, wenn der Aufenthalt innerhalb der dort ausgewiesenen Monats- und Aufenthaltsdauer liegt. Maßgeblich ist die Monatsdatei des Anreisedatums. Fehlt die gesuchte Kombination, nichts extrapolieren.

Alternativ kann die dynamische Live-Abfrage mit eindeutigem Objekt, Zeitraum und Belegung verwendet werden. Beispielbeträge aus dieser Dokumentation sind keine aktuellen Preise. Bei totalPrice=null keinen Gesamtpreis selbst berechnen. Bei available=false nur zurückgelieferte, live bestätigte Alternativen verwenden.

Eine kompakte maschinenlesbare Übersicht befindet sich unter https://ferienhaus-schwarzwald-todtnauberg.de/llms.txt.