---
title: "Envia uma mensagem JSON-RPC ao servidor MCP (Streamable HTTP)."
method: POST
path: "/api/mcp"
tags: ["MCP"]
---

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

`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

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.

## Headers

- `MCP-Protocol-Version` string

## Request body

- RequisicaoJsonRpc: Mensagem JSON-RPC 2.0 do protocolo MCP. Uma por requisição.
  - `jsonrpc` '2.0', required: Sempre "2.0".
  - `id` integer: Identificador da requisição, devolvido na resposta. Ausente em notificações. O JSON-RPC aceita também texto; o inteiro é a forma mais simples.
  - `method` string, 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`.
  - `params` object: Parâmetros do método. Em `tools/call`: `name` (a ferramenta) e `arguments` (os argumentos dela, conforme o `inputSchema` que `tools/list` devolve).

## Response `200`

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.

## Other responses

- `202`: Notificação ou resposta de cliente aceita. Sem corpo.
- `400`: Requisição inválida: lote JSON-RPC (recusado antes da autenticação), JSON malformado ou mensagem fora do formato JSON-RPC.
- `401`: Sem credencial, credencial inválida ou expirada, ou sem o escopo autos:read. O `WWW-Authenticate` aponta os metadados do recurso protegido (RFC 9728) e traz `scope` com o mínimo para usar o conector. O corpo não é JSON-RPC: o erro acontece antes de a requisição chegar ao servidor MCP.
- `402`: A assinatura do escritório não permite a operação (por exemplo, assinatura vencida). É cobrança, não permissão da pessoa.
- `406`: O cliente não aceita os dois formatos: `Accept` precisa listar application/json e text/event-stream.
- `415`: `Content-Type` precisa ser application/json.
- `429`: Limite de requisições atingido. A espera em segundos vem em `Retry-After`; o teto e a janela vêm em `RateLimit-Policy`. Aguarde antes de repetir: não é falha do servidor.
- `500`: Erro interno do servidor. Tente de novo mais tarde.

---

[API](https://skmtc.dev/juspronto/apis/juspronto-superficie-publica-para-agentes-conector-mcp-e-oau.md) · [All operations](https://skmtc.dev/juspronto/apis/juspronto-superficie-publica-para-agentes-conector-mcp-e-oau/llms.txt) · [OpenAPI document](https://skmtc.dev/juspronto/apis/juspronto-superficie-publica-para-agentes-conector-mcp-e-oau/revisions/b2c70e4e0734?raw)