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.
- 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 configurazioneStrumenti a pagamento e approvazione
Uno strumento a pagamento chiamato senza confirmed: true non esegue nulla e restituisce un preventivo. Mostra il preventivo all'utente e ripeti la chiamata con confirmed: true solo dopo che l'ha approvata.
Solo le chiamate riuscite vengono fatturate. Una chiamata che fallisce o non restituisce dati non costa nulla. Non riprovare automaticamente una chiamata a pagamento dopo un timeout: potrebbe comunque completarsi e addebitarsi.
Gli strumenti che creano un'analisi aggiungono 10 unità per ogni funzione AI completata.
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
get_report_link
Sola lettura
Link del report condivisibile
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