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). Isso permite que assistentes de IA como o Claude Desktop chamem 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 servidor usa transporte stdio, padrão para clientes MCP locais.

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)

Instalação

Clone o repositório, instale as dependências e compile o servidor MCP:

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

Configuração no Claude Desktop

Adicione o bloco abaixo no arquivo de configuração do Claude Desktop (claude_desktop_config.json). Substitua /caminho/para/alugar-ou-comprar pelo caminho absoluto do repositório no seu sistema.

{
  "mcpServers": {
    "alugar-ou-comprar": {
      "command": "node",
      "args": ["/caminho/para/alugar-ou-comprar/dist/mcp/index.js"]
    }
  }
}

Configuração em outros clientes MCP

Qualquer cliente compatível com MCP pode se conectar via stdio. O servidor se chama alugar-ou-comprar e o ponto de entrada é dist/mcp/index.js. Reinicie o cliente após adicionar a configuração para que as ferramentas fiquem disponíveis.

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.