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.

Guide de configurationDocs de l'API REST
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 configuration

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

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