Referencia MCP de BNBCalc
Lo que expone el servidor y cómo se comporta: autenticación, cada herramienta con su precio, aprobación de herramientas de pago, límites y errores. Para conectar una app, sigue la guía de configuración.
- Dirección
https://atlas.bnbcalc.com/mcp- Transporte
- HTTP streamable sobre POST, sin sesiones
- Autenticación
- Inicia sesión con BNBCalc (OAuth) o una clave API en x-bnbcalc-api-key
Autenticación
Las apps que pueden abrir una página de inicio de sesión se conectan con OAuth: el usuario inicia sesión en BNBCalc y hace clic en Permitir, y la app envía el token de acceso como token Bearer. Las herramientas gratuitas funcionan para cualquier cuenta iniciada. Las herramientas de pago necesitan la suscripción a la API.
Las aplicaciones y los scripts que no pueden abrir una página de inicio de sesión envían una clave API de BNBCalc en el encabezado x-bnbcalc-api-key. Las claves necesitan la suscripción a la API. Cuando una solicitud tiene una clave y un token, la clave tiene prioridad.
Guía de configuraciónHerramientas de pago y aprobación
Una herramienta de pago llamada sin confirmed: true no ejecuta nada y devuelve una cotización de precio. Muestre la cotización al usuario y repita la llamada con confirmed: true solo después de que la apruebe.
Solo se facturan las llamadas exitosas. Una llamada que falla o no devuelve datos no cuesta nada. No reintente automáticamente una llamada de pago después de un tiempo de espera: aún podría completarse y facturarse.
Las herramientas que crean un análisis agregan 10 unidades por cada función de IA que se completa.
Herramientas
Cada herramienta llama al punto final REST correspondiente, por lo que sus resultados coinciden con la API. Los precios son por llamada exitosa. Una herramienta con una ruta debajo toma los mismos campos que ese punto final.
Ingresos y comparables
estimate_revenue
Solo lectura
Ingresos anuales, tarifa por noche y ocupación
$0.10 (10 unidades)
find_comparables
Solo lectura
Hasta 50 listados cercanos con ingresos
$0.10 (10 unidades)
get_listing
Solo lectura
Un listado comparable en detalle
$0.05 (5 unidades)
get_live_listing
Solo lectura
Detalles en vivo de un anuncio de Airbnb
$0.05 (5 unidades)
get_listing_photos
Solo lectura
Fotos de un listado
Gratis
Análisis
create_buy_analysis
Se guarda en tu cuenta
Análisis de compra con flujo de caja y rentabilidad
POST /v1/external/analysis/create/buy$0.20 (20 unidades)
create_owned_analysis
Se guarda en tu cuenta
Análisis de una propiedad que ya posee
POST /v1/external/analysis/create/owned$0.20 (20 unidades)
create_arbitrage_analysis
Se guarda en tu cuenta
Análisis de arbitraje de alquiler a partir del alquiler mensual
POST /v1/external/analysis/create/arb$0.20 (20 unidades)
create_cohost_analysis
Se guarda en tu cuenta
Análisis de co-anfitrión con tu comisión
POST /v1/external/analysis/create/cohost$0.20 (20 unidades)
enhance_analysis
Se guarda en tu cuenta
Añadir comparables de IA o estimaciones de gastos de IA
POST /v1/external/analysis/enhance$0.10 (10 unidades)
get_analysis
Solo lectura
Leer un análisis guardado
Gratis
list_analyses
Solo lectura
Listar tus análisis guardados
Gratis
get_ai_comps
Solo lectura
Selecciones de comparables de IA y razonamiento
Gratis
get_expense_estimates
Solo lectura
Estimaciones de gastos de IA
Gratis
get_report_link
Solo lectura
Enlace de informe compartible
Gratis
Propiedad y alquileres
get_property_details
Solo lectura
Camas, tamaño, valor e impuestos para una dirección de EE. UU.
$0.05 (5 unidades)
get_rent_estimate
Solo lectura
Alquiler a largo plazo con alquileres comparables
$0.05 (5 unidades)
get_section8_rents
Solo lectura
Alquileres del Censo y Section 8 (HUD) por código postal
Gratis
Calculadoras
calculate_amortization
Solo lectura
Pago del préstamo y calendario
Gratis
calculate_dscr
Solo lectura
Ratio de cobertura del servicio de la deuda
Gratis
calculate_tax_benefits
Solo lectura
Depreciación y ahorros fiscales
Gratis
calculate_sell_or_refinance
Solo lectura
Comparar vender con refinanciar
Gratis
Optimizador de listados
run_listing_optimization
Se guarda en tu cuenta
Reescribir y calificar un anuncio de Airbnb
1 crédito
get_listing_optimization
Solo lectura
Estado y calificación de una ejecución
Gratis
list_listing_optimizations
Solo lectura
Tus ejecuciones pasadas
Gratis
get_listing_optimization_report_url
Solo lectura
Enlace de descarga para un informe
Gratis
Cuenta y registros
get_account
Solo lectura
Estado del plan, créditos y clave
Gratis
get_usage
Solo lectura
Solicitudes y uso facturado
Gratis
get_api_health
Solo lectura
Comprobar que la API está activa
Gratis
get_material_participation
Solo lectura
Horas y pruebas de participación del material
Gratis
log_material_participation_hours
Se guarda en tu cuenta
Registrar horas para una propiedad
Gratis
Límites
- Las búsquedas de datos comparten un límite diario con la API REST. Se reinicia a las 00:00 UTC y las búsquedas fallidas también cuentan.
- El trabajo de IA está limitado a 10 solicitudes por minuto y 2 a la vez por cuenta.
- Los análisis no se pueden editar ni eliminar a través de MCP.
Errores
El servidor responde con un estado HTTP y un mensaje que nombra la causa. La guía de configuración enumera los comunes con sus soluciones.
Errores comunes y sus soluciones Ver estado del servidor