Documentação RAGJur

Busca jurisprudencial e jurimetria sobre 120 milhões de julgados de 90+ tribunais brasileiros, via API REST ou MCP.

A RAGJur expõe a mesma base por dois caminhos: a API REST (https://api.ragjur.ai/api/v1/*), para integrar no seu produto, e o servidor MCP (https://mcp.ragjur.ai/mcp), para usar dentro de assistentes de IA como Claude, ChatGPT, Microsoft Copilot, Cursor e VS Code.

Autenticação

API key x-api-key ou OAuth 2.1 para conectores.

Referência da API

~30 endpoints de busca, jurimetria e IA (OpenAPI 3.1).

MCP

Claude, ChatGPT, Microsoft Copilot, Cursor e VS Code.

Jurimetria

Métricas, fórmulas, intervalos de confiança e limites.

Cobertura

Tribunais, bases e períodos indexados.

Vídeos

Demonstrações de cada funcionalidade.

Quick start (2 minutos)

Crie uma chave em app.ragjur.ai/painel/chaves (formato rj_…).
Faça a primeira busca:

bash

curl "https://api.ragjur.ai/api/v1/busca?q=dano+moral+negativa%C3%A7%C3%A3o+indevida&fonte=stj_integras" \
  -H "x-api-key: rj_..."

Ou pergunte a um assistente com o MCP conectado:

Claude Code

claude mcp add --transport http ragjur https://mcp.ragjur.ai/mcp
# no Claude Code: /mcp → login → "busque jurisprudência do STJ sobre dano moral por negativação indevida"

ChatGPT (connector personalizado)

Em Settings → Apps & connectors, clique em Add custom connector.
Nome: RAGJur · URL do servidor MCP: https://mcp.ragjur.ai/mcp.
Autenticação: Entrar agora (OAuth) e Usar a identidade publicada do Claude/ChatGPT — o servidor suporta CIMD e DCR.
No consent, cole a sua chave rj_… para confirmar a identidade: o ChatGPT recebe um token temporário de somente leitura, nunca a chave.

Conceitos

Termo	Significado
`fonte`	Código da base coletada (ex.: `stj_integras`, `tst_jurisprudencia`, `tjsp_cjsg`). Um tribunal pode ter mais de uma fonte (1º e 2º grau). Liste com `GET /api/v1/filtros`.
`tribunal`	Sigla (`STJ`, `TJSP`…). Alternativa a `fonte`, abrange todas as bases do tribunal.
`busca` / `q`	Tema ou palavras-chave. Mínimo 3 caracteres. Analisador jurídico pt-BR (stemming leve, sem acentos).
classificados	Decisões cujo dispositivo foi reconhecido (provido, improcedente…). Taxas usam classificados como denominador, nunca o total bruto.
`_meta.confianca`	Qualidade da amostra: alta (n ≥ 100), média (≥ 30), baixa (≥ 10), insuficiente.

Limites e SLAs

Rate limit por chave (janela deslizante); cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After.
Timeout do serviço: 120 s. Endpoints de IA (gerar-peca, clusters, estrategia-juiz) levam de 5 a 90 s.
Respostas JSON UTF-8; percentuais em 0–100; datas ISO 8601.

Especificação OpenAPI 3.1 pública: https://api.ragjur.ai/api/v1/openapi.json. Use-a para gerar SDKs, Custom GPT Actions ou plugins do Copilot.