ScoutingAPI — Verbinde den MCP-Server
ScoutingAPI liefert einen nativen Model Context Protocol Server, sodass ein Agent Unterkunftsdaten von Airbnb, Booking.com, Vrbo und Google Hotels als erstklassige Werkzeuge abfragen kann – ohne dass ein API-Schlüssel in den Agenten eingefügt werden muss.
- Server-URL: https://mcp.scoutingapi.com (Streamable HTTP Transport).
- Authentifizierung: OAuth 2.1 + PKCE (S256) mit dynamischer Client-Registrierung. Du autorisierst einmalig in einem Browser-Popup; der Connector wird mit deinem ScoutingAPI-Konto und dessen Guthaben verknüpft.
- OAuth-geschützte Ressourcenmetadaten (RFC 9728): https://mcp.scoutingapi.com/.well-known/oauth-protected-resource
Verbinden (Claude.ai / Claude Desktop / Claude Code)
- Öffne die Connector-Einstellungen deines Agenten und füge einen benutzerdefinierten Connector (MCP-Server) hinzu.
- Verwende die URL
https://mcp.scoutingapi.com. - Schließe den OAuth-Dialog im Browser-Popup ab – dies verknüpft den Connector mit deinem ScoutingAPI-Konto. (Erstnutzer: Erstelle ein Konto und bestätige zuerst die E-Mail; ein Sandbox-Konto funktioniert für Testzwecke. Siehe https://scoutingapi.com/docs/mcp.)
- Die sieben untenstehenden Werkzeuge stehen dem Agenten zur Verfügung.
Die sieben schreibgeschützten Werkzeuge
search_stays— Suche nach Aufenthalten auf verschiedenen Plattformen nach Ort, Daten, Belegung, Filtern.check_availability— Tagesgenaue Verfügbarkeit für ein bekanntes Inserat über einen Datumsbereich.get_listing— Vollständige Details zu einem Inserat (Ausstattung, Fotos, Gastgeber, Bewertungen).get_price— Ein echtes Preisangebot für ein Inserat für bestimmte Daten + Belegung.compare_prices— Vergleiche eine Unterkunft über mehrere OTAs hinweg mit berechnetem Minimum + Median.get_reviews— Normalisierte, paginierte Bewertungen für ein Inserat auf einer Plattform.get_job— Status abfragen + Ergebnisse eines asynchronen Scraping-Jobs abrufen (kostet 0).
Asynchrones Verhalten
Die Werkzeuge folgen dem gleichen asynchronen Vertrag wie die REST-API: Ein Live-Aufruf, der scrapen muss,
gibt einen ausstehenden Job zurück; der Agent (oder die Werkzeugschicht) fragt get_job mit der zurückgegebenen
jobId ab, bis dieser abgeschlossen ist, und das Ergebnis befindet sich unter data.result. Sandbox- und
Cache-Treffer liefern sofortige Ergebnisse.
Guthaben & Limits
MCP-Aufrufe werden vom gleichen einheitlichen Guthaben wie deine REST-Schlüssel abgezogen, unterliegen jedoch einem separaten Rate-Limit pro Benutzer. Kosten und Limits: https://scoutingapi.com/pricing.
MCP vs. REST – Welches verwenden
- MCP — am besten für interaktive Agenten/Assistenten (z. B. Claude), die Connectors unterstützen: OAuth statt Schlüsselverwaltung, Werkzeuge werden dem Modell nativ angeboten.
- REST (Skill: scoutingapi-search) — am besten für programmatische Backends, Server, Cron-Jobs
und jede Laufzeit ohne MCP-Unterstützung: ein Bearer-Key + das
@scoutingapi/sdk.
Beide greifen auf dieselben Daten und dasselbe einheitliche Schema zu. Dokumentation: https://scoutingapi.com/docs/mcp.