# Astrea (Aurum) MCP server

Reporting and queries over Astrea (Aurum), Brazilian legal-practice software: cases per client, cale

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-mcp-dir-astrea-mcp
- Repository: https://github.com/mcp-dir/astrea-mcp

## Install
- Endpoint: https://api.mcp.ai/p_astrea
- Auth: Not captured

## Setup notes
- Remote endpoint: https://api.mcp.ai/p_astrea

## Tools
- 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á. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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] Endpoint: https://api.mcp.ai/p_astrea
- 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] Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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). Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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] Endpoint: https://api.mcp.ai/p_astrea
- 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] Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- show_version - Show the current MCP platform and adapter versions. Endpoint: https://api.mcp.ai/p_astrea
- report_bug - Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- toolkit_info - Returns the current toolkit state: installed MCPs, their connection status, and how many catalog tools each exposes. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea
- 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. Endpoint: https://api.mcp.ai/p_astrea

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.mcp-dir
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 10, 2026
- Source: https://registry.modelcontextprotocol.io