# Astrea (Aurum) — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_astrea?ms=1781045280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `astrea_agenda_global`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/astrea`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/astrea/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/astrea/agenda/global` — Agenda do escritório no Astrea — audiências (HEARING), reuniões/eventos (EVENT), prazos (DEADLINE) e tarefas (TASK).
  - body: { date_from: string, date_to: string }
- `POST https://api.mcp.ai/api/astrea/agenda/por/cliente` — Agenda do escritório no Astrea — audiências (HEARING), reuniões/eventos (EVENT), prazos (DEADLINE) e tarefas (TASK).
  - body: { date_from: string, date_to: string }
- `POST https://api.mcp.ai/api/astrea/andamentos` — Andamentos (timeline/histórico) de um processo no Astrea — base para gerar relatórios ao cliente.
  - body: { case_id: string, only_manual?: boolean, limit?: integer, case_ids?: string[] }
- `POST https://api.mcp.ai/api/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.
  - body: { limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/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á.
- `POST https://api.mcp.ai/api/astrea/etiquetas` — Lista as etiquetas (tags) do Astrea — id, label, cor, restrictions (CASES/TASKS/APPOINTMENTS).
- `POST https://api.mcp.ai/api/astrea/financeiro/despesas` — Resumo financeiro de um processo no Astrea.
  - body: { case_id: string, case_ids?: string[] }
- `POST https://api.mcp.ai/api/astrea/financeiro/honorarios` — Resumo financeiro de um processo no Astrea.
  - body: { case_id: string, case_ids?: string[] }
- `POST https://api.mcp.ai/api/astrea/processos/count` — Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto.
  - body: { contact_id?: string, tag_id?: string, status?: string, limit?: integer, cursor?: string, top_n?: integer, contact_ids?: string[], tag_ids?: string[] }
- `POST https://api.mcp.ai/api/astrea/processos/list` — Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto.
  - body: { contact_id?: string, tag_id?: string, status?: string, limit?: integer, cursor?: string, top_n?: integer, contact_ids?: string[], tag_ids?: string[] }
- `POST https://api.mcp.ai/api/astrea/processos/novos/por/mes` — Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto.
  - body: { contact_id?: string, tag_id?: string, status?: string, limit?: integer, cursor?: string, top_n?: integer, contact_ids?: string[], tag_ids?: string[] }
- `POST https://api.mcp.ai/api/astrea/processos/por/cliente` — Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto.
  - body: { contact_id?: string, tag_id?: string, status?: string, limit?: integer, cursor?: string, top_n?: integer, contact_ids?: string[], tag_ids?: string[] }

## 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"

## More
- Page: https://mcp.ai/astrea
- Agent spec (llms.txt): https://mcp.ai/astrea/llms.txt
- Postman collection: https://mcp.ai/astrea/postman.json