# Astrea (Aurum) — MCP server on mcp.ai
> Relatórios e consultas no Astrea (Aurum), software jurídico: processos por cliente, agenda (audiências, reuniões, prazos, tarefas), processos novos por mês, etiquetas, financeiro (honorários/despesas) e andamentos dos processos para gerar relatórios ao cliente. Somente leitura. Autenticação por usuário + senha do Astrea (recomendado um usuário dedicado para a integração). API interna; sem API pública oficial.

By: mcp.ai · official
Page: https://mcp.ai/astrea

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_astrea?ms=1781045700000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/astrea/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/astrea/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/astrea/skill.md
Postman collection (v2.1): https://mcp.ai/astrea/postman.json

## Tools
- astrea_agenda_global(date_from: string, date_to: string) — Agenda do escritório no Astrea — audiências (HEARING), reuniões/eventos (EVENT), prazos (DEADLINE) e tarefas (TASK).
- astrea_agenda_por_cliente(date_from: string, date_to: string) — Agenda do escritório no Astrea — audiências (HEARING), reuniões/eventos (EVENT), prazos (DEADLINE) e tarefas (TASK).
- astrea_andamentos(case_id: string, only_manual?: boolean, limit?: integer, case_ids?: string[]) — Andamentos (timeline/histórico) de um processo no Astrea — base para gerar relatórios ao cliente.
- astrea_clientes(limit?: integer, cursor?: string) — 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.
- 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á.
- astrea_etiquetas() — Lista as etiquetas (tags) do Astrea — id, label, cor, restrictions (CASES/TASKS/APPOINTMENTS).
- astrea_financeiro_despesas(case_id: string, case_ids?: string[]) — Resumo financeiro de um processo no Astrea.
- astrea_financeiro_honorarios(case_id: string, case_ids?: string[]) — Resumo financeiro de um processo no Astrea.
- astrea_processos_count(contact_id?: string, tag_id?: string, status?: string, limit?: integer, cursor?: string, top_n?: integer, contact_ids?: string[], tag_ids?: string[]) — Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto.
- astrea_processos_list(contact_id?: string, tag_id?: string, status?: string, limit?: integer, cursor?: string, top_n?: integer, contact_ids?: string[], tag_ids?: string[]) — Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto.
- astrea_processos_novos_por_mes(contact_id?: string, tag_id?: string, status?: string, limit?: integer, cursor?: string, top_n?: integer, contact_ids?: string[], tag_ids?: string[]) — Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto.
- astrea_processos_por_cliente(contact_id?: string, tag_id?: string, status?: string, limit?: integer, cursor?: string, top_n?: integer, contact_ids?: string[], tag_ids?: string[]) — Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto.

## Example prompts
- "Quantos processos cada cliente tem comigo no Astrea?"
- "Quantos processos novos por mês neste ano?"
- "Liste as etiquetas do Astrea e os processos da etiqueta de êxito, com o valor"

## Links
Docs: https://mcp.ai/docs/mcps/astrea
Website: https://mcp.ai/mcps/astrea