mcp-seipro
MCP server for SEI with 116 tools covering processes, documents, signatures, blocks, markers, tracking, credentials, models and more via mod-wssei v2 REST and optional web scraper.
List/search units, users, organs, contexts and check SEI/mod-wssei versions.
Query, search, summarize and inspect processes: details, documents tree, activities, assignments, interested parties, overhauls and relationships.
Manage process workflow: create, alter, send/tramitar, receive, conclude, reopen, assign/unassign, mark unread, overstar/remove overstallment.
Read documents as Markdown/text/HTML, including PDF text extraction and OCR; download attachments; search documents by SEI number.
Create/edit internal and external documents and sections using SEI CSS styles; generate references; list signatures and document blocks.
Sign documents and signature blocks; attempt signature cancellation.
Manage annotations, unit observations, ciência, andamento records and contacts.
Manage markers, special tracking/groups, internal blocks, signature blocks and restricted-process credentials.
Search document types, process types, subjects, legal hypotheses, conference types, models, upload parameters and signing roles.
Enforces a consent gate before returning restricted/sigiloso document content.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-seipro Liste os processos da unidade GPF"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-seipro
MCP Server do SEI Pro para o SEI (Sistema Eletrônico de Informações) via API REST mod-wssei v2 + scraper do frontend web (modo híbrido).
116 tools para gerenciar processos, documentos, tramitação, assinatura, blocos, marcadores, acompanhamento, credenciamento, modelos e mais em qualquer instância do SEI. Cobertura completa da API mod-wssei v2 oficial (pengovbr/mod-wssei) mais um scraper HTTP do frontend web que dá ganhos de até 23× em operações de listagem (sei_listar_processos cai de ~14 s para ~600 ms warm).
Instalação
Opção 1: Claude Desktop (extensão com um clique)
Baixe o arquivo seipro.mcpb e abra com duplo-clique. O Claude Desktop instala automaticamente e pede suas credenciais.
Opção 2: PyPI (pip)
pip install mcp-seiproOpção 3: Instalador interativo
git clone https://github.com/sei-pro/mcp-seipro.git
cd mcp-seipro
python3 setup_claude.pyO script pergunta suas credenciais, instala o pacote e configura o Claude Desktop automaticamente.
Related MCP server: datajud-mcp-server
Configuração
Variáveis de ambiente
Variável | Obrigatória | Descrição |
| Sim | URL base da API mod-wssei v2 |
| Sim | Usuário para autenticação |
| Sim | Senha para autenticação |
| Sim | Código do órgão |
| Não | Contexto opcional |
| Não |
|
| Não | Idioma do OCR (padrão: |
| Não |
|
Dica: como obter
SEI_URLeSEI_ORGAOdireto pelo SEINa barra lateral do SEI (menu à esquerda), role até o final — você verá um QR Code para o aplicativo móvel. Esse QR Code contém um link com todas as informações necessárias:
https://sei.orgao.gov.br/sei/modulos/wssei/controlador_ws.php/api/v2;siglaorgao: ORGAO;orgao: 0;contexto:
SEI_URL— a URL antes do;(ex:https://sei.orgao.gov.br/sei/modulos/wssei/controlador_ws.php/api/v2)
SEI_ORGAO— o valor apósorgao:(ex:0)Você pode escanear o QR Code com a câmera do celular para copiar o link, ou simplesmente anotar os dados a partir do menu.
Registro no Claude Code
Adicione ao .mcp.json do projeto ou ~/.claude.json (global):
{
"mcpServers": {
"seipro": {
"command": "mcp-seipro",
"env": {
"SEI_URL": "https://sei.orgao.gov.br/sei/modulos/wssei/controlador_ws.php/api/v2",
"SEI_USUARIO": "seu.usuario",
"SEI_SENHA": "sua-senha",
"SEI_ORGAO": "0"
}
}
}
}Registro no Claude Desktop (manual)
Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"seipro": {
"command": "mcp-seipro",
"env": {
"SEI_URL": "https://sei.orgao.gov.br/sei/modulos/wssei/controlador_ws.php/api/v2",
"SEI_USUARIO": "seu.usuario",
"SEI_SENHA": "sua-senha",
"SEI_ORGAO": "0"
}
}
}
}Exemplos de uso
Com o MCP SEI Pro configurado, basta conversar com o Claude em linguagem natural:
Consultas
"O que diz o processo 50300.018905/2018-67?"
"Leia o documento SEI 2843449 e me faça um resumo"
"Qual foi o último andamento do processo de Auditoria TCU que está na unidade GPF?"
"Liste para mim os processos da caixa GPF no SEI"
"Quais processos estão atribuídos a mim na unidade SFC?"
Ações
"Crie um despacho no processo 50300.001234/2024-01 aprovando o pedido"
"Tramite o processo 50300.005678/2024-02 para a unidade SFC com prazo de 5 dias"
"Assine todos os documentos do bloco de assinatura 'Contratos Março'"
"Marque o processo como acompanhamento especial com o grupo 'Urgentes'"
"Crie um marcador vermelho chamado 'Pendente Resposta' e aplique no processo"
Análise
"Me dê um resumo dos processos da minha caixa agrupados por tipo"
"Quais processos da unidade GPF estão sem movimentação há mais de 30 dias?"
"Compare o conteúdo dos documentos 2843449 e 2843450"
Tools disponíveis (116)
Sistema e metadados (3)
Tool | Descrição |
| Retorna versão do SEI e do mod-wssei instalado |
| Lista órgãos da instalação do SEI |
| Lista contextos disponíveis para um órgão |
Navegação e contexto (7)
Tool | Descrição |
| Lista unidades acessíveis pelo usuário |
| Troca a unidade ativa |
| Pesquisa unidades por nome/sigla |
| Pesquisa unidades excluindo a atual |
| Pesquisa textos padrão internos da unidade |
| Lista usuários (filtra por unidade ativa e nome) |
| Busca usuários por palavra-chave no órgão |
Processos — consulta (11)
Tool | Descrição |
| Lista caixa da unidade via scraper web (~23× mais rápido que REST). Suporta |
| Pesquisa por texto, descrição, datas, unidade geradora, assunto ou grupo de acompanhamento |
| Híbrido: REST (especificacao, assuntos, interessados, observacoes) + Web (lista de documentos da árvore) em paralelo |
| Resumo agrupado por 17 campos (usa REST direto para flags estruturadas) |
| Lista unidades onde o processo está aberto |
| Consulta quem é responsável pelo processo |
| Verifica se o usuário tem acesso ao processo |
| Lista processos relacionados (mod-wssei 3.0.2+) |
| Histórico de atividades/andamentos via scraper web (~2× mais rápido) |
| Lista interessados do processo |
| Lista histórico de sobrestamentos |
Processos — gestão (13)
Tool | Descrição |
| Cria novo processo (público ou restrito) |
| Altera metadados (nível de acesso, especificação) |
| Tramita para outra(s) unidade(s) — aceita sigla |
| Conclui na unidade atual |
| Reabre processo concluído |
| Confirma recebimento na unidade |
| Atribui a um usuário (aceita nome) |
| Remove atribuição de processo |
| Marca processo como não lido na unidade |
| Sobresta processo (motivo obrigatório) |
| Remove sobrestamento |
| Pesquisa tipos de processo |
| Pesquisa hipóteses legais (restrito/sigiloso) |
Processos — assuntos (2)
Tool | Descrição |
| Pesquisa assuntos disponíveis |
| Sugestões de assunto para um tipo de processo |
Processos sigilosos — credenciamento (4)
Tool | Descrição |
| Lista credenciamentos de acesso ao processo |
| Concede acesso a um usuário |
| Renuncia ao próprio acesso |
| Revoga acesso de um usuário |
Documentos — leitura (8)
Tool | Descrição |
| Árvore completa via scraper web (~10× mais rápido que REST). Aceita protocolo formatado |
| Busca documento pelo número SEI (via Solr) |
| Lista documentos com |
| Lê documento (HTML ou PDF/OCR) em Markdown |
| Baixa documento externo em base64 (max 10MB) |
| Consulta metadados de documento externo |
| Lista assinaturas de um documento |
| Lista blocos de assinatura do documento |
Documentos — escrita (10)
Tool | Descrição |
| Cria documento interno vazio |
| Cria documento externo — upload por |
| Altera metadados de documento interno |
| Altera metadados/arquivo de documento externo |
| Lista seções editáveis de um documento |
| Altera conteúdo HTML (preenche somenteLeitura auto). |
| Assinatura eletrônica |
| Tenta cancelar assinatura via edição |
| Gera hiperlink dinâmico para documento citado |
| Consulta dicionário de 39 estilos CSS do SEI |
Documentos — tipos e modelos (7)
Tool | Descrição |
| Pesquisa tipos de documento (séries) |
| Tipos aplicáveis a documentos externos |
| Tipos de conferência (cópia, original, autenticada) |
| Sugestões de assunto para um tipo de documento |
| Lista grupos de modelos de documento |
| Lista modelos de documento disponíveis |
| Extensões/tamanhos permitidos para upload |
Assinantes (2)
Tool | Descrição |
| Lista cargos/funções para assinatura |
| Lista órgãos disponíveis para assinatura |
Ciência e andamento (3)
Tool | Descrição |
| Dá ciência em documento ou processo |
| Lista ciências registradas |
| Registra andamento/atividade no processo |
Anotação e observação (2)
Tool | Descrição |
| Cria anotação (post-it) individual no processo |
| Cria observação da unidade no processo |
Contatos (2)
Tool | Descrição |
| Pesquisa contatos cadastrados |
| Cria novo contato |
Marcador (8)
Tool | Descrição |
| Cria marcador (lista cores se omitida) |
| Exclui marcador(es) |
| Desativa marcador(es) sem excluir |
| Reativa marcador(es) desativados |
| Adiciona marcador a um processo |
| Lista marcadores disponíveis |
| Consulta marcadores ativos de um processo |
| Histórico de marcadores do processo |
Acompanhamento especial (8)
Tool | Descrição |
| Adiciona acompanhamento especial |
| Altera acompanhamento existente |
| Remove acompanhamento |
| Lista processos acompanhados pelo usuário |
| Lista acompanhamentos da unidade |
| Lista grupos de acompanhamento |
| Cria grupo de acompanhamento |
| Exclui grupo de acompanhamento |
Bloco interno (10)
Tool | Descrição |
| Cria bloco interno |
| Altera descrição do bloco |
| Exclui bloco(s) |
| Conclui bloco(s) |
| Reabre bloco concluído |
| Inclui processo(s) no bloco |
| Remove processo(s) do bloco |
| Lista processos do bloco |
| Cria anotação em processo do bloco |
| Altera anotação do bloco |
Bloco de assinatura (16)
Tool | Descrição |
| Cria bloco (aceita sigla de unidades) |
| Altera descrição do bloco |
| Exclui bloco(s) |
| Conclui bloco(s) |
| Reabre bloco concluído |
| Retorna bloco para unidade de origem |
| Inclui documento(s) no bloco |
| Remove documento(s) do bloco |
| Lista documentos do bloco |
| Disponibiliza bloco para assinatura |
| Cancela disponibilização |
| Pesquisa blocos existentes |
| Assina todos os documentos de um bloco |
| Assina documentos específicos de um bloco |
| Cria anotação em documento do bloco |
| Altera anotação do bloco |
Compatibilidade com versões do SEI
Todos os 116 endpoints funcionam desde o mod-wssei 2.0.0 (SEI 4.0.x), exceto um:
Tool | Versão mínima |
| mod-wssei 3.0.2+ (SEI 5.0.x) |
Tabela de compatibilidade SEI ↔ mod-wssei:
Versão SEI | mod-wssei | Observações |
4.0.x | 2.0.x | Base completa (131 rotas) |
4.1.1 | 2.2.0 | Correções de bugs |
5.0.x | 3.0.1 | Compatibilidade PHP 8.2 |
5.0.x | 3.0.2 | + |
Se algum endpoint falhar com erro inesperado, use sei_versao para verificar a versão do mod-wssei instalada na sua instância do SEI.
Nota: a API mod-wssei v2 não expõe endpoint para cancelar assinatura de documentos em nenhuma versão (verificado até v3.0.2). A função existe no core do SEI (
DocumentoRN::cancelarAssinaturaInternoControlado) mas não está exposta via REST. Osei_cancelar_assinaturausa o workaround de forçar uma edição mínima no documento.
Arquitetura híbrida REST + Web scraper
A maioria das tools usa a REST mod-wssei v2 (estável, oficial, disponível desde SEI 4.0.x). Mas duas operações críticas para latência ganham com um caminho alternativo via scraping HTTP do frontend web do SEI:
Desde jun/2026 o caminho web é opt-in (
SEI_WEB_SCRAPER=1): o login do frontend da ANTAQ virou SSO Microsoft e o scraper não autentica mais. As tools abaixo rodam por REST por padrão; os ganhos medidos valem quando o scraper está ativo e o órgão usa login local.
Tool | Estratégia | Ganho medido |
| Scraper web puro ( | ~14.7 s → ~625 ms (23×) |
| Híbrido: REST | combina dados complementares |
| Scraper web ( | ~12 s → ~1.1 s (10×) |
| Scraper web ( | ~9.7 s → ~1.1 s (10×) |
| Scraper web ( | ~2.5 s → ~1.2 s (2×) |
| Cache in-memory TTL 1h | ~4.2 s → instant |
| Cache in-memory TTL 1h | ~3.0 s → instant |
| Cache in-memory TTL 1h | ~2.6 s → instant |
O scraper:
Mantém uma sessão SIP autenticada persistente (login custa ~3 s, uma vez por conexão MCP).
Reaproveita o
infra_hashcapturado da cadeia de redirects pós-login (válido enquanto a sessão SIP viver).Cacheia o action e os hidden fields do form principal de
procedimento_controlarpara POSTs subsequentes.Re-loga automaticamente se detectar que a sessão expirou.
Funciona com qualquer instância SEI 4.0+/5.0+ que use o módulo
Infrav1.5x+ (a maioria das instalações modernas).
A REST mod-wssei continua sendo o caminho padrão para todas as outras operações e o fallback se o scraper falhar (ex: CAPTCHA após muitas tentativas, 2FA habilitado, mudança de layout no SEI). O método REST de listar_processos permanece disponível em SEIClient.listar_processos — não exposto como tool MCP, mas usado internamente pelo sei_resumo_processos (que precisa dos flags estruturados de status).
Funcionalidades
Resolução automática
Parâmetro | Aceita | Exemplo |
Documento | Número SEI ou id interno |
|
Processo | Protocolo ou IdProcedimento |
|
Unidade | Sigla ou ID |
|
Usuário | Nome ou ID |
|
Leitura universal de documentos
Internos (HTML) → Markdown (tabelas limpas, sem colunas vazias)
PDFs com texto → Markdown via pdfplumber
PDFs escaneados → Markdown via OCR (tesseract, limite 20 páginas)
Estilos CSS do SEI
Despachos: Paragrafo_Numerado_Nivel1 (corpo), âncora SEI no destinatário
Notas Técnicas: Item_Nivel1/2/3/4 (H1/H2/H3/H4), Item_Alinea_Letra (a, b, c), Item_Inciso_Romano (I, II, III)
Regra: toda numeração usa classes CSS, nunca texto manual.
Privacidade e dados restritos
Como o MCP trata credenciais, conteúdo e registros técnicos está na Política de Privacidade.
O SEI classifica processos e documentos em três níveis: público (nivelAcesso=0), restrito (1) e sigiloso (2). O MCP usa as credenciais do usuário, então acessa o que o usuário enxergaria no SEI — incluindo restritos. Sigilosos exigem credenciamento prévio no próprio SEI.
Como conteúdo restrito pode trafegar para um provedor LLM (que talvez logue, retenha ou treine modelos com ele), o MCP impõe um gate de consentimento nas duas tools que entregam conteúdo bruto:
sei_ler_documento— markdown/texto/HTML do documentosei_baixar_anexo— base64 do arquivo
Comportamento padrão (mais seguro): se o documento tem nivelAcesso 1 ou 2 e a chamada não trouxe confirmar_acesso_restrito=true, o MCP responde com um JSON estruturado em pt-BR (consentimento_necessario=true, lista de riscos[] cobrindo LGPD/LAI/treinamento de modelos/sigilo funcional, e como_liberar). O conteúdo bruto não é entregue.
Existem duas formas de liberar:
Forma | Escopo | Quando usar |
| Per-call | Decisão pontual do usuário ao usar o LLM |
| Servidor inteiro | Operador do MCP libera previamente |
Em ambos os casos, o conteúdo entregue vem com um disclaimer prefixado lembrando o nível de acesso, a hipótese legal e os riscos.
As demais tools (sei_consultar_processo, sei_consultar_documento_externo, etc.) não bloqueiam metadados — apenas anexam um campo _aviso_acesso quando detectam restrição, para o LLM repassar a informação ao usuário.
O gate trata restrito e sigiloso de forma idêntica. Sigiloso já tem proteção adicional do SEI (credenciamento). Se quiser regras diferentes, abra um issue.
Por que não há um modal nativo de autorização?
O MCP define o protocolo elicitInput justamente para isso — o servidor pede input estruturado e o cliente renderiza UI nativa. O servidor SEI Pro implementa esse caminho desde v0.3.7: quando o cliente declara a capability, o gate aparece como modal/formulário no cliente, fora do alcance do modelo.
Hoje, no entanto, os clientes Anthropic conectados via Streamable HTTP (mcp.seipro.io no claude.ai/Claude Desktop com servidor remoto) não declaram a capability nem respondem aos requests de elicit. O servidor detecta isso e cai no JSON gate textual, que continua sendo a barreira efetiva. Quando esse suporte for ativado nos clientes Anthropic, o caminho de elicit começa a funcionar automaticamente — nada precisa mudar no servidor.
O fluxo "sem elicit" (atual): modelo recebe JSON estruturado de bloqueio → traduz os riscos ao usuário em texto → usuário digita autorização explícita → modelo passa confirmar_acesso_restrito=true na próxima chamada. Funciona bem com modelos grandes (Opus 4.7) e, com as docstrings + instrucao_para_modelo + nao_e_erro_tecnico introduzidos nas versões 0.3.5–0.3.7, também com modelos menores (Haiku 4.5).
Deploy remoto (Railway)
O servidor pode rodar em modo HTTP para uso via Claude no celular, na web ou em qualquer cliente MCP remoto. Cada órgão faz seu próprio deploy — as credenciais do SEI são informadas pelo usuário na tela de login OAuth e nunca ficam armazenadas no servidor.
A instância pública
https://mcp.seipro.io/mcpé mantida pelo SEI Pro numa VPS própria, no Brasil (verdeploy/README.md). O guia abaixo é para quem quer hospedar uma instância própria no Railway.
O que é o Railway
O Railway é uma plataforma de deploy na nuvem que facilita colocar aplicações no ar. Você faz push do código e o Railway cuida de build, domínio, SSL e escalabilidade.
1. Criar conta no Railway
Acesse railway.com e clique em Sign Up
Faça login com GitHub, GitLab ou e-mail
Confirme seu e-mail
2. Instalar o Railway CLI
macOS (Homebrew):
brew install railwaynpm (qualquer plataforma):
npm install -g @railway/cliVerificar instalação:
railway --version3. Autenticar no terminal
railway loginIsso abre o navegador para você autorizar o CLI na sua conta Railway.
4. Clonar o repositório
git clone https://github.com/sei-pro/mcp-seipro.git
cd mcp-seipro5. Criar o projeto no Railway
railway init -n mcp-seiproSe você tiver mais de um workspace, adicione --workspace "Nome do Workspace".
6. Criar o serviço
railway add --service mcp-seipro7. Configurar variáveis de ambiente
O servidor precisa de duas variáveis obrigatórias:
railway variables set \
JWT_SECRET="$(openssl rand -base64 48)" \
BASE_URL="https://SEU-PROJETO.up.railway.app"JWT_SECRET— chave mestra dos tokens OAuth (gerada pelo comando acima). Obrigatória, com no mínimo 32 bytes: sem ela o servidor se recusa a subir. Trocá-la derruba todas as sessões.BASE_URL— URL pública do seu servidor (será definida no passo 9)
Nota: as credenciais do SEI (URL, usuário, senha) não ficam gravadas no servidor. São informadas pelo usuário na tela de login OAuth e criptografadas (AES-256-GCM) dentro do token.
Variáveis de segurança recomendadas:
Variável | Padrão | Para quê |
| vazio (qualquer host público) | Hosts do SEI aceitos no login, separados por vírgula: exato ( |
|
| Hosts https aceitos como |
| host de | Hosts que podem receber |
| 1 h / 14 d / 30 d | Validade do access token, do refresh token (rotativo) e teto absoluto da sessão, em segundos |
No modo remoto, arquivo_path (upload a partir do disco do servidor) é desabilitado: use arquivo_base64.
8. Gerar domínio público
railway domainIsso gera uma URL como https://mcp-seipro-production.up.railway.app. Copie essa URL.
Agora atualize a variável BASE_URL com a URL gerada:
railway variables set BASE_URL="https://mcp-seipro-production.up.railway.app"9. Fazer o deploy
railway upAguarde o build finalizar (2-3 minutos na primeira vez). Ao terminar, verifique:
# Deve retornar HTTP 401 (protegido por OAuth)
curl -s -o /dev/null -w "%{http_code}" -X POST https://SEU-PROJETO.up.railway.app/mcpSe retornar 401, o servidor está rodando com autenticação ativa.
10. Conectar no Claude
Acesse claude.ai → Settings → Connectors
Clique em Adicionar conector personalizado
Cole a URL do seu servidor:
https://SEU-PROJETO.up.railway.app/mcpO Claude vai abrir a tela de login do SEI Pro
Preencha a URL da API do SEI, usuário e senha do seu órgão
Clique em Conectar
Pronto! A configuração sincroniza automaticamente com o app mobile e a web.
Como funciona
O servidor detecta automaticamente o ambiente:
Ambiente | Variável | Transporte | Uso |
Local | ausente | stdio | Claude Code / Claude Desktop |
Railway | presente (injetada) | Streamable HTTP + OAuth | Claude mobile / web / remoto |
No modo remoto, as credenciais do SEI são criptografadas (AES-256-GCM) dentro do token e não ficam gravadas no servidor. O Dockerfile inclui tesseract-ocr para OCR de PDFs escaneados.
Domínio customizado (opcional)
railway domain --custom mcp.seu-orgao.gov.brConfigure um registro CNAME no DNS do seu órgão apontando para o valor fornecido pelo Railway. O certificado SSL é provisionado automaticamente.
Lembre-se de atualizar a variável BASE_URL:
railway variables set BASE_URL="https://mcp.seu-orgao.gov.br"
railway upAtualizar o servidor
Para atualizar com novas versões do mcp-seipro:
git pull
railway upRequisitos de sistema
Python >= 3.11
Qualquer instância do SEI com módulo mod-wssei v2
Claude Code, Claude Desktop, ou qualquer cliente MCP
Para OCR de PDFs escaneados (opcional):
tesseract-ocretesseract-ocr-porpoppler-utils
Links
Licença
MIT
Available Tools
116 toolssei_acompanhar_processoB
Adiciona acompanhamento especial em um processo.
Parâmetros:
processo: protocolo formatado ou IdProcedimento
grupo: ID do grupo de acompanhamento (use sei_listar_grupos_acompanhamento)
observacao: observação/anotação do acompanhamento
Inputs: processo (required), grupo, observacao. Returns: result
sei_alterar_acompanhamentoAIdempotent
Altera acompanhamento especial de um processo.
processo: protocolo formatado ou IdProcedimento
grupo: novo grupo de acompanhamento
observacao: nova observação
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: processo (required), grupo, observacao. Returns: result
sei_alterar_anotacao_bloco_assinaturaCIdempotent
Altera anotação de documento em um bloco de assinatura.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required), descricao (required), documento (required). Returns: result
sei_alterar_anotacao_bloco_internoCIdempotent
Altera anotação de processo em um bloco interno.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required), processo (required), descricao (required). Returns: result
sei_alterar_bloco_assinaturaCIdempotent
Altera descrição de um bloco de assinatura.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required), descricao (required). Returns: result
sei_alterar_bloco_internoBIdempotent
Altera descrição de um bloco interno.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required), descricao (required). Returns: result
sei_alterar_documento_externoAIdempotent
Altera metadados de um documento externo (e opcionalmente substitui o arquivo).
id_documento: ID interno do documento
descricao: nova descrição
nivel_acesso: 0=público, 1=restrito, 2=sigiloso
hipotese_legal: ID da hipótese (obrigatório se restrito/sigiloso)
arquivo_path: caminho local de novo arquivo para substituir (opcional)
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_documento (required), descricao, arquivo_path, nivel_acesso, +1 more. Returns: result
sei_alterar_documento_internoAIdempotent
Altera metadados de um documento interno (não o conteúdo HTML).
Para alterar o conteúdo, use sei_editar_secao.
id_documento: ID interno do documento
descricao: nova descrição
nivel_acesso: 0=público, 1=restrito, 2=sigiloso
hipotese_legal: ID da hipótese (obrigatório se restrito/sigiloso)
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_documento (required), descricao, nivel_acesso, hipotese_legal. Returns: result
sei_alterar_processoAIdempotent
Altera metadados de um processo no SEI.
Parâmetros:
processo: protocolo formatado (ex: 50300.009752/2026-77) ou IdProcedimento
especificacao: nova descrição/especificação do processo
nivel_acesso: 0=público, 1=restrito, 2=sigiloso
hipotese_legal: ID da hipótese legal (obrigatório se restrito/sigiloso). Use sei_pesquisar_hipoteses_legais para descobrir o ID.
observacao: observações adicionais
Informe apenas os campos que deseja alterar.
Inputs: processo (required), observacao, nivel_acesso, especificacao, +1 more. Returns: result
sei_anotar_documento_bloco_assinaturaA
Cria anotação em documento dentro de um bloco de assinatura.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required), descricao (required), documento (required). Returns: result
sei_anotar_processo_bloco_internoC
Cria anotação em processo dentro de um bloco interno.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required), processo (required), descricao (required). Returns: result
sei_arvore_processoARead-only
Mostra a árvore (lista) de documentos de um processo SEI.
Aceita o protocolo formatado (ex: 50300.000123/2025-00) ou IdProcedimento.
Para ler o conteúdo de um documento, use sei_ler_documento com o id.
Por padrão usa a REST (/documento/listar/{id}). O scraper web (mais
rápido, mas inativo desde o SSO Microsoft da ANTAQ) só é usado se
SEI_WEB_SCRAPER=1.
Inputs: protocolo_formatado (required). Returns: result
sei_assinar_blocoA
Assina TODOS os documentos de um bloco de assinatura.
A autenticação é automática — basta informar o bloco e o cargo.
IMPORTANTE: o parâmetro cargo é OBRIGATÓRIO. Sem ele a assinatura falha.
Se não souber o cargo, chame sem cargo para ver a lista de opções.
Pergunte ao usuário e grave o cargo para reutilizar na mesma conversa.
id_bloco: ID do bloco
cargo: cargo/função — OBRIGATÓRIO (se omitido, lista opções disponíveis)
Inputs: id_bloco (required), cargo. Returns: result
sei_assinar_documentoA
Assina eletronicamente um documento no SEI.
A autenticação é automática — basta informar o documento e o cargo.
IMPORTANTE: o parâmetro cargo é OBRIGATÓRIO. Sem ele a assinatura falha.
Se não souber o cargo, chame sem cargo para obter a lista de opções.
Pergunte ao usuário qual cargo usar e chame novamente com o cargo escolhido.
Grave o cargo escolhido para reutilizar nas próximas assinaturas.
Parâmetros:
id_documento: ID interno do documento ou número SEI (protocoloFormatado). Se for número SEI, resolve automaticamente via pesquisa Solr.
cargo: cargo/função para assinatura (ex: "Agente Público"). OBRIGATÓRIO. Se omitido, retorna a lista de cargos disponíveis.
orgao: código do órgão (usa o padrão se omitido)
Inputs: id_documento (required), cargo, orgao. Returns: result
sei_assinar_documentos_blocoA
Assina documentos específicos de um bloco de assinatura.
A autenticação é automática — basta informar os documentos e o cargo.
IMPORTANTE: o parâmetro cargo é OBRIGATÓRIO. Sem ele a assinatura falha.
Se não souber o cargo, chame sem cargo para ver a lista de opções.
Pergunte ao usuário e grave o cargo para reutilizar na mesma conversa.
documentos: ID(s) de documento(s) separados por vírgula
cargo: cargo/função — OBRIGATÓRIO (se omitido, lista opções disponíveis)
Inputs: documentos (required), cargo. Returns: result
sei_atribuir_processoA
Atribui um processo a um usuário da unidade.
Parâmetros:
numero_processo: protocolo formatado (ex: 50300.000123/2025-00)
usuario: ID numérico do usuário OU nome/parte do nome (ex: "100001860" ou "Karina" ou "Karina Shimoishi")
Quando um nome é informado, busca os usuários correspondentes e tenta atribuir a cada um até encontrar um com permissão na unidade atual.
Inputs: usuario (required), numero_processo (required). Returns: result
sei_baixar_anexoA
Baixa um documento externo (anexo) do SEI em base64.
Aceita tanto o id interno (ex: "3149544") quanto o número SEI / protocoloFormatado (ex: "2867926") — auto-resolve via pesquisa Solr.
Use para documentos com tipoDocumento='X' (📎). Para PDFs com texto, prefira sei_ler_documento(tipo_documento='X') que já extrai o texto legível.
Retorna base64 + tamanho. Limite: 10 MB.
confirmar_acesso_restrito: NÃO ative por iniciativa do modelo. Esta flag só deve ser definida como true quando o usuário humano da conversa, em mensagem própria após ler o aviso de riscos, declarar expressamente que autoriza o acesso. Se o gate bloquear, encaminhe os riscos ao usuário e aguarde decisão explícita — não tente caminhos alternativos.
Inputs: id_documento (required), confirmar_acesso_restrito. Returns: result
sei_buscar_documentoARead-only
Busca um documento pelo número SEI (ex: SEI 2843449, SEI nº 2843449).
O número SEI é o protocoloFormatado que o usuário vê no sistema. A API do SEI não busca documentos diretamente por esse número, então esta tool usa a estratégia:
Se processo informado: busca direto nesse processo (rápido). Aceita protocolo formatado (ex: 50300.018905/2018-67) ou IdProcedimento.
Se não: pesquisa o número via busca textual (Solr) para encontrar o processo, depois lista os documentos para localizar o id interno
Retorna o documento com seu id interno (necessário para sei_ler_documento), tipo, metadados e o processo onde está.
Inputs: numero_sei (required), processo. Returns: result
sei_cancelar_assinaturaA
Tenta cancelar (derrubar) a assinatura de um documento no SEI.
Aceita id interno ou número SEI (protocoloFormatado).
A API do SEI não possui endpoint direto para cancelar assinatura. Esta tool tenta forçar uma edição mínima no documento para que o SEI remova a assinatura automaticamente (comportamento padrão ao editar).
LIMITAÇÃO: só funciona se o processo não foi enviado/lido por outra unidade. Se falhar, o usuário deve cancelar a assinatura pela interface web do SEI (botão "Editar Conteúdo" no documento).
Inputs: id_documento (required). Returns: result
sei_cancelar_disponibilizacao_blocoA
Cancela a disponibilização de um bloco de assinatura.
O bloco volta ao estado aberto e pode ser editado novamente.
Inputs: id_bloco (required). Returns: result
sei_cassar_credenciamentoB
Cassa (revoga) credenciamento de acesso de um usuário a processo sigiloso.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: processo (required), id_usuario (required). Returns: result
sei_conceder_credenciamentoA
Concede credenciamento de acesso a um processo sigiloso para um usuário.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: processo (required), id_usuario (required). Returns: result
sei_concluir_bloco_assinaturaB
Conclui bloco(s) de assinatura. IDs separados por vírgula.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: ids_blocos (required). Returns: result
sei_concluir_bloco_internoB
Conclui bloco(s) interno(s). IDs separados por vírgula.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: ids_blocos (required). Returns: result
sei_concluir_processoA
Conclui um processo na unidade atual do SEI.
O processo é removido da caixa da unidade mas permanece acessível. Use sei_reabrir_processo para reverter.
Inputs: numero_processo (required). Returns: result
sei_consultar_atribuicaoBRead-only
Consulta a atribuição atual de um processo (quem está responsável).
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: processo (required). Returns: result
sei_consultar_documento_externoARead-only
Consulta metadados de um documento externo pelo ID.
Aceita tanto o id interno (ex: "3149544") quanto o número SEI / protocoloFormatado (ex: "2867926") — auto-resolve via pesquisa Solr quando necessário.
Retorna informações como tipo, data, nível de acesso, etc. Para baixar o conteúdo use sei_baixar_anexo ou sei_ler_documento. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x).
Quando o documento é restrito ou sigiloso (nivelAcesso 1 ou 2), a
resposta inclui o campo _aviso_acesso — aviso INFORMATIVO de
privacidade, NÃO erro de permissão. Os metadados foram retornados
normalmente; não tente trocar de unidade ou rotas alternativas.
Se falhar com erro inesperado, use sei_versao para verificar a versão.
Inputs: id_documento (required). Returns: result
sei_consultar_marcador_processoCRead-only
Consulta os marcadores ativos de um processo.
Inputs: processo (required). Returns: result
sei_consultar_processoARead-only
Consulta um processo SEI pelo número de protocolo formatado.
Exemplo de protocolo: 50300.000123/2025-00
Por padrão usa só a REST mod-wssei (campos estruturados). Com SEI_WEB_SCRAPER=1, roda também o scraper web em paralelo (asyncio.gather) para anexar documentos[]/relacionados[] — inativo desde o SSO Microsoft.
Campos da REST (/processo/consultar + /processo/consultar/{id}):
IdProcedimento, ProtocoloProcedimentoFormatado, NomeTipoProcedimento
especificacao, assuntos[], interessados[], observacoes[]
nivelAcesso, hipoteseLegal, grauSigilo
Campos do scraper web (procedimento_visualizar / arvore_montar.php):
documentos[]: lista completa de documentos com id, label, tipo
relacionados[]: processos relacionados (cards na sidebar)
Se o scraper web falhar (ex: processo não está na inbox da unidade atual), a tool ainda retorna os campos REST. Se a REST falhar, retorna pelo menos o que o scraper conseguiu extrair.
Quando o processo é restrito ou sigiloso (nivelAcesso 1 ou 2), a resposta
inclui o campo _aviso_acesso — um aviso INFORMATIVO de privacidade,
NÃO um erro de permissão. Os metadados foram retornados com sucesso.
Inputs: protocolo_formatado (required). Returns: result
sei_criar_anotacaoB
Cria uma anotação (post-it) em um processo no SEI.
Parâmetros:
processo: protocolo formatado (ex: 50300.018905/2018-67) ou IdProcedimento
descricao: texto da anotação
prioridade: nível de prioridade (1=normal)
Inputs: processo (required), descricao (required), prioridade. Returns: result
sei_criar_bloco_assinaturaB
Cria um bloco de assinatura no SEI.
Parâmetros:
descricao: descrição do bloco
unidades: sigla(s) ou ID(s) das unidades para disponibilizar (separados por vírgula). Se informar sigla, resolve automaticamente.
Inputs: descricao (required), unidades. Returns: result
sei_criar_bloco_internoC
Cria um bloco interno no SEI.
Blocos internos são usados para organizar processos em lotes.
Inputs: descricao (required). Returns: result
sei_criar_contatoC
Cria novo contato no SEI.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: nome (required), tipo, email, telefone. Returns: result
sei_criar_documentoA
Cria um novo documento interno (nativo) em um processo SEI.
Parâmetros:
processo: protocolo formatado (ex: 50300.018905/2018-67) ou IdProcedimento
id_serie: código do tipo de documento (use sei_pesquisar_tipos_documento)
descricao: descrição/título do documento
nivel_acesso: 0=público, 1=restrito, 2=sigiloso
id_unidade: ID da unidade geradora (opcional)
O documento é criado vazio. Use sei_listar_secoes e sei_editar_secao para inserir conteúdo.
Inputs: id_serie (required), processo (required), descricao, id_unidade, +1 more. Returns: result
sei_criar_documento_externoA
Cria um documento externo (upload de arquivo) em um processo SEI.
processo: protocolo formatado ou IdProcedimento
id_serie: tipo do documento (use sei_pesquisar_tipos_documento)
descricao: descrição do documento
nivel_acesso: 0=público (padrão), 1=restrito, 2=sigiloso
data_elaboracao: dd/mm/aaaa (padrão: hoje)
O arquivo entra por UM dos dois caminhos:
arquivo_base64 + nome_arquivo: conteúdo do arquivo em base64. É o caminho a usar quando o arquivo não está no disco do servidor MCP — por exemplo um PDF vindo do Drive, gerado na conversa ou baixado de outra tool. O nome_arquivo importa: o SEI usa a extensão para tipar o anexo.
arquivo_path: caminho local NO SERVIDOR onde o MCP roda (não no seu computador). Só serve para arquivos que já estão lá.
O limite de tamanho é o do próprio SEI (veja sei_parametros_upload).
Inputs: id_serie (required), processo (required), descricao, arquivo_path, +4 more. Returns: result
sei_criar_grupo_acompanhamentoC
Cria um grupo de acompanhamento especial no SEI.
Inputs: nome (required). Returns: result
sei_criar_marcadorA
Cria um marcador na unidade atual.
nome: nome do marcador
id_cor: ID da cor (use sei_listar_cores_marcador para ver opções). Se omitido, lista as cores disponíveis para escolha.
Inputs: nome (required), id_cor. Returns: result
sei_criar_observacaoA
Cria observação da unidade em um processo.
Diferente da anotação (post-it individual), a observação é vinculada à unidade e visível por todos os usuários da unidade. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: processo (required), descricao (required). Returns: result
sei_criar_processoA
Cria um novo processo no SEI.
Parâmetros:
tipo_processo: ID do tipo de processo (use sei_pesquisar_tipos_processo)
especificacao: descrição do processo (recomendado para organizar a caixa)
assuntos: IDs dos assuntos (separados por vírgula)
interessados: IDs dos interessados (separados por vírgula)
observacoes: observações adicionais
nivel_acesso: 0=público (padrão), 1=restrito, 2=sigiloso
hipotese_legal: ID da hipótese legal (obrigatório se restrito/sigiloso). Use sei_pesquisar_hipoteses_legais para descobrir o ID.
Retorna o IdProcedimento e ProtocoloFormatado do processo criado.
Para assuntos, use sei_pesquisar_tipos_processo para ver as sugestões de assunto do tipo de processo escolhido (endpoint /processo/assunto/sugestao).
Inputs: tipo_processo (required), assuntos, observacoes, interessados, +3 more. Returns: result
sei_dar_cienciaB
Dá ciência em um documento ou processo no SEI.
Parâmetros:
referencia: número SEI do documento OU protocolo/IdProcedimento do processo
tipo: "documento" (padrão) ou "processo"
Exemplos:
sei_dar_ciencia("1482875", tipo="documento") → ciência na NT 16
sei_dar_ciencia("50300.018905/2018-67", tipo="processo") → ciência no processo
Inputs: referencia (required), tipo. Returns: result
sei_desativar_marcadorA
Desativa marcador(es) sem excluir. IDs separados por vírgula.
Marcadores desativados deixam de aparecer nas pesquisas mas mantêm o histórico. Use sei_reativar_marcador para reativar.
Inputs: ids_marcadores (required). Returns: result
sei_disponibilizar_bloco_assinaturaC
Disponibiliza um bloco de assinatura para as unidades configuradas.
Após disponibilizar, os usuários das unidades podem assinar os documentos.
Inputs: id_bloco (required). Returns: result
sei_editar_secaoAIdempotent
Altera o conteúdo de seções editáveis de um documento interno SEI.
Parâmetros:
id_documento: ID do documento
secoes: lista de seções a alterar, cada uma com:
idSecaoModelo: ID do modelo da seção (obtido via sei_listar_secoes)
conteudo: novo conteúdo HTML da seção (não é necessário incluir seções somenteLeitura — são preenchidas automaticamente com o conteúdo original)
versao: versão do documento (se omitida, obtida automaticamente)
dry_run: NÃO grava nada; devolve o payload exato que seria enviado (todas as seções, já normalizadas, com tamanhos em bytes). Use para inspecionar/isolar um problema numa chamada só, em vez de tentativa e erro.
validar_referencias: confere se alguma âncora
id="lnkSeiNNNN"está usando número SEI em vez do id interno (link morto). Avisos vão em_avisos.
O conteúdo deve ser HTML com as classes CSS do SEI (ex: Texto_Justificado).
Entidades HTML ( , ç, é, …) são convertidas para UTF-8
literal antes do envio — o SEI aceita, e isso evita que elas se acumulem a
cada ciclo ler→reenviar. Caracteres fora do ISO-8859-1 continuam sendo
convertidos para entidades numéricas (exigência do wssei).
IMPORTANTE: O SEI exige que TODAS as seções sejam enviadas. Esta tool faz isso automaticamente — basta informar as seções que deseja alterar.
O id_documento aceita número SEI (protocoloFormatado) ou id interno — é
resolvido automaticamente e o documento resolvido é ecoado no retorno
(_documento_resolvido), para evitar gravar no documento errado.
Se o Cloudflare bloquear a escrita por WAF, a tool sobe uma escada de tentativas (normalização → neutralização do cabeçalho base64 regenerável) e, se ainda assim falhar, relata exatamente o que foi tentado.
Inputs: secoes (required), id_documento (required), versao, dry_run, +1 more. Returns: result
sei_enviar_processoA
Envia (tramita) um processo para outra(s) unidade(s) no SEI.
Parâmetros:
numero_processo: protocolo formatado (ex: 50300.000123/2025-00)
unidades_destino: sigla da unidade (ex: "SFC", "ECP-SFC") OU ID numérico. Para múltiplas unidades, separe por vírgula. Se informar sigla, resolve o ID automaticamente via pesquisa.
manter_aberto: "N" fechar na unidade atual (padrão), "S" manter aberto
remover_anotacao: "S" remover anotações, "N" manter (padrão)
enviar_email: "S" notificar por email (só se o usuário pedir)
data_retorno: data de retorno programado DD/MM/AAAA (só se o usuário pedir)
dias_retorno: prazo em dias para retorno (alternativa à data, só se pedir)
Inputs: numero_processo (required), unidades_destino (required), data_retorno, dias_retorno, +3 more. Returns: result
sei_estilosARead-only
Lista os estilos CSS disponíveis para formatação de documentos no SEI.
O SEI usa classes CSS padronizadas em todos os documentos governamentais. Use esta tool para descobrir a classe correta para cada tipo de parágrafo.
Categorias: "texto", "titulo", "lista", "tabela", "destaque", "todos" Sem parâmetro: retorna os atalhos rápidos (intenção → classe).
CONVENÇÃO para documentos (Despachos, Notas Técnicas, etc.):
Corpo/mérito do texto: usar Paragrafo_Numerado_Nivel1 (autonumera 1. 2. 3.)
Endereçamento (À SFC...): usar Texto_Alinhado_Esquerda
Assunto: usar Texto_Justificado com para o título
Fecho (Atenciosamente): usar Texto_Justificado_Recuo_Primeira_Linha
Nome do signatário: usar Texto_Centralizado_Maiusculas
Cargo: usar Texto_Centralizado
Inputs: categoria. Returns: result
sei_excluir_bloco_assinaturaADestructive
Exclui bloco(s) de assinatura. IDs separados por vírgula.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: ids_blocos (required). Returns: result
sei_excluir_bloco_internoADestructive
Exclui bloco(s) interno(s). IDs separados por vírgula.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: ids_blocos (required). Returns: result
sei_excluir_grupo_acompanhamentoADestructive
Exclui grupo(s) de acompanhamento especial. IDs separados por vírgula.
Inputs: ids_grupos (required). Returns: result
sei_excluir_marcadorBDestructive
Exclui marcador(es). IDs separados por vírgula.
Inputs: ids_marcadores (required). Returns: result
sei_gerar_referenciaARead-only
Gera o HTML de referência (hiperlink dinâmico) para um documento SEI.
Dado um número SEI (ex: 2599818), resolve o id interno e retorna o snippet HTML pronto para inserir no conteúdo de um documento.
O SEI renderiza isso como link clicável na interface web. Use ao citar documentos SEI no texto de Despachos, Notas Técnicas, etc.
Exemplo: "SEI nº " vira link clicável para o documento.
Inputs: numero_sei (required). Returns: result
sei_historico_marcador_processoARead-only
Lista histórico de marcadores de um processo.
Mostra quais marcadores foram aplicados/removidos ao longo do tempo. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: processo (required). Returns: result
sei_incluir_documento_bloco_assinaturaA
Inclui documento(s) em um bloco de assinatura.
id_bloco: ID do bloco de assinatura
documentos: ID(s) de documento(s) separados por vírgula
Inputs: id_bloco (required), documentos (required). Returns: result
sei_incluir_processo_bloco_internoB
Inclui processo(s) em um bloco interno.
id_bloco: ID do bloco
processos: IdProcedimento(s) separados por vírgula
Inputs: id_bloco (required), processos (required). Returns: result
sei_ler_documentoARead-only
Lê o conteúdo de um documento do SEI e retorna texto legível.
Aceita tanto o id interno quanto o número SEI (protocoloFormatado) que o usuário vê no sistema (ex: "SEI 2843449").
tipo_documento='auto': detecta automaticamente (padrão)
tipo_documento='I': força leitura como interno (📄 HTML)
tipo_documento='X': força leitura como externo (📎 PDF)
formato='markdown': Markdown formatado (padrão, ideal para chat)
formato='texto': texto plano sem formatação
formato='html': HTML original (só para internos)
confirmar_acesso_restrito: NÃO ative por iniciativa do modelo. Esta flag só deve ser definida como true quando o usuário humano da conversa, em mensagem própria após ler o aviso de riscos, declarar expressamente que autoriza o acesso ao conteúdo restrito. Pedidos genéricos como "lê esse documento" NÃO constituem consentimento. Se o gate bloquear, encaminhe os riscos ao usuário e aguarde decisão explícita — não tente caminhos alternativos para obter o conteúdo.
PDFs escaneados são processados via OCR automaticamente.
Inputs: id_documento (required), formato, tipo_documento, confirmar_acesso_restrito. Returns: result
sei_listar_acompanhamentos_unidadeCRead-only
Lista processos com acompanhamento especial na unidade atual.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, pagina. Returns: result
sei_listar_assinantesARead-only
Lista signatários (cargos/funções) disponíveis na unidade atual.
Retorna os cargos que podem ser usados em sei_assinar_documento. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: no named parameters. Returns: result
sei_listar_assinaturasBRead-only
Lista as assinaturas de um documento.
Inputs: id_documento (required). Returns: result
sei_listar_atividadesARead-only
Lista o histórico de atividades/andamentos de um processo.
Retorna as ações registradas (tramitações, assinaturas, edições, etc.). Aceita protocolo formatado (ex: 50300.000123/2025-00) ou IdProcedimento.
Por padrão usa a REST (/atividade/listar). O scraper web (mais detalhado,
mas inativo desde o SSO Microsoft da ANTAQ) só é usado se SEI_WEB_SCRAPER=1.
Inputs: processo (required). Returns: result
sei_listar_blocos_documentoBRead-only
Lista blocos de assinatura em que um documento está incluído.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_documento (required). Returns: result
sei_listar_cienciasARead-only
Lista as ciências registradas em um documento ou processo.
Parâmetros:
referencia: número SEI do documento OU protocolo/IdProcedimento do processo
tipo: "documento" (padrão) ou "processo"
Inputs: referencia (required), tipo. Returns: result
sei_listar_contextosARead-only
Lista os contextos disponíveis para um órgão.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_orgao (required). Returns: result
sei_listar_credenciamentosBRead-only
Lista credenciamentos de acesso a um processo sigiloso.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: processo (required). Returns: result
sei_listar_documentosARead-only
Lista os documentos de um processo SEI, com ordenação e paginação.
Aceita o protocolo formatado (ex: 50300.000123/2025-00) ou o IdProcedimento.
ordem: 'asc' (ordem da árvore, o padrão do SEI) ou 'desc' (mais recentes primeiro). Em processo antigo e volumoso, 'desc' é como achar o documento que você acabou de criar sem varrer a lista inteira.
limite/offset: recorte da lista já ordenada (offset é em ITENS, não página).
resumido: True (padrão) devolve id, protocoloFormatado, tipo, unidade, nome, flags de assinado/cancelado e nível de acesso. False devolve o payload bruto da wssei — completo, porém grande o bastante para estourar a janela de contexto em processos com muitos documentos.
A resposta traz total (do servidor), retornados e truncado. Para ler o
conteúdo de um documento, use sei_ler_documento com o id. A listagem não
inclui data — ela vem de sei_consultar_documento_interno (dataElaboracao).
Nota: com SEI_WEB_SCRAPER=1 a listagem vem do scraper web e estes parâmetros de ordem/paginação não se aplicam (o scraper devolve a árvore inteira).
Inputs: protocolo_formatado (required), ordem, limite, offset, +1 more. Returns: result
sei_listar_documentos_bloco_assinaturaBRead-only
Lista documentos de um bloco de assinatura.
Inputs: id_bloco (required). Returns: result
sei_listar_grupos_acompanhamentoCRead-only
Lista grupos de acompanhamento disponíveis.
Inputs: filtro. Returns: result
sei_listar_grupos_modelosBRead-only
Lista grupos de modelos de documento disponíveis.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, pagina. Returns: result
sei_listar_interessadosCRead-only
Lista os interessados de um processo.
Inputs: processo (required). Returns: result
sei_listar_meus_acompanhamentosBRead-only
Lista processos que o usuário está acompanhando (acompanhamento especial).
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, pagina. Returns: result
sei_listar_modelosARead-only
Lista modelos de documento disponíveis.
id_grupo: filtrar por grupo (use sei_listar_grupos_modelos)
filtro: texto para filtrar por nome
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, filtro, pagina, id_grupo. Returns: result
sei_listar_orgaosARead-only
Lista os órgãos cadastrados na instalação do SEI.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: no named parameters. Returns: result
sei_listar_orgaos_assinanteARead-only
Lista órgãos disponíveis para assinatura.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: no named parameters. Returns: result
sei_listar_processosARead-only
Lista processos da caixa da unidade atual (Controle de Processos), em formato ENXUTO e tipado, próprio para consumo por agente.
IMPORTANTE: chame sei_trocar_unidade ANTES para que atribuido_unidade_atual
seja resolvido corretamente para a unidade consultada (sem isso vem null).
Parâmetros:
pagina: número da página (0=primeira). Cada página tem
limititens.limit: itens por página (padrão 50).
apenas_meus: "S" para só processos atribuídos ao usuário (server-side).
filtro: busca textual server-side (protocolo, tipo, especificação, etc.).
tipo: substring (case-insensitive) no nome do tipo processual (client-side).
apenas_contar: se True, retorna só {total_itens, paginas} — barato, sem baixar a página pesada.
incluir_detalhe: se True, reanexa
cienciaseanotacoescompletas a cada item (fora da list view por padrão, para manter o payload pequeno).
Cada processo (list view) traz campos derivados e tipados:
id_procedimento, protocolo, tipo, descricao (texto limpo, sem entidades HTML)
acesso: "publico" | "restrito" | "sigiloso"
atribuido_unidade_atual: {id_usuario, nome} resolvido para a unidade da sessão, ou
nullse não houver atribuição nelagerado_ou_recebido, em_tramitacao, sobrestado, bloqueado, tem_documento_novo, tem_anotacao, tem_ciencia — todos BOOLEAN
marcador: {nome, cor} ou null · prazo: data ISO (aaaa-mm-dd) ou null
aberto_em_unidades: lista de siglas das unidades onde o processo está aberto
NOTA: processos sobrestados e concluídos não aparecem. Para agrupamento estatístico use sei_resumo_processos.
Inputs: tipo, limit, filtro, pagina, +3 more. Returns: result
sei_listar_processos_bloco_internoCRead-only
Lista processos de um bloco interno.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required). Returns: result
sei_listar_relacionamentosARead-only
Lista processos relacionados a um processo.
REQUER mod-wssei 3.0.2+ (SEI 5.0.x). Não disponível em versões anteriores. Se falhar, use sei_versao para verificar. Precisa ser >= 3.0.2.
Inputs: processo (required). Returns: result
sei_listar_secoesARead-only
Lista as seções editáveis de um documento interno SEI.
Aceita o número SEI (protocoloFormatado, ex: 2943731) OU o id interno — a
tool resolve automaticamente (igual sei_ler_documento). O número que o
usuário vê (protocoloFormatado) É DIFERENTE do id interno; a resposta inclui
_documento_resolvido (protocoloFormatado + idProcedimento) para você
conferir que caiu no documento certo antes de editar.
Retorna as seções com IDs, conteúdo atual (HTML) e a versão do documento (campo ultimaVersaoDocumento), necessária para usar sei_editar_secao.
Inputs: id_documento (required). Returns: result
sei_listar_sobrestamentosBRead-only
Lista o histórico de sobrestamentos de um processo.
Inputs: processo (required). Returns: result
sei_listar_unidadesARead-only
Lista as unidades às quais o usuário autenticado tem acesso no SEI.
Retorna id, sigla e nome de cada unidade. Use o id para trocar de unidade com sei_trocar_unidade.
Inputs: no named parameters. Returns: result
sei_listar_unidades_processoBRead-only
Lista as unidades onde o processo está aberto.
Inputs: processo (required). Returns: result
sei_listar_usuariosARead-only
Lista usuários no SEI, com filtro por nome ou sigla.
apenas_unidade=true (padrão): só usuários com permissão na unidade atual — ideal para atribuição de processos
apenas_unidade=false: todos os usuários do órgão
Use o campo id_usuario retornado para sei_atribuir_processo.
Inputs: filtro, apenas_unidade. Returns: result
sei_marcar_nao_lidoA
Marca um processo como não lido na unidade atual.
O SEI não possui funcionalidade nativa para isso. Esta tool usa o workaround de enviar o processo para a própria unidade, o que faz o SEI tratar como novo recebimento (não lido).
numero_processo: protocolo formatado (ex: 50300.012639/2023-26)
Inputs: numero_processo (required). Returns: result
sei_marcar_processoA
Adiciona ou altera marcador (etiqueta colorida) em um processo.
Parâmetros:
processo: protocolo formatado ou IdProcedimento
marcador: ID do marcador (use sei_pesquisar_marcadores para listar)
texto: texto/comentário associado ao marcador (opcional)
Para remover, use marcador vazio ou marque com outro marcador.
Inputs: marcador (required), processo (required), texto. Returns: result
sei_parametros_uploadARead-only
Retorna parâmetros de upload do SEI (extensões permitidas, tamanhos máximos).
Útil antes de criar documentos externos para saber os limites. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: no named parameters. Returns: result
sei_pesquisar_assuntosARead-only
Pesquisa assuntos disponíveis para processos.
Use o ID retornado no campo 'assuntos' ao criar processos. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, filtro, pagina. Returns: result
sei_pesquisar_blocos_assinaturaCRead-only
Pesquisa blocos de assinatura existentes.
Inputs: limit, filtro. Returns: result
sei_pesquisar_contatosCRead-only
Pesquisa contatos cadastrados no SEI.
Inputs: limit, filtro. Returns: result
sei_pesquisar_hipoteses_legaisARead-only
Pesquisa hipóteses legais disponíveis no SEI.
Necessário ao criar processos ou documentos com nível de acesso restrito ou sigiloso. Use o 'id' retornado no parâmetro hipotese_legal de sei_criar_processo.
Exemplos: "pessoal", "controle interno", "sigilo fiscal"
Inputs: limit, filtro, pagina. Returns: result
sei_pesquisar_marcadoresARead-only
Lista marcadores disponíveis na unidade atual.
Use o 'id' retornado em sei_marcar_processo.
Inputs: limit, filtro. Returns: result
sei_pesquisar_outras_unidadesARead-only
Pesquisa unidades excluindo a unidade atual.
Útil para tramitação — já filtra a unidade do usuário. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, filtro, pagina. Returns: result
sei_pesquisar_processosARead-only
Pesquisa processos no SEI por texto, descrição, datas, unidade ou assunto.
Use palavras_chave para busca geral ou busca_rapida para busca simplificada. Datas no formato DD/MM/AAAA.
Filtros adicionais:
sta_tipo_data: tipo de período — "30" (últimos 30 dias), "60" (últimos 60 dias) ou "0" (personalizado, requer data_inicio/data_fim)
id_unidade_geradora: id da unidade que gerou o processo (use sei_listar_unidades)
id_assunto: id do assunto (use sei_pesquisar_assuntos para obter o id)
grupo: id do grupo de acompanhamento (use sei_listar_grupos_acompanhamento)
Paginação: pagina=0 é a primeira página, pagina=1 a segunda, etc.
Inputs: grupo, limit, pagina, data_fim, +7 more. Returns: result
sei_pesquisar_textos_padraoARead-only
Pesquisa textos padrão internos disponíveis na unidade.
Textos padrão são modelos reutilizáveis para preencher documentos automaticamente ao criar um novo documento interno. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, filtro, pagina. Returns: result
sei_pesquisar_tipos_conferenciaBRead-only
Pesquisa tipos de conferência para documentos externos.
Tipo de conferência indica se o documento externo é cópia autenticada, cópia simples, original, etc. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, filtro, pagina. Returns: result
sei_pesquisar_tipos_documentoARead-only
Pesquisa tipos de documento (séries) disponíveis no SEI.
Parâmetros:
filtro: texto para filtrar por nome do tipo
favoritos: "S" para apenas favoritos
aplicabilidade: "I" para internos, "F" para externos, ou "I,F" para ambos
limit: quantidade por página
pagina: número da página (0=primeira)
Use o 'id' retornado como id_serie em sei_criar_documento.
Inputs: limit, filtro, pagina, favoritos, +1 more. Returns: result
sei_pesquisar_tipos_documento_externoARead-only
Pesquisa tipos de documento para documentos externos (séries externas).
Diferente de sei_pesquisar_tipos_documento que lista todos os tipos, este retorna apenas os tipos aplicáveis a documentos externos. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, filtro, pagina. Returns: result
sei_pesquisar_tipos_processoARead-only
Pesquisa tipos de processo disponíveis no SEI.
Parâmetros:
filtro: texto para filtrar por nome (ex: "Plano Anual", "Fiscalização")
favoritos: "S" para apenas favoritos
limit/pagina: paginação
Use o 'id' retornado como tipo_processo em sei_criar_processo.
Inputs: limit, filtro, pagina, favoritos. Returns: result
sei_pesquisar_unidadesARead-only
Pesquisa unidades disponíveis no SEI por nome ou sigla.
Útil para encontrar o ID de uma unidade destino ao tramitar processos. Paginação: pagina=0 é a primeira página, pagina=1 a segunda, etc.
Inputs: limit, filtro, pagina. Returns: result
sei_pesquisar_usuariosARead-only
Pesquisa usuários por palavra-chave no órgão.
Diferente de sei_listar_usuarios (que lista por unidade), este pesquisa no servidor por nome/sigla em todo o órgão. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: limit, filtro, pagina, id_orgao. Returns: result
sei_reabrir_bloco_assinaturaC
Reabre bloco de assinatura concluído.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required). Returns: result
sei_reabrir_bloco_internoC
Reabre bloco interno concluído.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required). Returns: result
sei_reabrir_processoA
Reabre um processo que foi concluído na unidade.
processo: protocolo formatado (ex: 50300.018905/2018-67) ou IdProcedimento
O processo volta para a caixa da unidade atual.
Inputs: processo (required). Returns: result
sei_reativar_marcadorA
Reativa marcador(es) desativados. IDs separados por vírgula.
Inputs: ids_marcadores (required). Returns: result
sei_receber_processoA
Confirma o recebimento de um processo na unidade atual.
processo: protocolo formatado ou IdProcedimento
Inputs: processo (required). Returns: result
sei_registrar_andamentoA
Registra um andamento (atividade) no processo.
processo: protocolo formatado ou IdProcedimento
descricao: texto do andamento
Inputs: processo (required), descricao (required). Returns: result
sei_remover_acompanhamentoB
Remove acompanhamento especial de um processo.
Consulta o acompanhamento ativo e remove.
Inputs: processo (required). Returns: result
sei_remover_atribuicaoA
Remove a atribuição de um processo (desatribui de qualquer usuário).
processo: protocolo formatado ou IdProcedimento
Inputs: processo (required). Returns: result
sei_remover_sobrestamentoA
Remove o sobrestamento de um processo no SEI.
processo: protocolo formatado (ex: 50300.018905/2018-67) ou IdProcedimento
Inputs: processo (required). Returns: result
sei_renunciar_credenciamentoA
Renuncia ao credenciamento de acesso a um processo sigiloso.
O próprio usuário perde o acesso ao processo. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: processo (required). Returns: result
sei_resumo_processosARead-only
Gera um resumo agrupado dos processos da caixa da unidade atual.
Busca TODOS os processos e agrupa por um ou dois campos.
Campos disponíveis para agrupar_por e agrupar_por_2:
tipo: Tipo processual
atribuido: Usuário atribuído
acesso: Nível de acesso (Público/Restrito/Sigiloso)
tramitacao: Em tramitação ou não
sobrestado: Sobrestado ou ativo
bloqueado: Bloqueado ou não
novo: Com/sem documentos novos
anotacao: Com/sem anotação (inclui prioridade)
retorno: Retorno programado (inclui data e atraso)
lido_usuario: Acessado pelo usuário
lido_unidade: Acessado pela unidade
origem: Gerado na unidade ou recebido
anexado: Anexado a outro processo
unidades: Unidades onde está aberto
marcador: Marcador/etiqueta
ciencia: Com/sem ciência
Exemplos:
agrupar_por="tipo" → quantidade por tipo processual
agrupar_por="atribuido" → distribuição por pessoa
agrupar_por="tipo", agrupar_por_2="atribuido" → cruzamento tipo × pessoa
agrupar_por="retorno" → processos com prazo vencido
Inputs: filtro, agrupar_por, apenas_meus, agrupar_por_2. Returns: result
sei_retirar_documentos_bloco_assinaturaB
Retira documento(s) de um bloco de assinatura.
documentos: ID(s) de documento(s) separados por vírgula
Inputs: id_bloco (required), documentos (required). Returns: result
sei_retirar_processo_bloco_internoA
Remove processo(s) de um bloco interno.
id_bloco: ID do bloco
processos: IdProcedimento(s) separados por vírgula
Inputs: id_bloco (required), processos (required). Returns: result
sei_retornar_bloco_assinaturaC
Retorna bloco de assinatura para a unidade de origem.
Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_bloco (required). Returns: result
sei_sobrestar_processoB
Sobresta um processo no SEI.
Parâmetros:
processo: protocolo formatado (ex: 50300.018905/2018-67) ou IdProcedimento
motivo: motivo do sobrestamento (obrigatório)
processo_vinculado: protocolo de outro processo para vincular (opcional). Se informado, o sobrestamento fica vinculado ao andamento desse processo.
Inputs: motivo (required), processo (required), processo_vinculado. Returns: result
sei_sugestao_assuntos_documentoARead-only
Lista sugestões de assuntos para um tipo de documento (série).
Use o id_serie obtido via sei_pesquisar_tipos_documento. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_serie (required). Returns: result
sei_sugestao_assuntos_processoARead-only
Lista sugestões de assuntos para um tipo de processo.
Use o id do tipo obtido via sei_pesquisar_tipos_processo. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: id_tipo_processo (required). Returns: result
sei_trocar_unidadeA
Troca a unidade ativa do usuário no SEI.
Após trocar, operações como sei_listar_processos mostrarão a caixa da nova unidade. Use sei_listar_unidades para ver as unidades disponíveis e seus IDs.
Inputs: id_unidade (required). Returns: result
sei_verificar_acessoARead-only
Verifica se o usuário tem acesso a um processo.
Útil para checar permissão antes de operações em processos restritos. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: processo (required). Returns: result
sei_versaoARead-only
Retorna a versão do SEI e do módulo wssei instalado.
Útil para verificar compatibilidade de funcionalidades. Disponível desde mod-wssei 2.0.0 (SEI 4.0.x). Se falhar com erro inesperado, use sei_versao para verificar a versão instalada.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 116 tools
Many tools have similar purposes (e.g., listar, pesquisar, consultar for processes) and the sheer number (116) creates overlap, but detailed descriptions help differentiate specific use cases.
All tools start with 'sei_' and follow snake_case with verb_noun pattern, mostly consistent Portuguese verbs (listar, criar, excluir). Minor mix of 'consultar' vs 'listar' for similar actions.
116 tools is excessive for a typical MCP server; it overwhelms agents and includes many edge-case or administrative functions that could be consolidated.
The tool set extensively covers process, document, bloc, marker, signature, and credential management, with only minor missing bulk or advanced operations.
Maintenance
Related MCP Connectors
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
Ferramentas MCP para NF-e, NFS-e, documentos, certificados e tributos brasileiros.
Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.
MCP server for the PDFGate API. Generate PDFs, manage documents and handle e-signatures.
Related MCP Servers
- AlicenseDqualityDmaintenanceServidor MCP para a API do ComexStat, ferramenta de acesso às estatísticas de comércio exterior do Brasil.209 npm2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for querying Brazil's CNJ DataJud public API. Enables validating CNJ process numbers, searching lawsuits by number, and listing courts.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for consulting official public data from Brazil's TRF3 (Tribunal Regional Federal da 3ª Região) through a read-only hosted API, compatible with any MCP over HTTP client.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for read-only consultation of Brazilian National Council of Justice SEEU court proceedings from official sources, using prepaid credit.MIT