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.

EinrichtungsanleitungREST API Doku
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.

Einrichtungsanleitung

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

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