# Alugar ou Comprar — MCP Server

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

- name: io.github.ronybarbosa/alugar-ou-comprar
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 90/100
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.ronybarbosa%2Falugar-ou-comprar
- tools: https://api.protogrid.dev/v1/servers/io.github.ronybarbosa%2Falugar-ou-comprar/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

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


## Trust

- hygiene: 100
- liveness: 100
- freshness: 85
- provenance: 75
- drivers: +repository +website +reachable +uptime-100% ~updated-55d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: generate_share_link (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_rental_yield (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); max_price_from_rent (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 5,307 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 13, about 5,307 tokens to load them all
- tool set hash: 079f18ff26e6a47e215901690dcd0a78
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.ronybarbosa/alugar-ou-comprar.svg)](https://protogrid.dev/servers/io.github.ronybarbosa/alugar-ou-comprar)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://alugar-ou-comprar.vercel.app/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (13)

- `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.
- `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.
- `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.
- `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.
- `get_default_parameters`: Retorna o conjunto ativo de parâmetros padrão brasileiros (taxas, prazos, custos) usados pelo site e pelas simulações.
- `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.
- `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.
- `get_site_info`: Retorna informações sobre o site É melhor alugar ou comprar um imóvel e como acessar os painéis interativos.
- `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%).
- `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.
- `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.
- `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.
- `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.