io.github.mcp-dir/astrea-mcp

Tools

• astrea_agenda_global

  Agenda do escritório no Astrea — audiências (HEARING), reuniões/eventos (EVENT), prazos (DEADLINE) e tarefas (TASK). Ações: - global: todas as atividades numa janela de datas (date_from/date_to no formato AAAAMMDD). - por_cliente: as atividades agrupadas por cliente (via processo vinculado; avulsas vão em "(sem cliente)"). [Flattened action: global]

  shallow
• astrea_agenda_por_cliente

  Agenda do escritório no Astrea — audiências (HEARING), reuniões/eventos (EVENT), prazos (DEADLINE) e tarefas (TASK). Ações: - global: todas as atividades numa janela de datas (date_from/date_to no formato AAAAMMDD). - por_cliente: as atividades agrupadas por cliente (via processo vinculado; avulsas vão em "(sem cliente)"). [Flattened action: por_cliente]

  shallow
• astrea_andamento_criar

  Lança um andamento (histórico) MANUAL num processo do Astrea — registra um ato/observação na timeline do processo (não é captura automática do tribunal). - case_id: id do processo (ver astrea_processos). - description: texto do andamento (aceita HTML simples; texto puro vira um parágrafo). - date: data/hora do andamento em ISO (ex.: 2026-06-30 ou 2026-06-30T13:00:00Z); omita para usar agora. Bulk support: accepts case_ids for batched execution.

  shallow
• astrea_andamentos

  Andamentos (timeline/histórico) de um processo no Astrea — base para gerar relatórios ao cliente. Cada andamento traz date, type, description, responsible. type que começa com AUTOMATIC = captura automática do tribunal; os demais são manuais. Bulk support: accepts case_ids for batched execution.

  shallow
• astrea_caso_criar

  Cria um CASO extrajudicial/consultivo novo no Astrea. No Astrea o caso é uma pasta SEM número CNJ e SEM tribunal, entidade distinta de processo. Use para consultoria, contratos, procedimentos administrativos, licitações, retainer etc., destravando a automação (andamento, tarefa, prazo, documento) sobre a pasta. Obrigatório: titulo, e o cliente (customer_id de astrea_clientes OU customer_nome para criar um contato novo). Para processo JUDICIAL (com CNJ/tribunal) use astrea_processo_criar.

  shallow
• astrea_clientes

  Clientes/contatos do escritório no Astrea — UMA página compacta (id, nome, classificação, tipo, tags). Pagine com o cursor devolvido. Não varre a conta toda.

  shallow
• astrea_compromisso_criar

  Cria um COMPROMISSO/evento na agenda, vinculado a um processo no Astrea. - case_id: id do processo (ver astrea_processos). - title: título do compromisso. - start: início em ISO (ex.: 2026-07-10T14:00:00Z). Interpretado no fuso do servidor (UTC). - end: opcional, fim em ISO; se omitido, 30 min após o início. - all_day: opcional, true para dia inteiro. - location: opcional, endereço/local. - responsible_id: opcional, id do membro responsável (ver astrea_responsaveis). Se omitir, fica no usuário da integração e pode NÃO aparecer na agenda do advogado. Passe o id da pessoa para o compromisso aparecer na agenda dela. - repeat: opcional, cria uma SÉRIE recorrente numa só chamada (semanal/mensal/etc.). A 1ª ocorrência é o start; cada ocorrência preserva o horário e a duração. Cada compromisso é independente (exclua individualmente com astrea_compromisso_excluir). Bulk support: accepts case_ids, responsible_ids for batched execution.

  shallow
• astrea_compromisso_excluir

  Exclui um COMPROMISSO/evento da agenda do Astrea. Use para remover um compromisso cadastrado errado (ex.: hora errada) e recriá-lo com astrea_compromisso_criar. - appointment_id: id do compromisso (retornado em astrea_compromisso_criar). Bulk support: accepts appointment_ids for batched execution.

  shallow
• astrea_conta

  Conta do escritório no Astrea: plano contratado (Light/Up/Smart/Company/VIP), status (trial/ativo), dias de trial restantes, tenant e perfil. Útil pra saber em que plano o escritório está.

  shallow
• astrea_documento_gerar

  Gera um documento a partir de um MODELO cadastrado no Astrea e o vincula ao processo (área Documentos). O Astrea preenche as variáveis do modelo com os dados do processo, do cliente, do escritório e a data (ex.: gerar uma procuração para o processo X usando o modelo "Procuração PJ"). Para anexar um arquivo PRONTO em vez de gerar a partir de modelo, use astrea_documento_upload. - model: id ou nome do modelo (ver astrea_modelos); por nome, casa parcialmente (se ambíguo, use o id). - case_id: id do processo (ver astrea_processos). - title: opcional, título do documento gerado; se omitir, usa o nome do modelo. - responsible_id: opcional, id do membro responsável (ver astrea_responsaveis); se omitir, fica no usuário da integração. Bulk support: accepts case_ids, responsible_ids for batched execution.

  shallow
• astrea_documento_upload

  Anexa um DOCUMENTO a um processo do Astrea (PDF de petição, comprovante, certidão, decisão, etc.). O arquivo fica vinculado ao PROCESSO, na área Documentos (o Astrea não anexa arquivo dentro de um andamento/tarefa, o vínculo é sempre no processo). - case_id: id do processo (ver astrea_processos). - attachments: um ou mais arquivos. Por arquivo, informe UMA das formas: file_url (baixa da URL), file_base64 (conteúdo em base64) ou upload_code (de um upload grande via curl). file_name é obrigatório com file_url/file_base64. - description: descrição do documento (se omitir, usa o nome dos arquivos). - responsible_id: opcional, id do membro responsável (ver astrea_responsaveis); se omitir, fica no usuário da integração. Bulk support: accepts case_ids, responsible_ids for batched execution.

  shallow
• astrea_encerrar

  Encerra (inativa) processos no Astrea, EM LOTE — marca a situação como encerrado (as informações continuam disponíveis para consulta). Use na higienização da carteira para baixar processos finalizados. - case_ids: ids dos processos (ver astrea_processos); aceita vários. - conviction_amount: opcional, valor da condenação a gravar no encerramento. - unlink_from_court: opcional, true também desvincula do tribunal (para de receber andamentos automáticos). Reabrir um processo encerrado é feito pela própria tela do Astrea (Ativar processo). O Astrea processa o lote de forma assíncrona.

  shallow
• astrea_etiquetar_aplicar

  Aplica ou remove etiquetas (tags) em processos do Astrea, EM LOTE — use para classificar/higienizar a carteira (ex.: marcar a área de centenas de processos de uma vez). - action "aplicar" adiciona as etiquetas; "remover" tira as etiquetas (sem apagar a etiqueta em si). - case_ids: ids dos processos (ver astrea_processos); aceita vários (o lote roda numa só chamada, fatiado internamente). - tag_ids: ids das etiquetas (ver astrea_etiquetas); aceita várias. O Astrea processa o lote de forma assíncrona; o efeito aparece em alguns segundos. As etiquetas precisam existir (crie-as no Astrea antes). [Flattened action: aplicar]

  shallow
• astrea_etiquetar_remover

  Aplica ou remove etiquetas (tags) em processos do Astrea, EM LOTE — use para classificar/higienizar a carteira (ex.: marcar a área de centenas de processos de uma vez). - action "aplicar" adiciona as etiquetas; "remover" tira as etiquetas (sem apagar a etiqueta em si). - case_ids: ids dos processos (ver astrea_processos); aceita vários (o lote roda numa só chamada, fatiado internamente). - tag_ids: ids das etiquetas (ver astrea_etiquetas); aceita várias. O Astrea processa o lote de forma assíncrona; o efeito aparece em alguns segundos. As etiquetas precisam existir (crie-as no Astrea antes). [Flattened action: remover]

  shallow
• astrea_etiquetas

  Lista as etiquetas (tags) do Astrea — id, label, cor, restrictions (CASES/TASKS/APPOINTMENTS). Use para descobrir o id da etiqueta de "êxito" (ou qualquer outra) e então filtrar processos com astrea_processos (tag_id) e somar valor da causa / honorários (astrea_financeiro).

  shallow
• astrea_financeiro_despesas

  Resumo financeiro de um processo no Astrea. Ações: - honorarios: honorários do processo (totalAmount/totalReceived/totalOpen) — use para "valor de êxito". - despesas: despesas do processo. [Flattened action: despesas] Bulk support: accepts case_ids for batched execution.

  shallow
• astrea_financeiro_honorarios

  Resumo financeiro de um processo no Astrea. Ações: - honorarios: honorários do processo (totalAmount/totalReceived/totalOpen) — use para "valor de êxito". - despesas: despesas do processo. [Flattened action: honorarios] Bulk support: accepts case_ids for batched execution.

  shallow
• astrea_modelos

  Lista os MODELOS de documento cadastrados no Astrea (procuração, contrato de honorários, petição, etc.). Use para descobrir o modelo antes de gerar um documento com astrea_documento_gerar. Retorna id + nome de cada modelo.

  shallow
• astrea_processo_criar

  Cria um PROCESSO judicial novo no Astrea (fecha a paridade CRUD com astrea_processo_editar/astrea_encerrar). Use para cadastrar um processo a partir de dados extraídos (ex.: petição inicial), destravando a automação (andamento, tarefa, prazo, documento). Obrigatório: titulo, e o cliente (customer_id de astrea_clientes OU customer_nome para criar um contato novo). Campos judiciais opcionais, informados por NOME: numero_cnj, tribunal, vara, tipo_acao, data_distribuicao (AAAA-MM-DD), instancia. Para CASO extrajudicial/consultivo (sem CNJ/tribunal) use astrea_caso_criar.

  shallow
• astrea_processo_editar

  Edita campos de UM processo no Astrea. Lê o processo atual e regrava preservando o resto (só muda o que você informar). Campos editáveis (informe ao menos um): - objeto: o campo "Objeto" (descrição do processo). - conviction_amount: valor da condenação. Para encerrar/reativar ou etiquetar use astrea_encerrar / astrea_etiquetar. Bulk support: accepts case_ids for batched execution.

  shallow
• astrea_processos_count

  Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto. Ações: - list: UMA página de processos (não varre a conta toda). Filtros: contact_id, tag_id, status. Pagine com cursor (devolvido em cada resposta). - count: total de processos (mesmos filtros) rápido, use pra "quantos". - por_cliente: resumo por cliente (qtd + soma do valor da causa), ordenado. Use top_n pra limitar. Respeita o status. Sem o detalhe dos processos, pra detalhar chame list com contact_id. - novos_por_mes: nº de processos novos por mês (data de distribuição). Respeita o status. Campos por processo (list): id, number, customer/customerId, title, court, lawsuitType, amount (valor da causa), convictionAmount (valor da condenação, só vem quando preenchido no Astrea), distribuitionDate, lastMovement, active (true=em andamento, false=encerrado), currentInstanceNumber (grau/instância), situacao (rótulo pronto, ex.: "Encerrado 1º Grau"), tagIds. [Flattened action: count] Bulk support: accepts contact_ids, tag_ids for batched execution.

  shallow
• astrea_processos_list

  Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto. Ações: - list: UMA página de processos (não varre a conta toda). Filtros: contact_id, tag_id, status. Pagine com cursor (devolvido em cada resposta). - count: total de processos (mesmos filtros) rápido, use pra "quantos". - por_cliente: resumo por cliente (qtd + soma do valor da causa), ordenado. Use top_n pra limitar. Respeita o status. Sem o detalhe dos processos, pra detalhar chame list com contact_id. - novos_por_mes: nº de processos novos por mês (data de distribuição). Respeita o status. Campos por processo (list): id, number, customer/customerId, title, court, lawsuitType, amount (valor da causa), convictionAmount (valor da condenação, só vem quando preenchido no Astrea), distribuitionDate, lastMovement, active (true=em andamento, false=encerrado), currentInstanceNumber (grau/instância), situacao (rótulo pronto, ex.: "Encerrado 1º Grau"), tagIds. [Flattened action: list] Bulk support: accepts contact_ids, tag_ids for batched execution.

  shallow
• astrea_processos_novos_por_mes

  Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto. Ações: - list: UMA página de processos (não varre a conta toda). Filtros: contact_id, tag_id, status. Pagine com cursor (devolvido em cada resposta). - count: total de processos (mesmos filtros) rápido, use pra "quantos". - por_cliente: resumo por cliente (qtd + soma do valor da causa), ordenado. Use top_n pra limitar. Respeita o status. Sem o detalhe dos processos, pra detalhar chame list com contact_id. - novos_por_mes: nº de processos novos por mês (data de distribuição). Respeita o status. Campos por processo (list): id, number, customer/customerId, title, court, lawsuitType, amount (valor da causa), convictionAmount (valor da condenação, só vem quando preenchido no Astrea), distribuitionDate, lastMovement, active (true=em andamento, false=encerrado), currentInstanceNumber (grau/instância), situacao (rótulo pronto, ex.: "Encerrado 1º Grau"), tagIds. [Flattened action: novos_por_mes] Bulk support: accepts contact_ids, tag_ids for batched execution.

  shallow
• astrea_processos_por_cliente

  Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto. Ações: - list: UMA página de processos (não varre a conta toda). Filtros: contact_id, tag_id, status. Pagine com cursor (devolvido em cada resposta). - count: total de processos (mesmos filtros) rápido, use pra "quantos". - por_cliente: resumo por cliente (qtd + soma do valor da causa), ordenado. Use top_n pra limitar. Respeita o status. Sem o detalhe dos processos, pra detalhar chame list com contact_id. - novos_por_mes: nº de processos novos por mês (data de distribuição). Respeita o status. Campos por processo (list): id, number, customer/customerId, title, court, lawsuitType, amount (valor da causa), convictionAmount (valor da condenação, só vem quando preenchido no Astrea), distribuitionDate, lastMovement, active (true=em andamento, false=encerrado), currentInstanceNumber (grau/instância), situacao (rótulo pronto, ex.: "Encerrado 1º Grau"), tagIds. [Flattened action: por_cliente] Bulk support: accepts contact_ids, tag_ids for batched execution.

  shallow
• astrea_responsaveis

  Lista os usuários (membros) do escritório no Astrea — id, nome, e-mail. Use para descobrir o id do RESPONSÁVEL antes de criar tarefa/compromisso (astrea_tarefa_criar / astrea_compromisso_criar com responsible_id), para que a atividade apareça na agenda da pessoa certa. O campo "eu" marca o usuário da integração.

  shallow
• astrea_tarefa_criar

  Cria uma TAREFA vinculada a um processo no Astrea. - case_id: id do processo (ver astrea_processos). - description: o que fazer. - due_date: opcional, prazo em ISO (ex.: 2026-07-10). - responsible_id: opcional, id do membro do escritório responsável (ver astrea_responsaveis). Se omitir, fica no usuário da integração e pode NÃO aparecer na agenda do advogado, que filtra pelo próprio responsável. Para a tarefa aparecer na agenda de alguém, passe o id dessa pessoa. - repeat: opcional, cria uma SÉRIE recorrente numa só chamada (semanal/mensal/etc.). Exige due_date (vira a 1ª ocorrência). Cada ocorrência é uma tarefa independente (edite/exclua individualmente com astrea_tarefa_editar/_excluir). Bulk support: accepts case_ids, responsible_ids for batched execution.

  shallow
• astrea_tarefa_editar

  Edita uma TAREFA existente no Astrea (altera no lugar, sem duplicar). Informe ao menos um campo para mudar. - task_id: id da tarefa (retornado em astrea_tarefa_criar). - case_id: id do processo da tarefa (para localizá-la). - description / due_date (AAAA-MM-DD) / responsible_id (ver astrea_responsaveis): campos a alterar (omita os que não muda). Bulk support: accepts task_ids, case_ids, responsible_ids for batched execution.

  shallow
• astrea_tarefa_excluir

  Exclui uma TAREFA do Astrea. - task_id: id da tarefa (retornado em astrea_tarefa_criar). - case_id: id do processo da tarefa (para localizá-la). Bulk support: accepts task_ids, case_ids for batched execution.

  shallow
• authenticate

  MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

  shallow
• connect

  Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

  shallow
• marketplace

  The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

  shallow
• report_bug

  Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

  shallow
• show_version

  Show the current MCP platform and adapter versions.

  shallow
• toolkit_info

  Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/40d9e3d9-ae93-4b83-9ac2-39f0b6c85fde/badge.svg)](https://vouch.tools/servers/40d9e3d9-ae93-4b83-9ac2-39f0b6c85fde)