MCP

Envia uma mensagem JSON-RPC ao servidor MCP (Streamable HTTP).

Transporte Streamable HTTP do servidor MCP do conector, sem sessão: cada requisição leva UMA mensagem JSON-RPC 2.0 (lote é recusado com 400) e nenhum Mcp-Session-Id é emitido. O cliente precisa mandar Content-Type: application/json e Accept: application/json, text/event-stream, senão recebe 415 ou 406. A resposta a uma requisição vem sempre como text/event-stream, com a resposta JSON-RPC no data do evento message; notificações recebem 202 sem corpo. Autenticação: OAuth 2.1 com PKCE (metadados em /.well-known/oauth-authorization-server), com o mínimo de escopos prazos:read, processos:read, dashboard:read, autos:read; ou, como caminho avançado, uma chave criada por sócio ou gestor no próprio Juspronto. Sem credencial o servidor responde 401 com WWW-Authenticate, que aponta os metadados do recurso. As ferramentas se descobrem pelo protocolo: chame initialize, depois tools/list e tools/call. A lista varia com as permissões que a pessoa autorizou; com as quatro marcadas são 32 ferramentas. O servidor também oferece leituras prontas (resources) e comandos (prompts). Com a assinatura do escritório vencida o servidor responde 402. O conector não protocola nada no tribunal.

post/api/mcp

Request

  • Base URL: https://api.juspronto.com.br
  • URL: https://api.juspronto.com.br/api/mcp
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://api.juspronto.com.br/api/mcp-oauth/authorize, token URL https://api.juspronto.com.br/api/mcp-oauth/token, scopes: prazos:read, processos:read, dashboard:read, autos:read)
    • HTTP bearer

Headers

MCP-Protocol-Versionstring
Example:2025-11-25

Revisão do protocolo negociada no initialize. O servidor atende 2025-11-25, 2025-06-18, 2025-03-26 em streamable-http.

Request body

jsonrpc'2.0' required

Sempre "2.0".

idinteger

Identificador da requisição, devolvido na resposta. Ausente em notificações. O JSON-RPC aceita também texto; o inteiro é a forma mais simples.

methodstring required

Método do protocolo MCP, por exemplo initialize, notifications/initialized, ping, tools/list, tools/call, resources/list, resources/read, prompts/list e prompts/get.

paramsobject

Parâmetros do método. Em tools/call: name (a ferramenta) e arguments (os argumentos dela, conforme o inputSchema que tools/list devolve).

Example request

{
  "method": "initialize"
}

Response

Resposta JSON-RPC 2.0 em fluxo SSE: o evento message traz em data um objeto no formato de #/components/schemas/RespostaJsonRpc. Erro de negócio de uma ferramenta vem como isError: true dentro do result, não como status HTTP.

Changes

No recorded changes to this operation across all 1 revision of this API.