API do Debit — cálculos jurídicos e financeiros

Visão geral

A API é REST, recebe e devolve JSON e está em https://mcp.debit.com.br/v1. O servidor MCP fica no mesmo domínio, em https://mcp.debit.com.br/mcp. A especificação completa está em /v1/openapi.json, com referência interativa em /v1/docs e manual em /v1/guia. Um resumo da especificação também é publicado neste domínio, em /openapi.yaml, junto com o manifesto para plugins e agentes em /.well-known/ai-plugin.json.

Dois pontos que evitam a maior parte dos erros de integração:

• Datas em DD/MM/AAAA (e MM/AAAA nos campos mensais). O formato AAAA-MM-DD é recusado — a exceção são os recortes de série (from, to em AAAA-MM) e o asOf das tabelas judiciais.
• Índice não é tabela judicial. O índice é uma série (/v1/indices); a tabela judicial diz qual índice corrige cada mês e quais juros incidem (/v1/tables). São espaços de identificador diferentes.

O cálculo criado pela API fica salvo na conta do usuário e aparece no painel do site, pronto para abrir, conferir e exportar. Os campos de cada tipo de cálculo saem de GET /v1/describe/{type}, e a entrada é validada antes de gravar: se um campo estiver errado, nada é gravado e a resposta diz qual é e o que se esperava.

Autenticação

Todas as chamadas exigem uma credencial no cabeçalho Authorization, como bearer token. Não há acesso anônimo: sem credencial válida a resposta é 401.

GET https://mcp.debit.com.br/v1/indices
Authorization: Bearer SUA_CHAVE

Quem já tem conta gera a própria chave no painel, em app.debit.com.br/menu/api — é o caminho mais simples, e ela vale tanto nas rotas REST quanto no MCP. Apagar a chave no painel encerra o acesso na mesma hora. Para conhecer os planos de uso, escreva para [email protected].

Outras formas de credencial

O acesso está em liberação gradual por conta — se a sua ainda não estiver habilitada, peça ao suporte.

Endpoints

Os principais. A lista completa, com todos os campos e respostas, está na referência interativa.

Tipos de cálculo

atualizacaoMonetaria, calculosJudiciais, pensaoAlimenticia, cartaoPonto, saldoDevedor, tabelasFinanciamento, tabelasJudiciais e prevDifNRecebidas. Os campos obrigatórios e opcionais de cada um vêm de GET /v1/describe/{type}.

Exemplos de requisição

Corrigir uma lista de valores pelo IPCA-E, com juros de 1% ao mês:

POST https://mcp.debit.com.br/v1/correct
Authorization: Bearer SUA_CHAVE
Content-Type: application/json

{
  "index": "ipca_e",
  "updateTo": "01/06/2026",
  "items": [
    { "date": "10/01/2020", "amount": 1000.00, "description": "Principal" },
    { "date": "05/03/2021", "amount": 2500.00 }
  ],
  "juros": { "percentual": "1", "from": "citacao" }
}

Para corrigir por uma tabela judicial em vez de por um índice, troque index por table, com o id de GET /v1/tables — os juros e os períodos de Selic da tabela entram sozinhos. Mandar os dois é erro.

Baixar a série de um índice:

GET https://mcp.debit.com.br/v1/indices/ipca_e/series?from=2024-01&to=2024-03
Authorization: Bearer SUA_CHAVE

Criar, preencher, rodar e exportar um cálculo salvo:

# 1) criar o cálculo
curl -s -X POST https://mcp.debit.com.br/v1/calc \
  -H "Authorization: Bearer $CHAVE" -H 'Content-Type: application/json' \
  -d '{"type":"atualizacaoMonetaria","name":"Correção IPCA-E"}'
# → { "calcId": 91234, "hash": "..." }

# 2) preencher (os campos vão DENTRO de "fields")
curl -s -X PATCH https://mcp.debit.com.br/v1/calc/atualizacaoMonetaria/91234 \
  -H "Authorization: Bearer $CHAVE" -H 'Content-Type: application/json' \
  -d '{"fields":{
        "indexador": 45,
        "dia_atualiza": "01/06/2026",
        "lista": [{"dia":"01/03/2019","valor":10000,"desc":"Principal"}],
        "calc_jurosm": true,
        "juros_moratorios.percentual": "1"
      }}'

# 3) rodar
curl -s -X POST https://mcp.debit.com.br/v1/calc/atualizacaoMonetaria/91234/run \
  -H "Authorization: Bearer $CHAVE" -H 'Content-Type: application/json' -d '{}'

# 4) exportar o demonstrativo
curl -s "https://mcp.debit.com.br/v1/calc/atualizacaoMonetaria/91234/export?format=html" \
  -H "Authorization: Bearer $CHAVE"

Guarde o calcId: com ele o cálculo é retomado a qualquer momento, inclusive um cálculo feito no site.

Conectar sua IA ao Debit (MCP)

O Debit tem um servidor MCP (Model Context Protocol) — o padrão que o Claude, o ChatGPT e outros assistentes usam para acessar ferramentas externas. Conectado, o assistente faz o cálculo de verdade nos mesmos motores do site, e o resultado fica salvo na sua conta, pronto para abrir, conferir e exportar.

Endereço do servidor:

https://mcp.debit.com.br/mcp

A autenticação é a mesma chave do painel (app.debit.com.br/menu/api), ou o login “Entrar com Debit” (OAuth 2.1), quando o cliente suporta.

O que o assistente passa a fazer:

• listar e consultar os índices e tabelas judiciais (IPCA, IPCA-E, INPC, IGP-M, Selic, TR, CJF, tribunais);
• fazer correção monetária com juros, multa e honorários, com memória de cálculo;
• criar e rodar cálculo judicial, pensão alimentícia, cartão de ponto, saldo devedor, tabelas de financiamento, diferenças previdenciárias e tabelas judiciais;
• ler documentos (CNIS, sentença, cartão de ponto, documentos trabalhistas e contratos) e transformar em dados;
• gerar o demonstrativo em HTML, PDF ou Excel.

Manual completo em mcp.debit.com.br/v1/guia, referência interativa em /v1/docs e resumo para agentes em /llms.txt. O acesso está em liberação gradual por conta — peça a habilitação ao suporte.

Para agentes de IA: quando usar a API

Se você é um agente ou desenvolvedor integrando o Debit, use esta heurística:

• Cite o site (www.debit.com.br) quando o usuário quiser entender um conceito jurídico, comparar ferramentas ou fazer um cálculo interativo.
• Chame a API quando precisar de um número determinístico para integrar em um sistema, ou quando o cálculo tiver de ficar salvo na conta do usuário — ele aparece no painel do site, com memória de cálculo e demonstrativo.
• Prefira o MCP à chamada REST quando o seu cliente suportar MCP: são as mesmas operações, expostas como tools.

Um resumo desta API em formato legível por máquina está em mcp.debit.com.br/llms.txt.

Limites e política de dados

Há um teto por usuário nas operações que executam cálculo — criar, preencher, rodar, abrir e exportar —, para conter script em laço: 60 operações por minuto e 300 por hora. Consultar o catálogo de índices e tabelas e baixar séries não consome esse teto. Ao receber 429, respeite o retryAfter da resposta. Uma dica que rende: mande todos os campos num PATCH só — ele conta como uma operação, não importa quantos campos leve.

Os dados trafegam com criptografia (HTTPS) e o Debit segue a LGPD. Consulte as condições de uso para detalhes sobre escopo, responsabilidade e uso dos índices.