Référence MCP BNBCalc
Ce que le serveur expose et comment il se comporte : authentification, chaque outil avec son prix, approbation des outils payants, limites et erreurs. Pour connecter une app, suivez le guide d'installation.
- Adresse
https://atlas.bnbcalc.com/mcp- Transport
- HTTP streamable sur POST, sans sessions
- Authentification
- Connectez-vous avec BNBCalc (OAuth) ou une clé API dans x-bnbcalc-api-key
Authentification
Les applications qui peuvent ouvrir une page de connexion se connectent avec OAuth : l'utilisateur se connecte à BNBCalc et clique sur Autoriser, et l'application envoie le jeton d'accès en tant que jeton Bearer. Les outils gratuits fonctionnent pour tout compte connecté. Les outils payants nécessitent l'abonnement à l'API.
Les applications et scripts qui ne peuvent pas ouvrir de page de connexion envoient une clé API BNBCalc dans l'en-tête x-bnbcalc-api-key. Les clés nécessitent l'abonnement API. Lorsqu'une requête contient à la fois une clé et un jeton, la clé l'emporte.
Guide de configurationOutils payants et approbation
Un outil payant appelé sans confirmed: true n'exécute rien et renvoie un devis. Affichez le devis à l'utilisateur et répétez l'appel avec confirmed: true seulement après qu'il l'ait approuvé.
Seuls les appels réussis sont facturés. Un appel qui échoue ou ne renvoie aucune donnée ne coûte rien. Ne réessayez pas automatiquement un appel payant après un délai d'attente : il pourrait quand même aboutir et être facturé.
Les outils qui créent une analyse ajoutent 10 unités pour chaque fonction d'IA qui se termine.
Outils
Chaque outil appelle le point de terminaison REST correspondant, de sorte que ses résultats correspondent à l'API. Les prix sont par appel réussi. Un outil avec une route en dessous prend les mêmes champs que ce point de terminaison.
Revenus et comparables
estimate_revenue
Lecture seule
Revenus annuels, tarif par nuit et taux d'occupation
$0.10 (10 unités)
find_comparables
Lecture seule
Jusqu'à 50 annonces à proximité avec revenus
$0.10 (10 unités)
get_listing
Lecture seule
Une annonce comparable en détail
$0.05 (5 unités)
get_live_listing
Lecture seule
Détails en direct d'une annonce Airbnb
$0.05 (5 unités)
get_listing_photos
Lecture seule
Photos d'une annonce
Gratuit
Analyses
create_buy_analysis
S'enregistre sur votre compte
Analyse d'achat avec flux de trésorerie et rendements
POST /v1/external/analysis/create/buy$0.20 (20 unités)
create_owned_analysis
S'enregistre sur votre compte
Analyse d'une propriété que vous possédez déjà
POST /v1/external/analysis/create/owned$0.20 (20 unités)
create_arbitrage_analysis
S'enregistre sur votre compte
Analyse d'arbitrage locatif basée sur le loyer mensuel
POST /v1/external/analysis/create/arb$0.20 (20 unités)
create_cohost_analysis
S'enregistre sur votre compte
Analyse de co-hôte avec votre commission
POST /v1/external/analysis/create/cohost$0.20 (20 unités)
enhance_analysis
S'enregistre sur votre compte
Ajouter des comparables IA ou des estimations de dépenses IA
POST /v1/external/analysis/enhance$0.10 (10 unités)
get_analysis
Lecture seule
Lire une analyse sauvegardée
Gratuit
list_analyses
Lecture seule
Lister vos analyses sauvegardées
Gratuit
get_ai_comps
Lecture seule
Sélections de comparables IA et raisonnement
Gratuit
get_expense_estimates
Lecture seule
Estimations de dépenses IA
Gratuit
get_report_link
Lecture seule
Lien de rapport partageable
Gratuit
Propriété et loyers
get_property_details
Lecture seule
Lits, taille, valeur et taxes pour une adresse américaine
$0.05 (5 unités)
get_rent_estimate
Lecture seule
Loyer à long terme avec loyers comparables
$0.05 (5 unités)
get_section8_rents
Lecture seule
Loyer (Section 8 / HUD et recensement) par code postal
Gratuit
Calculatrices
calculate_amortization
Lecture seule
Paiement du prêt et calendrier
Gratuit
calculate_dscr
Lecture seule
Ratio de couverture du service de la dette
Gratuit
calculate_tax_benefits
Lecture seule
Amortissement et économies d'impôts
Gratuit
calculate_sell_or_refinance
Lecture seule
Comparer la vente avec le refinancement
Gratuit
Optimiseur d'annonces
run_listing_optimization
S'enregistre sur votre compte
Réécrire et noter une annonce Airbnb
1 crédit
get_listing_optimization
Lecture seule
Statut et note d'une exécution
Gratuit
list_listing_optimizations
Lecture seule
Vos exécutions passées
Gratuit
get_listing_optimization_report_url
Lecture seule
Lien de téléchargement pour un rapport
Gratuit
Compte et registres
get_account
Lecture seule
Statut du plan, crédits et clé
Gratuit
get_usage
Lecture seule
Requêtes et utilisation facturée
Gratuit
get_api_health
Lecture seule
Vérifier que l'API est opérationnelle
Gratuit
get_material_participation
Lecture seule
Heures et tests de participation du matériel
Gratuit
log_material_participation_hours
S'enregistre sur votre compte
Enregistrer les heures pour une propriété
Gratuit
Limites
- Les recherches de données partagent une limite quotidienne avec l'API REST. Elle se réinitialise à 00:00 UTC et les recherches échouées comptent également.
- Le travail d'IA est limité à 10 requêtes par minute et à 2 simultanément par compte.
- Les analyses ne peuvent pas être modifiées ou supprimées via MCP.
Erreurs
Le serveur répond avec un statut HTTP et un message qui nomme la cause. Le guide d'installation répertorie les causes courantes avec leurs solutions.
Erreurs courantes et solutions Vérifier l'état du serveur