Servidor MCP

A Fábrica de Cálculos expõe um servidor MCP (Model Context Protocol) que disponibiliza as calculadoras previdenciárias e as tabelas de referência como ferramentas para agentes de IA — sem necessidade de integração REST manual.

Endpoint

O servidor responde em /mcp, no mesmo domínio deste portal, usando o transporte Streamable HTTP.

Autenticação

As requisições são autenticadas pelo cabeçalho x-api-key, com a mesma chave das demais APIs públicas. Solicite sua chave pelo portal — a emissão exige o aceite dos Termos de Uso.

Cuidados com a chave: configure-a no seu cliente MCP por meio de uma variável de ambiente referenciada no header x-api-key. A chave é anexada pelo cliente MCP na camada HTTP e nunca é vista pelo agente — ele não precisa conhecê-la para usar as ferramentas. Não a inclua em prompts, em conversas nem em arquivos versionados.

Limites de uso

As execuções de ferramentas consomem as mesmas cotas das APIs REST, conforme a classe de consumidor da chave — veja Limites de uso . O corpo das requisições ao /mcp é limitado a 8 MiB: como PDFs viajam em base64, o teto efetivo é de aproximadamente 6 MB de PDF por chamada. Arquivos maiores devem usar os endpoints REST diretamente, cujo limite de upload varia por classe de consumidor.

Exemplo de configuração do cliente

{
  "mcpServers": {
    "fabrica-de-calculos": {
      "url": "https://<dominio>/mcp",
      "headers": {
        "x-api-key": "${FC_API_KEY}"
      }
    }
  }
}

A sintaxe de expansão de variáveis de ambiente varia por cliente MCP: no exemplo acima (Claude Code), ${'$'}{FC_API_KEY}; no VS Code, ${'$'}{env:FC_API_KEY}. Consulte a documentação do seu cliente.

Ferramentas disponíveis

A lista abaixo é um guia de referência. A fonte autoritativa é a descoberta do próprio cliente MCP (operação tools/list), que devolve as ferramentas com seus schemas de entrada e descrições completas. O MCP não é uma API REST/OpenAPI — a documentação REST permanece nas demais páginas deste portal.

Tempo de contribuição (RGPS)

  • rgps_tempo_calcular — Calcula o tempo de contribuição do RGPS e verifica os requisitos dos benefícios.
  • rgps_tempo_calcular_por_grupos — Calcula o tempo de contribuição agrupando os resultados por combinações de períodos.
  • rgps_tempo_ler_cnis — Extrai os dados de um extrato CNIS (PDF em base64 ou texto puro) e devolve o objeto de cálculo de tempo pronto para uso.
  • rgps_tempo_ler_rdctc — Extrai os dados de um documento RDCTC (PDF em base64 ou texto puro) e devolve o objeto de cálculo de tempo pronto para uso.
  • rgps_tempo_ler_pap — Segmenta o PDF de um PAP e devolve os dados dos CNIS e RDCTC identificados com certeza, na ordem em que aparecem no arquivo.
  • rgps_tempo_calc_ler — Lê um arquivo .calc e devolve o objeto de cálculo de tempo de contribuição contido nele.
  • rgps_tempo_calc_calcular — Lê um arquivo .calc e calcula diretamente o tempo de contribuição contido nele.
  • rgps_tempo_calc_calcular_por_grupos — Lê um arquivo .calc e calcula o tempo de contribuição agrupando os resultados.

Renda Mensal Inicial (RGPS)

  • rgps_rmi_calcular — Calcula a Renda Mensal Inicial (RMI) para todos os benefícios cabíveis.
  • rgps_rmi_calcular_por_fundamento — Calcula a RMI apenas para o fundamento jurídico informado.
  • rgps_rmi_fundamentos — Lista os fundamentos jurídicos aceitos no cálculo de RMI por fundamento.
  • rgps_rmi_marcos_temporais — Lista os valores aceitos no campo marcoTemporal dos cálculos de RMI.

Indexadores e taxas

  • indices_tabela — Obtém a tabela de variação de indexadores e taxas de juros da Justiça Federal.
  • indices_reajuste — Obtém a tabela de reajuste de benefícios previdenciários.
  • indices_moedas — Obtém a tabela de moedas do período pré-Real.
  • indices_tabua_mortalidade — Obtém as tábuas de mortalidade (IBGE).
  • indices_adiantamento — Obtém a tabela de adiantamento de abono anual.
  • indices_os121 — Obtém a tabela de reajuste da OS 121 (período pré-Real).