BNBCalc MCP Referenz
Was der Server bereitstellt und wie er sich verhält: Authentifizierung, jedes Tool mit seinem Preis, Genehmigung für kostenpflichtige Tools, Limits und Fehler. Um eine App zu verbinden, folgen Sie der Einrichtungsanleitung.
- Adresse
https://atlas.bnbcalc.com/mcp- Transport
- Streamable HTTP über POST, keine Sessions
- Authentifizierung
- Mit BNBCalc anmelden (OAuth) oder einen API-Schlüssel in x-bnbcalc-api-key
Authentifizierung
Apps, die eine Anmeldeseite öffnen können, verbinden sich mit OAuth: Der Nutzer meldet sich bei BNBCalc an und klickt auf Zulassen, und die App sendet das Zugriffstoken als Bearer-Token. Kostenlose Tools funktionieren für jedes angemeldete Konto. Kostenpflichtige Tools benötigen das API-Abonnement.
Apps und Skripte, die keine Anmeldeseite öffnen können, senden einen BNBCalc API-Schlüssel im Header x-bnbcalc-api-key. Schlüssel benötigen das API-Abonnement. Wenn eine Anfrage sowohl einen Schlüssel als auch ein Token enthält, gewinnt der Schlüssel.
EinrichtungsanleitungKostenpflichtige Tools und Genehmigung
Ein kostenpflichtiges Tool, das ohne confirmed: true aufgerufen wird, führt nichts aus und gibt ein Preisangebot zurück. Zeigen Sie das Angebot dem Nutzer an und wiederholen Sie den Aufruf erst mit confirmed: true, nachdem er zugestimmt hat.
Nur erfolgreiche Aufrufe werden abgerechnet. Ein Aufruf, der fehlschlägt oder keine Daten zurückgibt, kostet nichts. Versuchen Sie nicht, einen kostenpflichtigen Aufruf nach einem Timeout automatisch erneut zu versuchen: er könnte trotzdem abgeschlossen werden und abgerechnet werden.
Tools, die eine Analyse erstellen, fügen 10 Einheiten für jede abgeschlossene KI-Funktion hinzu.
Werkzeuge
Jedes Tool ruft den passenden REST-Endpunkt auf, sodass seine Ergebnisse mit der API übereinstimmen. Die Preise gelten pro erfolgreichem Aufruf. Ein Tool mit einer Route darunter nimmt dieselben Felder wie dieser Endpunkt.
Umsatz und Vergleiche
estimate_revenue
Nur Lesezugriff
Jährliche Einnahmen, Nachtrate und Auslastung
$0.10 (10 Einheiten)
find_comparables
Nur Lesezugriff
Bis zu 50 nahegelegene Angebote mit Einnahmen
$0.10 (10 Einheiten)
get_listing
Nur Lesezugriff
Ein vergleichbares Angebot im Detail
$0.05 (5 Einheiten)
get_live_listing
Nur Lesezugriff
Live-Details eines Airbnb-Angebots
$0.05 (5 Einheiten)
get_listing_photos
Nur Lesezugriff
Fotos eines Angebots
Kostenlos
Analysen
create_buy_analysis
Wird in deinem Konto gespeichert
Kaufanalyse mit Cashflow und Renditen
POST /v1/external/analysis/create/buy$0.20 (20 Einheiten)
create_owned_analysis
Wird in deinem Konto gespeichert
Analyse einer Immobilie, die Sie bereits besitzen
POST /v1/external/analysis/create/owned$0.20 (20 Einheiten)
create_arbitrage_analysis
Wird in deinem Konto gespeichert
Rental Arbitrage Analyse basierend auf monatlicher Miete
POST /v1/external/analysis/create/arb$0.20 (20 Einheiten)
create_cohost_analysis
Wird in deinem Konto gespeichert
Co-Hosting Analyse mit Ihrer Provision
POST /v1/external/analysis/create/cohost$0.20 (20 Einheiten)
enhance_analysis
Wird in deinem Konto gespeichert
KI-Vergleichswerte oder KI-Kostenschätzungen hinzufügen
POST /v1/external/analysis/enhance$0.10 (10 Einheiten)
get_analysis
Nur Lesezugriff
Eine gespeicherte Analyse lesen
Kostenlos
list_analyses
Nur Lesezugriff
Ihre gespeicherten Analysen auflisten
Kostenlos
get_ai_comps
Nur Lesezugriff
KI-Vergleichswerte und Begründung
Kostenlos
get_expense_estimates
Nur Lesezugriff
KI-Kostenschätzungen
Kostenlos
get_report_link
Nur Lesezugriff
Teilbarer Berichtslink
Kostenlos
Immobilie und Mieten
get_property_details
Nur Lesezugriff
Betten, Größe, Wert und Steuern für eine US-Adresse
$0.05 (5 Einheiten)
get_rent_estimate
Nur Lesezugriff
Langzeitmiete mit vergleichbaren Mieten
$0.05 (5 Einheiten)
get_section8_rents
Nur Lesezugriff
Miete nach Postleitzahl für Section 8 (HUD) und Volkszählung
Kostenlos
Rechner
calculate_amortization
Nur Lesezugriff
Kreditrate und -plan
Kostenlos
calculate_dscr
Nur Lesezugriff
Schuldendienstdeckungsgrad
Kostenlos
calculate_tax_benefits
Nur Lesezugriff
Abschreibungen und Steuereinsparungen
Kostenlos
calculate_sell_or_refinance
Nur Lesezugriff
Verkauf mit Refinanzierung vergleichen
Kostenlos
Angebotsoptimierer
run_listing_optimization
Wird in deinem Konto gespeichert
Airbnb-Angebot umschreiben und bewerten
1 Credit
get_listing_optimization
Nur Lesezugriff
Status und Bewertung eines Laufs
Kostenlos
list_listing_optimizations
Nur Lesezugriff
Ihre bisherigen Läufe
Kostenlos
get_listing_optimization_report_url
Nur Lesezugriff
Download-Link für einen Bericht
Kostenlos
Konto und Aufzeichnungen
get_account
Nur Lesezugriff
Plan, Guthaben und Schlüsselstatus
Kostenlos
get_usage
Nur Lesezugriff
Anfragen und abgerechnete Nutzung
Kostenlos
get_api_health
Nur Lesezugriff
API-Verfügbarkeit prüfen
Kostenlos
get_material_participation
Nur Lesezugriff
Materialteilnahmestunden und Tests
Kostenlos
log_material_participation_hours
Wird in deinem Konto gespeichert
Stunden für eine Immobilie protokollieren
Kostenlos
Limits
- Datenabfragen teilen sich ein Tageslimit mit der REST-API. Es wird um 00:00 UTC zurückgesetzt und fehlgeschlagene Abfragen zählen ebenfalls.
- KI-Arbeit ist auf 10 Anfragen pro Minute und 2 gleichzeitig pro Konto begrenzt.
- Analysen können nicht über MCP bearbeitet oder gelöscht werden.
Fehler
Der Server antwortet mit einem HTTP-Status und einer Nachricht, die die Ursache nennt. Die Einrichtungsanleitung listet die häufigsten mit ihren Lösungen auf.
Häufige Fehler und Behebungen Serverstatus prüfen