aicrm-mcp 0.2.1 → 0.3.0

package/README.md

@@ -26,12 +26,12 @@ Outros clientes:
 | `aicrm-mcp skill [install] [--project \| --dir <pasta>]` | Imprime ou instala o SKILL.md para agentes |
 | `aicrm-mcp` | Inicia o servidor MCP (stdio) |
 
-## Ferramentas (44)
+## Ferramentas (45)
 
 - **Leads**: `list_workspaces`, `search_leads`, `get_lead`, `create_lead`, `update_lead`, `move_lead`, `mark_won`, `mark_lost`, `reopen_lead`, `handoff_lead`, `add_note`, `bulk_update_leads`, `delete_lead`
 - **Importação**: `import_leads_csv` (`dry_run`, `columns`, `template_name`), `rename_import_template`, `delete_import_template`
 - **Campos**: `list_fields`, `create_field`, `update_field`, `archive_field`, `set_standard_fields`
-- **Metas**: `get_dashboard`, `get_forecast`, `get_goals`, `set_goals`, `list_commission_plans`, `save_commission_plan`, `delete_commission_plan`
+- **Metas**: `get_today_plan`, `get_dashboard`, `get_forecast`, `get_goals`, `set_goals`, `list_commission_plans`, `save_commission_plan`, `delete_commission_plan`
 - **Time e estrutura**: `list_users`, `invite_user`, `resend_invite`, `update_user`, `create_workspace`, `update_workspace`, `delete_workspace`, `create_funnel`, `update_funnel`, `delete_funnel`
 - **Operação**: `get_setup_status`, `create_tv_link`, `list_tv_links`, `revoke_tv_link`, `list_api_tokens`, `revoke_api_token`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aicrm-mcp",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "MCP server for AICRM — operate your CRM from Claude, Opencode and other MCP clients.",
   "type": "module",
   "bin": {

package/skill/aicrm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: aicrm
-description: Operar o AICRM (CRM de vendas) pelo MCP aicrm — consultar e atualizar leads e pipeline, importar planilhas CSV com mapeamento de colunas, campos personalizados por workspace, metas, comissões e previsões, time e permissões, funis, modo TV. Use sempre que a pessoa falar de leads, clientes em negociação, funil/pipeline, vendedores, metas, comissão, importação de contatos ou configuração do CRM, mesmo sem dizer "AICRM".
+description: Operar o AICRM (CRM de vendas) pelo MCP aicrm — consultar e atualizar leads e pipeline, plano do dia (o que fazer hoje para bater a meta), importar planilhas CSV com mapeamento de colunas, campos personalizados por workspace, metas, comissões e previsões, time e permissões, funis, modo TV. Use sempre que a pessoa falar de leads, clientes em negociação, funil/pipeline, vendedores, metas, comissão, importação de contatos ou configuração do CRM, mesmo sem dizer "AICRM".
 ---
 
 # AICRM via MCP
@@ -139,6 +139,7 @@ Como ler as respostas de erro:
 ### Metas, comissão e previsão
 | Ferramenta | Para quê |
 |---|---|
+| `get_today_plan` | **Plano do dia**: os 5–10 leads abertos que mais ajudam a bater a meta hoje, em ordem, cada um com o motivo (`why`) e a ação sugerida (WhatsApp, próximo passo ou mover de etapa). Padrão: quem está logado; admins passam `seller`. |
 | `get_dashboard` | Mês do funil: realizado vs meta do time e de cada vendedor, chance de bater, projeção, cobertura de pipeline, taxa de conversão, comissão. |
 | `get_forecast` | Detalhe de um vendedor: vai bater a meta? |
 | `get_goals` / `set_goals` | Ver/definir metas por vendedor e mês (`target: 0` remove). |
@@ -163,10 +164,11 @@ Como ler as respostas de erro:
 ## 6. Receitas
 
 ### Rotina do vendedor ("o que eu faço hoje?")
-1. `search_leads` com `filter: "mine"` e `status: "open"`.
-2. Depois `filter: "stale"` (parados) e `filter: "no_next_step"` (sem próximo passo) — são os que mais precisam de atenção.
-3. Para cada conversa: `add_note`, `update_lead` com `next_step` + `next_step_date`, `move_lead` se avançou.
-4. Resuma em poucas linhas: quantos abertos, valor total, os 3 mais urgentes e por quê.
+1. `get_today_plan` (com `funnel` se houver mais de um). Comece pelo `summary`: quanto falta para a meta e quanto a lista vale.
+2. Apresente os itens **na ordem**, um por linha: lead, o primeiro `why` em uma frase e a `suggested_action`. Não reordene — a ordem já considera chance, valor para a meta e urgência.
+3. WhatsApp: **entregue o link** (`https://wa.me/…`) para a pessoa abrir; você não envia mensagens.
+4. Depois de cada conversa: `add_note` com o que foi falado, `update_lead` com `next_step` + `next_step_date`, e `move_lead` se avançou. O lead sai da lista e vai para `done_today`.
+5. Chame `get_today_plan` de novo para ver o que falta. Para uma visão mais ampla, `search_leads` com `filter: "stale"` ou `"no_next_step"`.
 
 ### Importar uma planilha
 1. `import_leads_csv` com `dry_run: true`. Mostre à pessoa: colunas ligadas, colunas ignoradas e problemas.
@@ -208,6 +210,11 @@ Como ler as respostas de erro:
 - **win_rate_90d** com IC95%: taxa de conversão e a margem de incerteza; com `n` pequeno, trate como indicação, não certeza.
 - **low_confidence: true**: pouco histórico — diga que a previsão é preliminar.
 - Comissão: `current` é a de hoje; `projected` é a estimada se o ritmo continuar.
+- **Plano do dia** (`get_today_plan`):
+  - **chance**: probabilidade de o lead contar na meta — a % da etapa; em funis de "leads que chegaram à etapa", a chance de chegar à etapa‑alvo (pelo histórico do funil). Leads que já passaram da etapa‑alvo não aparecem: já contaram.
+  - **worth_for_goal**: valor × chance ("R$ 10.000 com 40% ≈ R$ 4.000"); **share_of_missing**: quanto isso representa do que falta.
+  - **Por que esta ordem**: chance × valor para a meta (no máximo o que falta) × urgência (passo atrasado ou marcado para hoje, parado há 14+ dias, data de fechamento passada ou dentro do mês, sem próximo passo). Leads com passo já marcado para outro dia ou previsão de fechar depois do mês descem na lista.
+  - **done_today**: leads em que o vendedor registrou algo hoje (nota, próximo passo, etapa, fechamento).
 
 ## 8. Problemas comuns