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.

Guía de configuraciónDocumentación de la API REST
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ón

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

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