Alugar ou Comprar — MCP Server

io.github.ronybarbosaPublished by GitHub account ronybarbosav1.0.0Updated Oct 25, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinance

Overview

AI-generated overview

A remote Brazilian real-estate finance server that lets an assistant simulate buying versus renting a property, with affordability, financing cost and tax-rate,

What you can do
Run buy-versus-rent simulations, including multiple pessimistic/base/optimistic scenarios, with verdict, breakeven year and final equity advantage, and cross-parameter sensitivity matrices showing buy or rent per cell. Get contextual recommendations by intended stay horizon, plus comparisons of three strategies for using extra monthly income (pay the installment, invest, or amortize). Check affordability and the maximum property price supported by family income or by a target monthly rent. Calculate rental yield and the annual effective total cost (CET) of a mortgage including MIP/DFI insurance and fees. Look up Brazilian municipal ITBI, IPTU, deed and registration rates, project the TR rate
When to use it
Useful when someone is weighing renting against buying a home in Brazil and wants deterministic numbers: breakeven timing, equity outcomes, affordability limits, financing costs, municipal transaction taxes or amortization trade-offs. Also handy for generating shareable simulation links to the provider's web panels.
Requirements
A remote streamable HTTP endpoint; no package, account, API key or environment variable is declared. The simulations rely on built-in Brazilian default parameters, and the TR projection uses the server's own historical data.
Before you install
Results are deterministic projections from default Brazilian assumptions, not financial advice; verify rates and costs for the specific municipality and contract. The share-link tool produces public links to the provider's site containing the simulation parameters, so avoid putting sensitive personal or financial details into them.

Installation

In SourceWeft

  1. Open Alugar ou Comprar — MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ronybarbosa%2Falugar-ou-comprar/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

This repository has no README.

Tools

13

sensitivity_analysis

Executa uma análise de sensibilidade cruzando taxas de valorização do imóvel com rendimentos do investimento alternativo. Retorna uma matriz onde cada célula indica se compensa comprar (C) ou alugar (A), além do ano de breakeven patrimonial. Reusa o mesmo motor de simulação de simulate_buy_vs_rent.

ParameterscetPctitbiPctprazoAnosseguroPcttrHistoryentradaPctinflacaoPcttrMensalPctvalorImovelrequirediptuAnualPctaluguelMensalrequiredfgtsDisponivel+20 more

simulate_buy_vs_rent

Executa a simulação determinística "comprar vs alugar" para um imóvel. Aceita parâmetros simples ou múltiplos cenários (pessimista/base/otimista) via campo "cenarios". Retorna veredito, ano e mês de breakeven, vantagem patrimonial final, custos do primeiro mês, snapshots anuais com patrimônio comprador e locatário, e um link para o painel interativo em https://alugar-ou-comprar.vercel.app.

Takes no parameters.

recommendation_contextual

Gera uma recomendação contextual entre alugar e comprar, considerando horizonte de permanência e sensibilidade aos parâmetros de valorização do imóvel e rendimento do investimento alternativo. Retorna horizonte de corte (breakeven patrimonial), veredito ano a ano, thresholds de sensibilidade e um texto de recomendação pronto para o usuário.

ParameterscetPctitbiPctprazoAnosseguroPcttrHistoryentradaPctinflacaoPcttrMensalPctvalorImovelrequirediptuAnualPctaluguelMensalrequiredfgtsDisponivel+18 more

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.

ParametersitbiPctprazoAnosentradaPcttaxaJurosAnualPctcustosTransacaoPctrendaLiquidaMensalrequiredcomprometimentoExistenteMensal

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.

ParametersufnomemunicipioId

get_rental_yield

Calcula o rental yield (retorno anual e mensal) a partir do valor do imóvel e do aluguel mensal. Interpreta o indicador: < 5% a.a. = aluguel relativamente barato; 5–7% = intermediário; 7–9% = aluguel caro; > 9% = aluguel muito caro. Indicador inicial, não é uma regra absoluta.

ParametersvalorImovelrequiredaluguelMensalrequired

calculate_cet

Calcula o CET (Custo Efetivo Total) anual de um financiamento imobiliário, incluindo juros, seguros MIP/DFI e taxas administrativas. Aceita os mesmos parâmetros da simulação comprar vs alugar.

ParameterscetPctitbiPctprazoAnosseguroPcttrHistoryentradaPctinflacaoPcttrMensalPctvalorImovelrequirediptuAnualPctaluguelMensalrequiredfgtsDisponivel+18 more

simulate_tr_evolution

Retorna uma série mensal projetada de TR (Taxa Referencial) para uso em financiamentos indexados. Modo 'historical' usa os dados de data/tr_historical.json; modo 'projected' usa TR base constante.

ParametersbaseTRmonthsrequiredscenario

max_price_from_rent

Calcula o preço máximo de imóvel compatível com um aluguel mensal máximo informado. Considera parcela de financiamento (PRICE), condomínio, IPTU, manutenção, seguros e custo de oportunidade da entrada. Retorna o preço máximo e o custo mensal estimado nos cenários atual, otimista (taxa -2%) e pessimista (taxa +2%).

ParametersprazoAnosseguroPctentradaPctiptuAnualPctseguroMipDfiPcttaxaJurosAnualPctamortizationSystemaluguelMensalMaximorequiredcondominioMensalPctcustosManutencaoPctcustoOportunidadePct

get_default_parameters

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

Takes no parameters.

compare_amortization_strategies

Compara 3 estratégias de uso de uma renda extra mensal: A) pagar apenas a parcela do financiamento, B) investir a renda extra, C) amortizar extraordinariamente o financiamento. Retorna o patrimônio líquido final de cada estratégia, o breakeven e uma recomendação.

ParametersitbiPctprazoAnosentradaPctvalorImovelrequirediptuAnualPctaluguelMensalrequiredrentIncreasePctrendaExtraMensalrequiredamortizationSystemtaxaValorizacaoPctcustoOportunidadePcttempoPermanenciaAnos+3 more

get_site_info

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

Takes no parameters.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.