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
46 ferramentas 4 hubs Streamable HTTP MCP 2025-06-18 sem autenticação gratuito

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 46 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.

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