Desenvolvedores / MCP
Servidor MCP
Conecte qualquer cliente compatível com MCP ao Jurisprudências.ai para buscar jurisprudências de tribunais brasileiros em tempo real.
O que é
Servidor Model Context Protocol (MCP) que permite a clientes de IA acessarem a base de decisões judiciais brasileiras. O cliente pode consultar tribunais, buscar decisões por texto e recuperar a ementa completa de um processo diretamente durante a conversa.
Protocolo: 2024-11-05.
Transporte: Streamable HTTP.
Endpoint
https://jurisprudencias.ai/mcp
Requisições POST com corpo JSON-RPC 2.0.
Respostas também em JSON-RPC 2.0.
Metadados públicos via GET /mcp.
Autenticação
OAuth 2.0 com registro dinâmico de cliente (DCR). O fluxo segue o padrão Authorization Code com PKCE. O servidor publica metadados em:
/.well-known/oauth-authorization-server/.well-known/oauth-protected-resource
O access token deve ser enviado no header Authorization: Bearer <token>
em todas as requisições ao endpoint /mcp.
Ferramentas
list_courts
Lista os tribunais disponíveis com nome, sigla e total de decisões.
Sem parâmetros.
search_decisions
Busca decisões judiciais por texto em um tribunal usando FTS5.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
court | sim | ID do tribunal: stf, stj, tst, trf3, tjpr, tjrj, tjrs, tjsc, tjsp |
query | não* | Consulta FTS5 bruta. Termos separados por espaço são AND implícito. Aspas para frase exata. Asterisco para prefixo. OR, NOT, NEAR suportados. |
query_intent | não* | Consulta estruturada (preferida). Objeto com chaves required, any_of, phrases e exclude (arrays de strings). Produz FTS5 válido automaticamente. Tem precedência sobre query quando ambos são fornecidos. |
| * Um dos dois é obrigatório. | ||
page | não | Página (começa em 0, padrão: 0) |
pub_from | não | Data de publicação mínima (YYYY-MM-DD) |
pub_to | não | Data de publicação máxima (YYYY-MM-DD) |
trial_from | não | Data de julgamento mínima (YYYY-MM-DD) |
trial_to | não | Data de julgamento máxima (YYYY-MM-DD) |
lookup_decision
Retorna a ementa completa de uma decisão pelo número do processo.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
court | sim | ID do tribunal: stf, stj, tst, trf3, tjpr, tjrj, tjrs, tjsc, tjsp |
process_number | sim | Número do processo |
Limites de uso
Limites renovados diariamente no horário de Brasília.
| Ferramenta | Gratuito | Assinante |
|---|---|---|
search_decisions | 10/dia | 500/dia |
lookup_decision | 50/dia | 10.000/dia |
Suporte
Dúvidas técnicas ou problemas de integração: [email protected].