ESTIMEI INFRASTRUCTURE · MODEL CONTEXT PROTOCOL (MCP)

Infraestrutura de Cálculos Financeiros e Imobiliários para Agentes de IA

Substitua alucinações de LLM por cálculos matemáticos auditados, com memória de cálculo, índices oficiais (BCB, CUB, SINAPI) e base legal expressa.

ENDPOINT https://mcp.estimei.com.br/mcp
68 ferramentas 4 hubs Streamable HTTP MCP 2025-06-18 sem autenticação gratuito

🟢 Servidor MCP Operacional · Versão estável 1.23

Quickstart

Como conectar (1 minuto)

Servidor remoto, sem chave de API e sem instalação no lado do servidor. Escolha o seu ambiente:

claude.ai e Claude Desktop — servidores remotos entram como conector personalizado:

  1. Abra Configurações › Conectores e escolha adicionar um conector personalizado.
  2. Nome: Estimei · URL: https://mcp.estimei.com.br/mcp
  3. Salve e ative o conector na conversa. As 68 ferramentas aparecem na lista de ferramentas do Claude.

Alternativa pelo arquivo claude_desktop_config.json — o arquivo aceita servidores locais (stdio), então o servidor remoto entra por meio da ponte mcp-remote (requer Node.js):

claude_desktop_config.json

{
  "mcpServers": {
    "estimei": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.estimei.com.br/mcp"
      ]
    }
  }
}

Especificações técnicas

Protocolo, respostas e erros

Transporte

  • Streamable HTTP, JSON-RPC 2.0 via POST em /mcp.
  • Protocolo MCP 2025-06-18.
  • Envie Accept: application/json, text/event-stream; a resposta vem como SSE (event: message).
  • O initialize devolve Mcp-Session-Id — reenvie nas chamadas seguintes.

Acesso

  • Sem autenticação e sem chave de API.
  • CORS liberado (*), com mcp-session-id exposto — dá para chamar do navegador.
  • A resposta chega em cerca de 1 s; o servidor fecha o stream alguns segundos depois. Processe o evento assim que ele chegar (os SDKs oficiais já fazem isso).

Formato da saída

  • result.content[0].text é um JSON com os campos do cálculo.
  • Toda resposta traz fonte (URL da calculadora equivalente no site) e aviso (disclaimer).
  • Mesma entrada, mesma saída. A exceção são as ferramentas com CUB, que usam o valor oficial vigente do mês.

Dados de mercado

  • CUB das 27 UFs lido ao vivo da mesma tabela que o site usa, atualizada mensalmente a partir dos Sinduscons.
  • Parâmetros que dependem do seu caso (taxas, prazos, percentuais) entram como argumento e são sempre explícitos.

Tratamento de erros

Erros voltam dentro de result, com isError: true e a mensagem em content[0].text — não como objeto error do JSON-RPC. Dois casos reais:

Regra de negócio (argumentos válidos, cenário sem sentido)

{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Erro: A nova taxa deve ser menor que a taxa atual para valer a pena."
      }
    ],
    "isError": true
  }
}

Validação de entrada (−32602: argumento obrigatório ausente ou tipo errado)

{
  "jsonrpc": "2.0",
  "id": 8,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "MCP error -32602: Input validation error: Invalid arguments for tool calcular_sac_vs_price: Required at taxaAnual\nRequired at prazoAnos"
      }
    ],
    "isError": true
  }
}

Boas práticas

  • Mostre ao usuário final o aviso e o link de fonte — o resultado é uma estimativa educativa e a página da calculadora tem a memória de cálculo completa.
  • Use as descrições do inputSchema: unidades (R$, %, meses, m²) e valores-padrão estão documentados em cada parâmetro. A resposta traz também structuredContent, validado contra o outputSchema da ferramenta, com a unidade de cada campo de saída.
  • Para ter tudo num arquivo só (entradas, saídas, fórmula, fontes, exemplo auditado e o campo do site de cada parâmetro): /calculadoras.json, com o schema em /calculadoras.schema.json.
  • Defina um User-Agent próprio em clientes HTTP escritos à mão — o padrão do urllib do Python é barrado pela proteção de borda.
  • Agentes que leem contexto direto: /llms.txt resume o Estimei e aponta para este servidor. Metodologia e fontes: Metodologia · Qualidade · Fontes Oficiais.

Governança

Disponibilidade, limites e telemetria

Status público

GET https://mcp.estimei.com.br/health (ou /status), sem cache e com CORS aberto. Formato da resposta:

Exemplo de resposta

{
  "status": "healthy",
  "versao": "1.23.0",
  "uptime": "ok",
  "timestamp": "2026-10-14T19:50:00.000Z"
}

uptime: "ok" quer dizer que o servidor respondeu agora. O selo no topo desta página consulta esse endereço a cada visita.

Limite de requisições

  • 60 requisições por minuto por IP em /mcp, sem autenticação. Toda requisição conta (initialize, tools/list e tools/call).
  • O limite é contado em cada data center da Cloudflare, não no mundo inteiro, e o contador é aproximado: numa rajada curta, algumas requisições acima de 60 ainda passam antes do 429.
  • Acima dele: HTTP 429, cabeçalho Retry-After: 60 e corpo JSON-RPC com error.code -32029.
  • Tratamento recomendado: respeite o Retry-After, use espera exponencial com variação aleatória, reaproveite a sessão (Mcp-Session-Id) e não repita tools/list a cada pergunta.

Telemetria

  • Em cada tools/call registramos o nome da ferramenta, o tipo de cliente (Claude, Cursor, LangChain…, pelo User-Agent), o status HTTP e o User-Agent (até 200 caracteres).
  • Não registramos IP, argumentos nem resultados. O uso serve para medir estabilidade e priorizar ferramentas.

Contratos JSON Schema

Changelog de esquemas

Compatibilidade retroativa: nenhum campo de saída é removido nem muda de tipo ou de unidade sem transição de versão anunciada aqui. Campos novos podem chegar a qualquer momento: trate como opcional o campo que o seu cliente não conhece. Correções de cálculo podem mudar valores sem mudar o contrato, e também entram nesta lista.

Conferido no histórico: desde a publicação do outputSchema (30/09/2026), nenhum campo de saída foi removido de nenhuma ferramenta, só adicionados.

  • 02/11/2026Servidor 1.11.0
    • Nova ferramenta calcular_itbi: o ITBI da compra pela lei da cidade (lista oficial de 54 cidades), com a regra do SFH na parte financiada onde a lei tem e a economia sobre o à vista; a base é o valor da compra (STJ, Tema 1.113) e, com a avaliação da prefeitura maior, sai a diferença contestável. Mesma fórmula da Calculadora de ITBI do site. É a 55ª ferramenta do servidor.
  • 02/11/2026Servidor 1.10.0
    • Nova ferramenta calcular_concreto: quantos sacos de cimento de 50 kg, quanta areia, brita e água para a calçada, o piso, a laje, a sapata, a viga, o pilar ou a broca, pelos coeficientes oficiais do SINAPI 09/2026 (concreto feito em betoneira, do magro ao C30), com 10% de perda sobre o solo e 5% em peça com forma, a receita da betonada em latas e o fazer × comprar contra o concreto usinado pelo SINAPI do estado. Mesma fórmula da Calculadora de Concreto do site. É a 54ª ferramenta do servidor.
  • 02/11/2026Servidor 1.9.0
    • Nova ferramenta calcular_alvenaria: quantos tijolos ou blocos e quantos sacos de argamassa pronta de 20 kg para levantar a parede, o cômodo ou o muro (área líquida sem portas e janelas, peças por m² pela face vista com a junta, perda e argamassa de junta cheia a 1,65 kg por litro), com as 7 peças de catálogo das ABNT NBR 15270-1 e NBR 6136-1 ou medidas próprias e o custo opcional. Mesma fórmula da Calculadora de Tijolos e Blocos do site. É a 53ª ferramenta do servidor.
  • 01/11/2026Servidor 1.8.0
    • Nova ferramenta calcular_eletrica: a bitola do fio de cobre e o disjuntor de um circuito pela ABNT NBR 5410 (corrente pela potência, tensão e fator de potência; Tabela 36, seção mínima e queda de tensão de até 4% no comprimento do circuito), com a bitola por cada critério, o comprimento máximo e o aviso de circuito independente acima de 10 A. Mesma fórmula da Calculadora de Bitola do Fio e Disjuntor do site. É a 52ª ferramenta do servidor.
  • 29/10/2026Servidor 1.7.0
    • Nova ferramenta calcular_btu: quantos BTUs de ar-condicionado um cômodo precisa (600 ou 800 BTU/h por m² conforme o sol, pessoas e aparelhos, ou a potência dos aparelhos em watts), a potência comercial indicada e, acima de 60.000 BTU/h, a divisão em 2 a 4 aparelhos iguais, com o consumo pelo IDRS da etiqueta do Inmetro. Valores fora do comum saem em avisos, sem recusar a conta. É a 51ª ferramenta do servidor.
  • 28/10/2026Servidor 1.6.0
    • Nova ferramenta calcular_consorcio_vs_financiamento: o mesmo imóvel pelo consórcio e pelo financiamento em dinheiro de hoje, com taxa de administração, fundo de reserva e carta reajustada (Res. BCB 285/2023), aluguel até a contemplação, lance livre ou embutido, o mês-limite de contemplação e o aluguel de equilíbrio. Valores fora do comum saem em avisos, sem recusar a conta.
  • 27/10/2026Servidor 1.5.1
    • Correção em calcular_financiamento_reforma: menorTaxaModalidade passa de 1,17% (faixa antiga) para 0,99% ao mês, a taxa final do Reforma Casa Brasil (Portaria MCID nº 1.177/2025, alterada pela 498/2026), igual ao site.
  • 27/10/2026Servidor 1.5.0
    • Nova ferramenta calcular_minha_casa_minha_vida: a faixa pela renda (Portaria MCID 333/2026), os juros oficiais pela região e pelos 3 anos de FGTS (IN MCID 48), a 1ª parcela pelo SAC e pela Price com TR, o limite de 30% da renda com a entrada que falta e o subsídio informado, conferido contra o teto oficial.
  • 27/10/2026Servidor 1.4.0
    • calcular_fgts_financiamento, fórmula v2: FGTS que paga o imóvel inteiro vira compra à vista com o FGTS (compraAVista, semFinanciamento, primeiraEntrada sem valor, nunca parcela de R$ 0,00); FGTS obrigatório na entrada pela cota do banco entra como mínimo nos 3 caminhos (contrato, fgtsEntradaMinima) e o veredito segue pelo valor presente; entrada + FGTS abaixo da entrada mínima é recusada.
  • 26/10/2026Servidor 1.3.0
    • Nova ferramenta calcular_fgts_financiamento: o mesmo FGTS na entrada, guardado para amortizar no mês 24 ou abatendo 80% das parcelas por 12 meses (Lei 8.036/1990), com o veredito pelo custo em valor presente, empate técnico abaixo de 0,5 ponto, a entrada mínima pela cota do banco e o teto do SFH (R$ 2,25 mi).
  • 26/10/2026Servidor 1.2.0
    • Nova ferramenta calcular_tr_vs_ipca_financiamento: o mesmo financiamento com juros + TR ou juros + IPCA, com o custo real de cada um, o IPCA de equilíbrio e por quantos meses o saldo devedor sobe nos cenários de IPCA otimista (3,0%), base e crítico (+3 pontos).
  • 14/10/2026Servidor 1.1.0
    • /health e /status; limite de 60 requisições por minuto por IP (HTTP 429 com Retry-After); telemetria de uso sem IP e sem argumentos.
    • calcular_sac_vs_price: novos campos mesCruzamentoParcelas, parcelaSACNoCruzamento, mesInflexaoPrice e pctEconomiaJuros.
    • Correção de cálculo, sem mudar campos: amortização do SAC sem arredondar em 7 ferramentas, igual ao site (ex.: economiaSAC de R$ 202.526,95 para R$ 202.526,76 no cenário de R$ 320 mil a 10,26% em 30 anos).
  • 05/10/2026analisar_leilao/1.1
    • Novo bloco limiteJornada; o linkSimulacao passa a abrir a Jornada do Leilão com os números da chamada.
  • 30/09/2026outputSchema em todas as ferramentas
    • Toda resposta passa a trazer structuredContent validado; analisar_leilao público, com o Risk Score 4D; calcular_risk_score_leilao ganha dimensoes e avisosLiquidez; calcular_viabilidade_trt_hub ganha taxaIndexador.
  • 29/09/2026Cinco ferramentas novas
    • Amortização extraordinária, desconto do 1º imóvel no SFH, isenção de IR em 180 dias, Ciclo BRRRR e Risk Score.
  • 31/08/2026Servidor 1.0.0
    • Primeira versão pública em mcp.estimei.com.br.

Cookbook

Exemplo reproduzível: análise de um imóvel de leilão

Chamada e resposta reais do servidor (retrato de 21/11/2026). Mesma entrada, mesma saída, salvo o CUB, que segue o valor oficial do mês.

1. A pergunta do usuário

“Vale dar um lance de R$ 240.000 num apartamento de 70 m² em São Paulo, avaliado em R$ 400.000, ocupado, sem reforma?”

2. A chamada que o agente faz

tools/call → analisar_leilao

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "analisar_leilao",
    "arguments": {
      "avaliacao": 400000,
      "lance": 240000,
      "uf": "SP",
      "municipio": "São Paulo",
      "areaM2": 70,
      "ocupacao": "terceiro",
      "nivelReforma": "nenhuma",
      "iptuMensal": 120,
      "tipoImovel": "residencial",
      "taxaCDIAnualPct": 13.65
    }
  }
}

3. A resposta estruturada (resumo de structuredContent)

structuredContent

{
  "veredito": {
    "semaforo": "amarelo",
    "resumo": "Lance 12,2% abaixo do teto de lance; ROI anualizado de 29,5% supera o CDI (13,65%); risco moderado — dimensão de maior risco: Operacional (60/100).",
    "motivos": [
      "risco moderado (operacional)"
    ]
  },
  "tetoLance": {
    "valor": 273302,
    "roiAlvoPct": 20
  },
  "limiteJornada": {
    "valor": 263339,
    "folga": 23339
  },
  "capital": {
    "dia1": 268400,
    "total": 277840
  },
  "retorno": {
    "lucroLiquido": 82020,
    "roiAnualizadoPct": 29.52,
    "superaCDI": true
  },
  "risco": {
    "score": 60,
    "nomeFaixa": "Risco Moderado",
    "dimensaoDominante": "operacional"
  },
  "linkSimulacao": "https://estimei.com.br/calculadoras/jornada-leilao/?jornadaModalidade=leiloeiro&jornadaEstado=SP&jornadaTipo=residencial&jornadaAvaliacao=400000&jornadaPrecoVenda=400000&jornadaLance=240000&jornadaArea=70&jornadaPrazoVenda=12&jornadaOcupacao=terceiro_litigioso&jornadaComissao=5&jornadaITBI=3&jornadaEscritura=1.5&jornadaRegistro=0.8&jornadaDividas=0&jornadaDesocupacao=2&jornadaNivelReforma=nenhuma&jornadaIPTU=120&jornadaCondominio=0&jornadaAgua=0&jornadaComissaoVenda=6&jornadaMeta=20&utm_source=estimei-mcp&utm_medium=ia",
  "…": "demais campos: custosAquisicao, desocupacao, reforma, premissas, fontes, motor, fonte, aviso"
}

4. A validação no Estimei

O linkSimulacao abre a Jornada do Leilão com os mesmos números, com a memória de cálculo e o Relatório Completo. Mostre esse link ao usuário junto com o aviso.

Os resultados são estimativas educativas e não substituem profissional habilitado — ver Termos de Uso. Metodologia v1.9 — novembro/2026.