Alugar ou Comprar — MCP Server

Official6 tools

by ronybarbosa

Motor financeiro determinístico: simula comprar vs alugar imóvel.

MCP Server: io.github.ronybarbosa/alugar-ou-comprar

This MCP server provides a deterministic financial model that simulates choosing between buying and renting a property. It is described with the name “io.github.ronybarbosa/alugar-ou-comprar” and includes a tool set totaling 6 tools.

🛠️ Key Features

Deterministic financial simulation for real estate decisions
Compares buying vs renting outcomes
Exposed as an MCP server with 6 tools

🚀 Use Cases

Modeling the trade-offs between purchasing and renting an imóvel (property)
Running consistent, repeatable “buy vs rent” scenarios

⚡ Developer Benefits

Deterministic behavior for stable results across runs
Programmatic access via 6 MCP tools

⚠️ Limitations

Available metadata does not describe model assumptions, inputs, or output formats beyond “simula comprar vs alugar imóvel”

Captured live from the server via tools/list.

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 em https://alugar-ou-comprar.vercel.app.

Parameters18

valorImovel	number	required	Valor do imóvel (R$)
aluguelMensal	number	required	Aluguel mensal inicial (R$)
tempoPermanenciaAnos	number	optional	Horizonte de permanência em anos
entradaPct	number	optional	Percentual de entrada (%)
prazoAnos	number	optional	Prazo do financiamento em anos
amortizationSystem	string	optional	Sistema de amortização (PRICE ou SAC)
taxaFinanciamentoNominalPct	number	optional	Taxa de juros nominal anual do financiamento (%)
taxaValorizacaoPct	number	optional	Taxa anual de valorização do imóvel (%)
inflacaoPct	number	optional	Inflação anual esperada (%)
custosManutencaoPct	number	optional	Custos anuais de manutenção (% do valor do imóvel)
condominioMensalPctOfValue	number	optional	Condomínio mensal (% do valor do imóvel)
iptuAnualPct	number	optional	IPTU anual (% do valor do imóvel)
seguroPct	number	optional	Seguro anual do financiamento (% do valor do imóvel)
custoOportunidadePct	number	optional	Rendimento anual alternativo do capital (%)
rentIncreasePct	number	optional	Reajuste anual do aluguel (%)
taxasTransacaoCompraPct	number	optional	Total de taxas de transação de compra (% do valor do imóvel)
taxasTransacaoVendaPct	number	optional	Total de taxas de transação de venda (% do valor do imóvel)
itbiPct	number	optional	ITBI (% do valor do imóvel)

Raw schema

{
  "type": "object",
  "properties": {
    "valorImovel": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Valor do imóvel (R$)"
    },
    "aluguelMensal": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Aluguel mensal inicial (R$)"
    },
    "tempoPermanenciaAnos": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Horizonte de permanência em anos"
    },
    "entradaPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Percentual de entrada (%)"
    },
    "prazoAnos": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Prazo do financiamento em anos"
    },
    "amortizationSystem": {
      "type": "string",
      "enum": [
        "PRICE",
        "SAC"
      ],
      "description": "Sistema de amortização (PRICE ou SAC)"
    },
    "taxaFinanciamentoNominalPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Taxa de juros nominal anual do financiamento (%)"
    },
    "taxaValorizacaoPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Taxa anual de valorização do imóvel (%)"
    },
    "inflacaoPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Inflação anual esperada (%)"
    },
    "custosManutencaoPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Custos anuais de manutenção (% do valor do imóvel)"
    },
    "condominioMensalPctOfValue": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Condomínio mensal (% do valor do imóvel)"
    },
    "iptuAnualPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "IPTU anual (% do valor do imóvel)"
    },
    "seguroPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Seguro anual do financiamento (% do valor do imóvel)"
    },
    "custoOportunidadePct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Rendimento anual alternativo do capital (%)"
    },
    "rentIncreasePct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Reajuste anual do aluguel (%)"
    },
    "taxasTransacaoCompraPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Total de taxas de transação de compra (% do valor do imóvel)"
    },
    "taxasTransacaoVendaPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Total de taxas de transação de venda (% do valor do imóvel)"
    },
    "itbiPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "ITBI (% do valor do imóvel)"
    }
  },
  "required": [
    "valorImovel",
    "aluguelMensal"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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) em https://alugar-ou-comprar.vercel.app.

Parameters18

valorImovel	number	required	Valor do imóvel (R$)
aluguelMensal	number	required	Aluguel mensal inicial (R$)
tempoPermanenciaAnos	number	optional	Horizonte de permanência em anos
entradaPct	number	optional	Percentual de entrada (%)
prazoAnos	number	optional	Prazo do financiamento em anos
amortizationSystem	string	optional	Sistema de amortização (PRICE ou SAC)
taxaFinanciamentoNominalPct	number	optional	Taxa de juros nominal anual do financiamento (%)
taxaValorizacaoPct	number	optional	Taxa anual de valorização do imóvel (%)
inflacaoPct	number	optional	Inflação anual esperada (%)
custosManutencaoPct	number	optional	Custos anuais de manutenção (% do valor do imóvel)
condominioMensalPctOfValue	number	optional	Condomínio mensal (% do valor do imóvel)
iptuAnualPct	number	optional	IPTU anual (% do valor do imóvel)
seguroPct	number	optional	Seguro anual do financiamento (% do valor do imóvel)
custoOportunidadePct	number	optional	Rendimento anual alternativo do capital (%)
rentIncreasePct	number	optional	Reajuste anual do aluguel (%)
taxasTransacaoCompraPct	number	optional	Total de taxas de transação de compra (% do valor do imóvel)
taxasTransacaoVendaPct	number	optional	Total de taxas de transação de venda (% do valor do imóvel)
itbiPct	number	optional	ITBI (% do valor do imóvel)

Raw schema

{
  "type": "object",
  "properties": {
    "valorImovel": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Valor do imóvel (R$)"
    },
    "aluguelMensal": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Aluguel mensal inicial (R$)"
    },
    "tempoPermanenciaAnos": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Horizonte de permanência em anos"
    },
    "entradaPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Percentual de entrada (%)"
    },
    "prazoAnos": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Prazo do financiamento em anos"
    },
    "amortizationSystem": {
      "type": "string",
      "enum": [
        "PRICE",
        "SAC"
      ],
      "description": "Sistema de amortização (PRICE ou SAC)"
    },
    "taxaFinanciamentoNominalPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Taxa de juros nominal anual do financiamento (%)"
    },
    "taxaValorizacaoPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Taxa anual de valorização do imóvel (%)"
    },
    "inflacaoPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Inflação anual esperada (%)"
    },
    "custosManutencaoPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Custos anuais de manutenção (% do valor do imóvel)"
    },
    "condominioMensalPctOfValue": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Condomínio mensal (% do valor do imóvel)"
    },
    "iptuAnualPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "IPTU anual (% do valor do imóvel)"
    },
    "seguroPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Seguro anual do financiamento (% do valor do imóvel)"
    },
    "custoOportunidadePct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Rendimento anual alternativo do capital (%)"
    },
    "rentIncreasePct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Reajuste anual do aluguel (%)"
    },
    "taxasTransacaoCompraPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Total de taxas de transação de compra (% do valor do imóvel)"
    },
    "taxasTransacaoVendaPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Total de taxas de transação de venda (% do valor do imóvel)"
    },
    "itbiPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "ITBI (% do valor do imóvel)"
    }
  },
  "required": [
    "valorImovel",
    "aluguelMensal"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters7

rendaLiquidaMensal	any	required
comprometimentoExistenteMensal	any	optional
taxaJurosAnualPct	number	optional	Taxa de juros anual (%)
prazoAnos	number	optional	Prazo do financiamento em anos
entradaPct	number	optional	Percentual de entrada (%)
custosTransacaoPct	number	optional	Custos totais de transação (% do valor do imóvel)
itbiPct	number	optional	ITBI (% do valor do imóvel)

Raw schema

{
  "type": "object",
  "properties": {
    "rendaLiquidaMensal": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0,
          "description": "Renda líquida mensal total (R$)"
        },
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "rendaLiquidaMensal": {
                "type": "number",
                "minimum": 0,
                "description": "Renda líquida mensal da pessoa (R$)"
              },
              "comprometimentoExistenteMensal": {
                "type": "number",
                "minimum": 0,
                "description": "Comprometimento de renda existente da pessoa (R$)"
              }
            },
            "required": [
              "rendaLiquidaMensal"
            ],
            "additionalProperties": false
          },
          "description": "Lista de rendas individuais (modo casal)"
        }
      ]
    },
    "comprometimentoExistenteMensal": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0,
          "description": "Comprometimento existente total (R$)"
        },
        {
          "type": "array",
          "items": {
            "type": "number",
            "minimum": 0
          },
          "description": "Comprometimentos individuais (R$)"
        }
      ]
    },
    "taxaJurosAnualPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Taxa de juros anual (%)"
    },
    "prazoAnos": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Prazo do financiamento em anos"
    },
    "entradaPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Percentual de entrada (%)"
    },
    "custosTransacaoPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Custos totais de transação (% do valor do imóvel)"
    },
    "itbiPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "ITBI (% do valor do imóvel)"
    }
  },
  "required": [
    "rendaLiquidaMensal"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

municipioId	string	optional	ID do município (ex: sao-paulo-sp)
uf	string	optional	Sigla da UF (ex: SP)
nome	string	optional	Nome do município (busca parcial, ex: São Paulo)

Raw schema

{
  "type": "object",
  "properties": {
    "municipioId": {
      "type": "string",
      "description": "ID do município (ex: sao-paulo-sp)"
    },
    "uf": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Sigla da UF (ex: SP)"
    },
    "nome": {
      "type": "string",
      "description": "Nome do município (busca parcial, ex: São Paulo)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_default_parameters

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_site_info

Retorna informações sobre o site É melhor alugar ou comprar um imóvel e como acessar os painéis interativos.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (6)

simulate_buy_vs_rentgenerate_share_linkcheck_affordabilityget_municipio_ratesget_default_parametersget_site_info

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "alugar-ou-comprar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://alugar-ou-comprar.vercel.app/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: io.github.ronybarbosa/alugar-ou-comprar

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

simulate_buy_vs_rent

generate_share_link

check_affordability

get_municipio_rates

get_default_parameters

get_site_info

Install

Remote endpoint

Related servers