Riferimento MCP BNBCalc

Cosa espone il server e come si comporta: autenticazione, ogni strumento con il suo prezzo, approvazione degli strumenti a pagamento, limiti ed errori. Per collegare un'app, segui la guida di configurazione.

Guida alla configurazioneDocumentazione API REST
Indirizzo
https://atlas.bnbcalc.com/mcp
Trasporto
HTTP streamable su POST, senza sessioni
Autenticazione
Accedi con BNBCalc (OAuth) o una chiave API in x-bnbcalc-api-key

Autenticazione

Le app che possono aprire una pagina di accesso si connettono con OAuth: l'utente accede a BNBCalc e fa clic su Consenti, e l'app invia il token di accesso come token Bearer. Gli strumenti gratuiti funzionano per qualsiasi account connesso. Gli strumenti a pagamento richiedono l'abbonamento all'API.

Le app e gli script che non possono aprire una pagina di accesso inviano una chiave API BNBCalc nell'intestazione x-bnbcalc-api-key. Le chiavi richiedono l'abbonamento API. Quando una richiesta contiene sia una chiave che un token, prevale la chiave.

Guida alla configurazione

Strumenti

Ogni strumento chiama l'endpoint REST corrispondente, quindi i suoi risultati corrispondono all'API. I prezzi sono per chiamata riuscita. Uno strumento con un percorso sottostante accetta gli stessi campi di quell'endpoint.

Entrate e comparabili

estimate_revenue

Sola lettura

Ricavi annuali, tariffa notturna e occupazione

$0.10 (10 unità)

find_comparables

Sola lettura

Fino a 50 annunci nelle vicinanze con entrate

$0.10 (10 unità)

get_listing

Sola lettura

Un annuncio comparabile in dettaglio

$0.05 (5 unità)

get_live_listing

Sola lettura

Dettagli live di un annuncio Airbnb

$0.05 (5 unità)

get_listing_photos

Sola lettura

Foto di un annuncio

Gratis

Analisi

create_buy_analysis

Viene salvato nel tuo account

Analisi di acquisto con cash flow e rendimenti

POST /v1/external/analysis/create/buy

$0.20 (20 unità)

create_owned_analysis

Viene salvato nel tuo account

Analisi di una proprietà che già possiedi

POST /v1/external/analysis/create/owned

$0.20 (20 unità)

create_arbitrage_analysis

Viene salvato nel tuo account

Analisi di arbitraggio sull'affitto da locazione mensile

POST /v1/external/analysis/create/arb

$0.20 (20 unità)

create_cohost_analysis

Viene salvato nel tuo account

Analisi di co-hosting con la tua commissione

POST /v1/external/analysis/create/cohost

$0.20 (20 unità)

enhance_analysis

Viene salvato nel tuo account

Aggiungere comparabili IA o stime di spesa IA

POST /v1/external/analysis/enhance

$0.10 (10 unità)

get_analysis

Sola lettura

Leggere un'analisi salvata

Gratis

list_analyses

Sola lettura

Elencare le tue analisi salvate

Gratis

get_ai_comps

Sola lettura

Scelte di comparabili IA e motivazioni

Gratis

get_expense_estimates

Sola lettura

Stime di spesa IA

Gratis

Immobile e affitti

get_property_details

Sola lettura

Letti, dimensioni, valore e tasse per un indirizzo USA

$0.05 (5 unità)

get_rent_estimate

Sola lettura

Affitto a lungo termine con affitti comparabili

$0.05 (5 unità)

get_section8_rents

Sola lettura

Affitti Section 8 (HUD) e censimento per CAP

Gratis

Calcolatori

calculate_amortization

Sola lettura

Pagamento del prestito e piano

Gratis

calculate_dscr

Sola lettura

Rapporto di copertura del servizio del debito

Gratis

calculate_tax_benefits

Sola lettura

Ammortamento e risparmi fiscali

Gratis

calculate_sell_or_refinance

Sola lettura

Confronta vendita con rifinanziamento

Gratis

Ottimizzatore di annunci

run_listing_optimization

Viene salvato nel tuo account

Riscrivi e valuta un'inserzione Airbnb

1 credito

get_listing_optimization

Sola lettura

Stato e punteggio di un'esecuzione

Gratis

list_listing_optimizations

Sola lettura

Le tue esecuzioni passate

Gratis

get_listing_optimization_report_url

Sola lettura

Link per il download di un report

Gratis

Conto e registri

get_account

Sola lettura

Stato del piano, crediti e chiave

Gratis

get_usage

Sola lettura

Richieste e utilizzo fatturato

Gratis

get_api_health

Sola lettura

Controlla che l'API sia attiva

Gratis

get_material_participation

Sola lettura

Ore e test di partecipazione del materiale

Gratis

log_material_participation_hours

Viene salvato nel tuo account

Registra le ore per una proprietà

Gratis

Limiti

  • Le ricerche di dati condividono un limite giornaliero con l'API REST. Si resetta alle 00:00 UTC e anche le ricerche fallite contano.
  • Il lavoro dell'IA è limitato a 10 richieste al minuto e 2 contemporaneamente per account.
  • Le analisi non possono essere modificate o eliminate tramite MCP.

Errori

Il server risponde con uno stato HTTP e un messaggio che indica la causa. La guida all'installazione elenca le cause comuni con le relative soluzioni.

Errori comuni e correzioni Verifica lo stato del server