Como usar o MCP

O É melhor alugar ou comprar um imóvel expõe seu motor de simulação financeira como um servidor MCP (Model Context Protocol) acessível remotamente. Assistentes de IA como o Claude Desktop podem chamar diretamente as ferramentas de simulação, geração de links e consulta de parâmetros, integrando os cálculos em conversas com o usuário. O endpoint de conexão é https://alugar-ou-comprar.vercel.app/api/mcp e usa o transporte Streamable HTTP, compatível com clientes MCP modernos.

Ferramentas disponíveis

O servidor alugar-ou-comprar registra 6 ferramentas. Campos marcados com * são obrigatórios; os demais usam defaults brasileiros.

• simulate_buy_vs_rent

  Executa a simulação determinística "comprar vs alugar" para um imóvel. Retorna veredito, ano de breakeven, custos do primeiro mês, snapshots anuais e um link para o painel interativo.

  Parâmetros: valorImovel*, aluguelMensal*, tempoPermanenciaAnos, entradaPct, prazoAnos, amortizationSystem, taxaFinanciamentoNominalPct, ...

• generate_share_link

  Gera links compartilháveis para a simulação: um com query params (preenche o formulário da home) e outro no formato /simular/<slug> (painel interativo completo com gráficos).

  Parâmetros: valorImovel*, aluguelMensal*, ... (mesmos parâmetros de simulate_buy_vs_rent)

• check_affordability

  Calcula o valor máximo de imóvel que a renda familiar consegue financiar, considerando regras de comprometimento de renda, entrada e custos de transação.

  Parâmetros: rendaLiquidaMensal*, comprometimentoExistenteMensal, taxaJurosAnualPct, prazoAnos, entradaPct, custosTransacaoPct, itbiPct

• get_municipio_rates

  Busca alíquotas de ITBI, IPTU, escritura e registro de um município brasileiro. Passe municipioId para busca exata, ou uf/nome para filtrar. Sem filtro retorna a lista completa.

  Parâmetros: municipioId, uf, nome

• get_default_parameters

  Retorna o conjunto ativo de parâmetros padrão brasileiros (taxas, prazos, custos) usados pelo site e pelas simulações.

  Parâmetros: (sem parâmetros)

• get_site_info

  Retorna informações sobre o site e como acessar os painéis interativos (home, cenários e diagnóstico).

  Parâmetros: (sem parâmetros)

Conexão remota

Não é necessário clonar ou compilar o repositório. Basta apontar seu cliente MCP para o endpoint abaixo:

https://alugar-ou-comprar.vercel.app/api/mcp

Configuração no Claude Desktop

Adicione o bloco abaixo no arquivo de configuração do Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "alugar-ou-comprar": {
      "url": "https://alugar-ou-comprar.vercel.app/api/mcp"
    }
  }
}

Configuração em outros clientes MCP

Qualquer cliente compatível com MCP Streamable HTTP pode usar o servidor alugar-ou-comprar apontando para https://alugar-ou-comprar.vercel.app/api/mcp. Reinicie o cliente após adicionar a configuração para que as ferramentas fiquem disponíveis.

Desenvolvimento local

Para testes internos, o transporte stdio continua disponível via entry point local. Apenas colaboradores com acesso ao repositório podem executá-lo:

npm install
npm run mcp:build
npm run mcp:start

Exemplo de uso

Após configurar, pergunte ao assistente de IA algo como:

Simule comprar vs alugar para um imóvel de R$ 400.000 com aluguel de R$ 2.000.

O assistente chamará a ferramenta simulate_buy_vs_rent e retornará o veredito, o ano de breakeven e um link para o painel interativo com gráficos e detalhes completos.

Conheça a metodologia por trás dos cálculos ou acesse o painel interativo para testar a simulação no navegador.