Pular para o conteúdo
advoq

Documentação

Como conectar o advoq ao que você já usa, o que cada ferramenta devolve e onde estão os limites de cada uma.

Esta página é um esqueleto Os endereços das seções já são estes e não vão mudar, mas o conteúdo abaixo é provisório. Nada aqui deve ser usado como referência de integração ainda.

Primeiros passos

O advoq se conecta por MCP. Você declara o servidor no cliente que já usa e o agente passa a enxergar as ferramentas — não há SDK a instalar nem painel a configurar antes.

1 · declarar o servidor

{
  "mcpServers": {
    "advoq": {
      "command": "npx",
      "args": ["-y", "@advoq/mcp"],
      "env": {
        "ADVOQ_API_KEY": "sk_live_…"
      }
    }
  }
}

2 · conferir a conexão

# deve listar as ferramentas disponíveis para a sua chave
npx -y @advoq/mcp --check
A escrever Chaves de teste, ambiente sandbox e o passo a passo de cada cliente compatível.

Referência da API

A API é REST sobre HTTPS, com resposta em JSON e fluxo por text/event-stream onde faz sentido. Toda chamada exige o cabeçalho Authorization: Bearer.

Método Endpoint Devolve
POST /v1/citacoes/conferir Lista de citações com âncora, trecho e situação
POST /v1/rascunhos Rascunho de peça a partir do contexto anexado
GET /v1/fontes/{id} O dispositivo, com histórico de versões
GET /v1/uso Consumo do período e data de reinício do contador

Resposta de conferência

{
  "total": 14,
  "confirmadas": 13,
  "citacoes": [
    {
      "trecho": "Os honorários serão fixados entre dez e vinte por cento…",
      "situacao": "confirmada",
      "fonte": "CPC · art. 85, § 2º",
      "ancora": "lei/13105-2015#art85-p2"
    },
    {
      "trecho": "O prazo costuma ser prorrogado nesta vara…",
      "situacao": "exige_revisao",
      "fonte": null
    }
  ]
}
A escrever Limites de uso por plano, política de repetição, códigos de erro e versionamento da API.

Catálogo de MCPs

Cada servidor expõe um conjunto pequeno de ferramentas e pede a menor permissão que dá conta do trabalho. Nenhum deles escreve em sistema de tribunal — leitura apenas.

advoq/pje

Consulta processual e leitura dos autos anexados

estável

advoq/base

Busca em legislação e jurisprudência, com âncora no trecho

estável

advoq/redacao

Rascunho de peça a partir do contexto anexado

estável

advoq/prazos

Contagem em dias úteis, com feriados forenses por tribunal

beta

advoq/esaj

Consulta e download no e-SAJ, por certificado do escritório

beta

Âncoras e fontes

Uma âncora é o endereço do trecho, não o link do documento. É o que permite dizer onde a afirmação foi conferida em vez de apenas apontar para um PDF de trezentas páginas.

Os honorários serão fixados entre dez e vinte por cento sobre o valor da condenação.

CPC · art. 85, § 2º fonte confirmada

O prazo de cumprimento voluntário costuma ser prorrogado nesta vara.

sem fonte confirmada exige revisão

Só há dois estados, e a diferença não é só de cor: muda o filete, muda o ícone e muda a palavra. Quando a base não confirma o trecho, a saída não é omitida — ela é entregue marcada, para que a decisão de usar continue sendo de quem assina.

Segurança e dados

O agente lê apenas os processos que você anexou. Não treinamos modelo com o conteúdo dos seus autos.

Região de processamento Brasil
Retenção do texto enviado à API Nenhuma
Retenção dos autos anexados Enquanto o processo estiver ativo na sua conta
Treino com dados de cliente Não
Sub-processadores Lista pública, com aviso prévio de mudança
A escrever Relatório de segurança, chave PGP para divulgação responsável e o modelo de contrato de tratamento de dados.

Não achou o que precisava? Fale com a gente