--- name: astrea-mcp description: Skill da REST API do Astrea (Aurum) na MCP.AI: 12 endpoints em /api/astrea. 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. Autentique com workspace API key (sk_live) gerada em app.mcp.ai/settings/api-keys. Use quando o usuário pedir algo coberto pelos endpoints. --- # Astrea (Aurum) — REST API skill Você tem acesso à **Astrea (Aurum)** REST API na 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. ## Base URL ``` https://api.mcp.ai/api/astrea ``` Todo endpoint é um **POST** na Base URL + o path abaixo. Os parâmetros vão no corpo JSON. ## Autenticação Inclua em toda request: ``` Authorization: Bearer sk_live_... Content-Type: application/json ``` > Gere sua chave em **https://app.mcp.ai/settings/api-keys** (workspace API key `sk_live_…`, não expira, revogável). Uma única chave serve pra todos os seus MCPs. ## Formato de resposta ```json { "ok": true, "tool": "", "result": } ``` ## Exemplo cURL ```bash curl -X POST https://api.mcp.ai/api/astrea/agenda/global \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: application/json" \ -d '{"date_from":"...","date_to":"..."}' ``` ## Reportar problemas Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): **POST /api/astrea/report** com `{ "message": "...", "context"?: "...", "conversation"?: [...] }`. Isso notifica o time da MCP.AI. ## Endpoints (12) #### `astrea_agenda_global` Agenda do escritório no Astrea — audiências (HEARING), reuniões/eventos (EVENT), prazos (DEADLINE) e tarefas (TASK). _(POST /api/astrea/agenda/global)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `date_from` | string | Sim | Início, formato AAAAMMDD (ex.: 20260101) | | `date_to` | string | Sim | Fim, formato AAAAMMDD (ex.: 20261231) | #### `astrea_agenda_por_cliente` Agenda do escritório no Astrea — audiências (HEARING), reuniões/eventos (EVENT), prazos (DEADLINE) e tarefas (TASK). _(POST /api/astrea/agenda/por/cliente)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `date_from` | string | Sim | Início, formato AAAAMMDD (ex.: 20260101) | | `date_to` | string | Sim | Fim, formato AAAAMMDD (ex.: 20261231) | #### `astrea_andamentos` Andamentos (timeline/histórico) de um processo no Astrea — base para gerar relatórios ao cliente. _(POST /api/astrea/andamentos)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `case_id` | string | Sim | id do processo (ver astrea_processos) | | `only_manual` | boolean | Não | true = só andamentos manuais (exclui AUTOMATIC_*) | | `limit` | integer | Não | máximo de andamentos | | `case_ids` | string[] | Não | Bulk mode: multiple values for case_id | #### `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. _(POST /api/astrea/clientes)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `limit` | integer | Não | Itens por página | | `cursor` | string | Não | Cursor da página anterior (paginação); omita na 1ª página | #### `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 /api/astrea/conta)_ #### `astrea_etiquetas` Lista as etiquetas (tags) do Astrea — id, label, cor, restrictions (CASES/TASKS/APPOINTMENTS). _(POST /api/astrea/etiquetas)_ #### `astrea_financeiro_despesas` Resumo financeiro de um processo no Astrea. _(POST /api/astrea/financeiro/despesas)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `case_id` | string | Sim | id do processo | | `case_ids` | string[] | Não | Bulk mode: multiple values for case_id | #### `astrea_financeiro_honorarios` Resumo financeiro de um processo no Astrea. _(POST /api/astrea/financeiro/honorarios)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `case_id` | string | Sim | id do processo | | `case_ids` | string[] | Não | Bulk mode: multiple values for case_id | #### `astrea_processos_count` Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto. _(POST /api/astrea/processos/count)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `contact_id` | string | Não | list/count: filtrar pelos processos de um cliente (id do contato) | | `tag_id` | string | Não | list/count: filtrar por etiqueta (id; ver astrea_etiquetas) | | `status` | string | Não | Status do processo (Active, Archived) | | `limit` | integer | Não | list: itens por página | | `cursor` | string | Não | list: cursor da página anterior (paginação); omita na 1ª página | | `top_n` | integer | Não | por_cliente: limita aos N clientes com mais processos | | `contact_ids` | string[] | Não | Bulk mode: multiple values for contact_id | | `tag_ids` | string[] | Não | Bulk mode: multiple values for tag_id | #### `astrea_processos_list` Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto. _(POST /api/astrea/processos/list)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `contact_id` | string | Não | list/count: filtrar pelos processos de um cliente (id do contato) | | `tag_id` | string | Não | list/count: filtrar por etiqueta (id; ver astrea_etiquetas) | | `status` | string | Não | Status do processo (Active, Archived) | | `limit` | integer | Não | list: itens por página | | `cursor` | string | Não | list: cursor da página anterior (paginação); omita na 1ª página | | `top_n` | integer | Não | por_cliente: limita aos N clientes com mais processos | | `contact_ids` | string[] | Não | Bulk mode: multiple values for contact_id | | `tag_ids` | string[] | Não | Bulk mode: multiple values for tag_id | #### `astrea_processos_novos_por_mes` Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto. _(POST /api/astrea/processos/novos/por/mes)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `contact_id` | string | Não | list/count: filtrar pelos processos de um cliente (id do contato) | | `tag_id` | string | Não | list/count: filtrar por etiqueta (id; ver astrea_etiquetas) | | `status` | string | Não | Status do processo (Active, Archived) | | `limit` | integer | Não | list: itens por página | | `cursor` | string | Não | list: cursor da página anterior (paginação); omita na 1ª página | | `top_n` | integer | Não | por_cliente: limita aos N clientes com mais processos | | `contact_ids` | string[] | Não | Bulk mode: multiple values for contact_id | | `tag_ids` | string[] | Não | Bulk mode: multiple values for tag_id | #### `astrea_processos_por_cliente` Processos (casos) no Astrea. Respostas COMPACTAS pra economizar contexto. _(POST /api/astrea/processos/por/cliente)_ | Parâmetro | Tipo | Obrigatório | Descrição | |---|---|---|---| | `contact_id` | string | Não | list/count: filtrar pelos processos de um cliente (id do contato) | | `tag_id` | string | Não | list/count: filtrar por etiqueta (id; ver astrea_etiquetas) | | `status` | string | Não | Status do processo (Active, Archived) | | `limit` | integer | Não | list: itens por página | | `cursor` | string | Não | list: cursor da página anterior (paginação); omita na 1ª página | | `top_n` | integer | Não | por_cliente: limita aos N clientes com mais processos | | `contact_ids` | string[] | Não | Bulk mode: multiple values for contact_id | | `tag_ids` | string[] | Não | Bulk mode: multiple values for tag_id | --- Este MCP também funciona via **conexão MCP** (Claude / Cursor) em `https://api.mcp.ai/p_astrea` — veja o [README](../../README.md). A skill acima é pra consumir a **REST API** direto (agente próprio / código).