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.
- 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çãoFerramentas pagas e aprovação
Uma ferramenta paga chamada sem confirmed: true não executa nada e retorna uma cotação de preço. Mostre a cotação ao usuário e repita a chamada com confirmed: true somente depois que ele aprovar.
Apenas chamadas bem-sucedidas são cobradas. Uma chamada que falha ou não retorna dados não custa nada. Não tente novamente automaticamente uma chamada paga após um tempo limite: ela ainda pode ser concluída e cobrada.
Ferramentas que criam uma análise adicionam 10 unidades para cada função de IA que é concluída.
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
get_report_link
Somente leitura
Link de relatório compartilhável
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