Referência MCP BNBCalc

O que o servidor expõe e como ele se comporta: autenticação, cada ferramenta com seu preço, aprovação de ferramentas pagas, limites e erros. Para conectar um aplicativo, siga o guia de configuração.

Guia de configuraçãoDocs da API REST
Endereço
https://atlas.bnbcalc.com/mcp
Transporte
HTTP transmissível via POST, sem sessões
Autenticação
Entre com BNBCalc (OAuth) ou uma chave de API em x-bnbcalc-api-key

Autenticação

Aplicativos que podem abrir uma página de login se conectam com OAuth: o usuário faz login no BNBCalc e clica em Permitir, e o aplicativo envia o token de acesso como token Bearer. Ferramentas gratuitas funcionam para qualquer conta logada. Ferramentas pagas precisam da assinatura da API.

Aplicativos e scripts que não conseguem abrir uma página de login enviam uma chave de API BNBCalc no cabeçalho x-bnbcalc-api-key. As chaves precisam da assinatura da API. Quando uma solicitação carrega uma chave e um token, a chave vence.

Guia de configuração

Ferramentas

Cada ferramenta chama o endpoint REST correspondente, de modo que seus resultados correspondam à API. Os preços são por chamada bem-sucedida. Uma ferramenta com uma rota abaixo recebe os mesmos campos que esse endpoint.

Receita e comparáveis

estimate_revenue

Somente leitura

Receita anual, taxa noturna e ocupação

$0.10 (10 unidades)

find_comparables

Somente leitura

Até 50 anúncios próximos com receita

$0.10 (10 unidades)

get_listing

Somente leitura

Um anúncio comparável em detalhe

$0.05 (5 unidades)

get_live_listing

Somente leitura

Detalhes ao vivo de um anúncio Airbnb

$0.05 (5 unidades)

get_listing_photos

Somente leitura

Fotos de um anúncio

Grátis

Análises

create_buy_analysis

Salva na sua conta

Análise de compra com fluxo de caixa e retornos

POST /v1/external/analysis/create/buy

$0.20 (20 unidades)

create_owned_analysis

Salva na sua conta

Análise de uma propriedade que já possui

POST /v1/external/analysis/create/owned

$0.20 (20 unidades)

create_arbitrage_analysis

Salva na sua conta

Análise de arbitragem de aluguel a partir do aluguel mensal

POST /v1/external/analysis/create/arb

$0.20 (20 unidades)

create_cohost_analysis

Salva na sua conta

Análise de co-anfitrião com a sua comissão

POST /v1/external/analysis/create/cohost

$0.20 (20 unidades)

enhance_analysis

Salva na sua conta

Adicionar comparáveis de IA ou estimativas de despesas de IA

POST /v1/external/analysis/enhance

$0.10 (10 unidades)

get_analysis

Somente leitura

Ler uma análise guardada

Grátis

list_analyses

Somente leitura

Listar as suas análises guardadas

Grátis

get_ai_comps

Somente leitura

Escolhas de comparáveis de IA e raciocínio

Grátis

get_expense_estimates

Somente leitura

Estimativas de despesas de IA

Grátis

Propriedade e aluguéis

get_property_details

Somente leitura

Camas, tamanho, valor e impostos para um endereço nos EUA

$0.05 (5 unidades)

get_rent_estimate

Somente leitura

Aluguel de longo prazo com aluguéis comparáveis

$0.05 (5 unidades)

get_section8_rents

Somente leitura

Aluguéis do Censo e Section 8 (HUD) por CEP

Grátis

Calculadoras

calculate_amortization

Somente leitura

Pagamento do empréstimo e cronograma

Grátis

calculate_dscr

Somente leitura

Índice de cobertura do serviço da dívida

Grátis

calculate_tax_benefits

Somente leitura

Depreciação e economias fiscais

Grátis

calculate_sell_or_refinance

Somente leitura

Comparar venda com refinanciamento

Grátis

Otimizador de Listagens

run_listing_optimization

Salva na sua conta

Reescrever e classificar um anúncio do Airbnb

1 crédito

get_listing_optimization

Somente leitura

Status e pontuação de uma execução

Grátis

list_listing_optimizations

Somente leitura

Suas execuções passadas

Grátis

get_listing_optimization_report_url

Somente leitura

Link de download para um relatório

Grátis

Conta e registos

get_account

Somente leitura

Status do plano, créditos e chave

Grátis

get_usage

Somente leitura

Solicitações e uso faturado

Grátis

get_api_health

Somente leitura

Verificar se a API está ativa

Grátis

get_material_participation

Somente leitura

Horas e testes de participação do material

Grátis

log_material_participation_hours

Salva na sua conta

Registrar horas para uma propriedade

Grátis

Limites

  • Pesquisas de dados compartilham um limite diário com a API REST. Ele é reiniciado às 00:00 UTC e as pesquisas com falha também contam.
  • O trabalho de IA é limitado a 10 solicitações por minuto e 2 simultaneamente por conta.
  • As análises não podem ser editadas ou excluídas através do MCP.

Erros

O servidor responde com um status HTTP e uma mensagem que nomeia a causa. O guia de configuração lista os comuns com suas correções.

Erros comuns e correções Verificar status do servidor