@lionchat/mcp-server 0.3.0 → 0.3.1

package/dist/docs/prompts/inactive_contacts.json

@@ -0,0 +1,23 @@
+{
+  "name": "inactive_contacts",
+  "title": "Contatos Inativos pra Reativação",
+  "description": "Identifica contatos sem interação há um tempo determinado, com sugestões de abordagem pra reativação.",
+  "arguments": [
+    {
+      "name": "days_inactive",
+      "description": "Dias sem interação (padrão: 30)",
+      "required": false
+    },
+    {
+      "name": "min_past_conversations",
+      "description": "Mínimo de conversas anteriores pra considerar (padrão: 1)",
+      "required": false
+    },
+    {
+      "name": "exclude_labels",
+      "description": "Labels pra excluir, separadas por vírgula (ex: 'spam,bot')",
+      "required": false
+    }
+  ],
+  "template": "Identifique contatos da conta que estão inativos há {{days_inactive|30}} dias ou mais.\n\nCritérios:\n- Tiveram pelo menos {{min_past_conversations|1}} conversa(s) anteriormente (mostra que já são leads ativos, não desconhecidos)\n- Última conversa marcada como `resolved` ou sem mensagens novas há {{days_inactive|30}}+ dias\n- Excluir contatos com labels: {{exclude_labels|none}}\n\nPra cada contato encontrado:\n1. Nome, telefone/email\n2. Última conversa (data, motivo do contato anterior se possível inferir)\n3. Canal favorito de contato (WhatsApp, Email, etc)\n4. Sugestão de abordagem personalizada:\n   - Se foi cliente: \"como pode ter ido com X que você comprou?\"\n   - Se foi lead frio: \"vimos seu interesse em Y, ainda faz sentido?\"\n   - Se foi pós-venda: \"vamos renovar?\" / \"feedback?\"\n\nApresentar no formato:\n- Resumo: X contatos identificados\n- Top 10 mais relevantes (priorizar valor histórico, segmento alto, label 'cliente')\n- Sugestão de mensagem template pra reativação em massa (se o usuário quiser, podemos criar campanha)"
+}

package/dist/docs/prompts/quality_audit.json

@@ -0,0 +1,28 @@
+{
+  "name": "quality_audit",
+  "title": "Auditoria de Qualidade do Atendimento",
+  "description": "Audita aleatoriamente conversas resolvidas pra checar qualidade: tempo de resposta, tom, resolução, follow-up.",
+  "arguments": [
+    {
+      "name": "period_days",
+      "description": "Quantos dias atrás analisar (padrão: 7)",
+      "required": false
+    },
+    {
+      "name": "sample_size",
+      "description": "Quantidade de conversas pra amostrar (padrão: 20)",
+      "required": false
+    },
+    {
+      "name": "agent_id",
+      "description": "Auditar agente específico (opcional)",
+      "required": false
+    },
+    {
+      "name": "inbox_id",
+      "description": "Auditar inbox específica (opcional)",
+      "required": false
+    }
+  ],
+  "template": "Faça uma auditoria de qualidade do atendimento nos últimos {{period_days|7}} dias.\n\nFiltros opcionais:\n- Agente: {{agent_id|todos}}\n- Inbox: {{inbox_id|todas}}\n\nAmostrar {{sample_size|20}} conversas RESOLVIDAS aleatoriamente desse período.\n\nPra cada conversa analisar:\n\n### Métricas Quantitativas\n- Tempo da primeira resposta (em minutos)\n- Tempo total de resolução\n- Número de mensagens trocadas\n- CSAT (se houver)\n- Foi reaberta depois? (indicador de problema mal resolvido)\n\n### Análise Qualitativa\n- Tom adequado? (formal/informal alinhado ao canal)\n- Cliente foi cumprimentado adequadamente?\n- Problema foi entendido na primeira interação?\n- Resposta foi clara e resolveu o problema?\n- Houve follow-up ou despedida adequada?\n- Erros gramaticais ou de português?\n\n### Red Flags a destacar\n- Tempo de primeira resposta > 30 min em horário comercial\n- Mais de 10 mensagens pra resolver questão simples\n- Resolução sem confirmação do cliente\n- Mensagens automáticas/copy-paste óbvios sem personalização\n- Tom inadequado (rude, robótico, condescendente)\n\n### Output\n\n## Sumário\n- Conversas auditadas: X\n- Qualidade Geral (1-10): Y\n- Tempo médio de primeira resposta\n- Taxa de reabertura\n\n## Top Problemas Encontrados\n(3-5 padrões recorrentes, com exemplos)\n\n## Top Boas Práticas Identificadas\n(2-3 exemplos pra replicar)\n\n## Recomendações\n- Treinamento focado em: ...\n- Templates de resposta padronizados pra: ...\n- Automações sugeridas: ...\n\nNão expor nomes de agentes em críticas públicas — apenas IDs em report interno."
+}

package/dist/docs/prompts/team_load_balance.json

@@ -0,0 +1,18 @@
+{
+  "name": "team_load_balance",
+  "title": "Carga e Balanceamento da Equipe",
+  "description": "Analisa distribuição de conversas entre agentes, identifica sobrecarregados e subutilizados.",
+  "arguments": [
+    {
+      "name": "period",
+      "description": "Período de análise: today, week, month (padrão: week)",
+      "required": false
+    },
+    {
+      "name": "team_id",
+      "description": "ID do time específico (opcional, se omitir analisa todos)",
+      "required": false
+    }
+  ],
+  "template": "Analise a carga de trabalho da equipe no período: {{period|week}}.\n\n{{team_id|Para todos os times.}}\nFiltrar por team_id={{team_id}} se especificado.\n\nDados a coletar pra cada agente:\n1. Conversas atribuídas (open + pending)\n2. Conversas resolvidas no período\n3. Tempo médio de primeira resposta\n4. Tempo médio de resolução\n5. % de conversas com CSAT (se houver)\n6. Status atual: online / offline / busy\n\nApresentar:\n\n## Visão Geral\n- Total de conversas ativas\n- Agentes online vs offline\n- Conversas sem atribuição (backlog)\n\n## Distribuição por Agente (tabela)\n| Agente | Ativas | Resolvidas | T. Resposta | T. Resolução | Status |\n\n## Identificar:\n- **Sobrecarregados**: > 1.5x média de conversas ativas → risco de queda na qualidade\n- **Subutilizados**: < 0.5x média → podem absorver mais\n- **Agentes offline com conversas pendentes**: redistribuir urgente\n- **Conversas órfãs**: sem assignee há > 1h → atribuir agora\n\n## Recomendações de ação\n- Lista de conversas pra reatribuir (com de → para)\n- Sugestão de revisão de assignment policy se houver desbalanceamento crônico\n- Conversas que talvez devam ser fechadas (sem resposta do cliente há > 7 dias)\n\nFinalizar perguntando se o usuário quer aplicar as redistribuições sugeridas."
+}

package/dist/docs/prompts/whatsapp_template_usage.json

@@ -0,0 +1,18 @@
+{
+  "name": "whatsapp_template_usage",
+  "title": "Uso e Performance de Templates WhatsApp",
+  "description": "Analisa quais templates WhatsApp estão sendo mais usados, eficácia, e templates aprovados mas sem uso.",
+  "arguments": [
+    {
+      "name": "inbox_id",
+      "description": "ID da inbox WhatsApp pra analisar (opcional, padrão: todas)",
+      "required": false
+    },
+    {
+      "name": "period_days",
+      "description": "Período em dias (padrão: 30)",
+      "required": false
+    }
+  ],
+  "template": "Analise o uso de templates WhatsApp Business nos últimos {{period_days|30}} dias.\n\nInbox: {{inbox_id|todas as inboxes WhatsApp Cloud}}\n\nDados a levantar:\n\n## 1. Inventário de Templates\n- Total de templates aprovados (status: APPROVED)\n- Pendentes de aprovação (PENDING)\n- Rejeitados (REJECTED) — listar motivos\n- Templates por categoria (UTILITY, MARKETING, AUTHENTICATION)\n- Templates por idioma\n\n## 2. Uso no Período\nPra cada template usado:\n- Nome do template\n- Quantas vezes foi enviado\n- Quantas conversas geraram resposta dentro de 24h\n- Taxa de resposta (% que responderam)\n- Taxa de conversão (se for marketing — virou venda/lead qualificado?)\n\n## 3. Templates Inativos\nListar templates aprovados HÁ MAIS DE 30 DIAS que NÃO foram usados no período.\n- Por quê? Esquecidos? Substituídos por novo?\n- Sugestão: arquivar / atualizar / promover uso\n\n## 4. Performance dos Top Templates\nTop 5 mais enviados — analisar:\n- Texto do template\n- Taxa de resposta\n- Tempo médio até resposta\n- Tem variáveis personalizadas? ({{nome}}, etc)\n- Categoria correta? (errar categoria = risco de banimento)\n\n## 5. Red Flags\n- Templates marketing sendo usados em janela 24h (deveriam ser utility)\n- Templates rejeitados não removidos\n- Templates aprovados há > 90 dias e nunca usados\n- Templates duplicados (mesma intenção, várias versões)\n\n## Recomendações\n- Templates a criar (gap identificado)\n- Templates a remover (desuso ou redundância)\n- Templates a otimizar (baixa conversão)\n- Sugestão de A/B test entre 2 versões de um mesmo template\n\nFinalizar com sugestão de criar nova campanha usando o template com melhor performance."
+}

package/dist/docs/resources/best-practices.md

@@ -0,0 +1,166 @@
+# Boas Práticas — Uso Eficiente do MCP
+
+Como usar o MCP do LionChat sem desperdiçar tokens, sem cair em rate limits, e com respostas precisas.
+
+## Princípio geral: liste resumido, leia detalhado quando precisar
+
+Errado: pegar TODAS conversas + TODAS mensagens de cada uma logo de cara.
+
+Certo:
+1. `conversations_list` com filtros e `page=1` (paginado) → vê IDs + última mensagem
+2. Identifica candidatas (5-10 conversas)
+3. `conversations_messages_list` SÓ para as relevantes
+
+Resultado: 10x menos tokens.
+
+## Use filtros sempre que possível
+
+A maioria dos endpoints aceita parâmetros pra filtrar antes de retornar:
+
+| Endpoint | Filtros úteis |
+|---|---|
+| `conversations_list` | `status` (open/resolved), `assignee_type`, `inbox_id`, `team_id`, `labels`, `q` (busca) |
+| `contacts_list` | `q` (nome/email/telefone), `include_contact_inboxes` |
+| `messages_search` | `q`, `conversation_id`, `before`, `after` |
+| `kanban_items_list` | `funnel_id`, `funnel_stage`, `assigned_agent_id` |
+| `reports_list_*` | `since`, `until`, `metric`, `type` |
+
+**Dica:** sempre filtre por período (`since`/`until`) em relatórios — sem isso pode trazer anos de histórico.
+
+## Paginação
+
+Endpoints listáveis paginam em geral 25 itens. Use `page` parameter:
+
+```
+page=1 → primeiros 25
+page=2 → próximos 25
+```
+
+Pra contar total, use `meta.total_count` (vem no response). Não tente "paginar até zerar" se já tem o total — pode ser milhões.
+
+## Cache local mental
+
+Quando ler dados que provavelmente não mudam na sessão:
+- Lista de inboxes
+- Lista de agentes
+- Lista de times
+- Custom attribute definitions
+- Funnels
+
+Faça UMA chamada e use a info por toda a conversa. NÃO refaça `agents_list` 10x.
+
+## Use endpoints específicos > endpoints genéricos
+
+Quando existir endpoint específico, prefira:
+
+| Errado | Certo |
+|---|---|
+| `reports_list` filtrando manualmente | `reports_list_2` (já é "conversations_metrics") |
+| `conversations_list` + filtro de unread no cliente | `conversations_list` com `assignee_type=me&status=open` |
+| `messages_list` percorrendo conversas | `conversations_messages_search` com `q=...` |
+
+## Economia em conversas com muitas mensagens
+
+Conversa com 200 mensagens? **Não baixe tudo**:
+
+1. `conversations_show` (1 chamada) → metadata + última mensagem
+2. Se precisa contexto: pegue só as últimas 20-30 mensagens com `before` ou `page`
+3. Pra análise completa, use `conversations_transcript` (formato condensado)
+
+## Operações em massa
+
+Pra atribuir labels, mover cards, etc em vários itens:
+- `kanban_bulk_bulk_actions` (cards Kanban)
+- `kanban_items_kanban_agents_create` em massa (passar array)
+- `automation_rules_*` (criar regras em vez de fazer manualmente)
+
+NÃO faça 50 PATCH requests individuais — bate rate limit.
+
+## Rate limiting
+
+LionChat tem rate limit por API token. Limites típicos:
+- ~500 req/min para read
+- ~100 req/min para write
+
+Se receber `429 Too Many Requests`:
+- Espere o `Retry-After` header
+- Reduza concorrência
+- Reavalie estratégia (provavelmente está fazendo loop ineficiente)
+
+## Quando NÃO usar IA pra escrever mensagens
+
+- Mensagens de cobrança / financeiras → use templates aprovados
+- Confirmação de venda → template + variáveis
+- Comunicação legal → revisão humana obrigatória
+
+IA é boa pra: triagem, classificação, resumo, sugestão de resposta, análise.
+
+## Variáveis de conta (account_variables)
+
+Pra dados que se repetem (slogans, endereços, horários):
+- `account_variables_create` UMA vez
+- Use em templates com `{{slogan}}`, `{{endereco}}`
+- Atualiza UMA vez, propaga pra todo lugar
+
+Nunca hard-code esses dados em respostas geradas.
+
+## Status codes a respeitar
+
+| Code | O que fazer |
+|---|---|
+| 200/201 | OK, processar resposta |
+| 204 | OK, sem corpo (típico de DELETE) |
+| 400 | Erro de input — leia mensagem e ajuste |
+| 401 | Token inválido/expirado — NÃO retry |
+| 403 | Sem permissão — não tente bypass |
+| 404 | Recurso não existe — talvez foi deletado |
+| 422 | Validação falhou — leia errors[] |
+| 429 | Rate limited — espere e retry |
+| 500/502/503 | Servidor — retry 1-2x com backoff |
+
+## Ordem de operações típicas
+
+### "Buscar todas conversas de um cliente específico"
+1. `contacts_search` com `q=email` → pega contact_id
+2. `contacts_show` com `include=conversations` OU
+3. Filter conversations: `conversations_list` com `q=email`
+
+### "Criar um card Kanban a partir de uma conversa"
+1. `funnels_list` → pegar funnel_id certo
+2. `kanban_items_create` com `funnel_id`, `funnel_stage` (geralmente primeira etapa), `conversation_display_id`
+3. Opcional: `item_details.value`, `assigned_agents`
+
+### "Resumir performance da equipe na semana"
+1. `agents_list` → IDs dos agentes
+2. `reports_list_*` (agent_overview) com `since=7d_ago`, `until=now`
+3. Sintetize: agente X com Y resoluções, tempo médio Z
+
+## Cuidados com tools de criação
+
+Endpoints `create_*` modificam dados reais. Antes de chamar:
+- Confirme com usuário (se inicialmente pediu "ver", não "fazer")
+- Verifique se o recurso já existe (evite duplicatas)
+- Use `dry_run` quando disponível
+
+## Erros comuns a evitar
+
+| Erro | Como evitar |
+|---|---|
+| Loop infinito de `page+1` | Sempre cheque `meta.total_count` e pare |
+| Re-listar inboxes 20x | Cache mental |
+| Mandar `conversations_messages_create` sem `message_type` | Sempre setar `incoming`/`outgoing` |
+| Listar TODAS contas de um agente direto | Use filter `q=nome` primeiro |
+| Esquecer de filtrar por `account_id` | Multi-tenant — sempre escopar |
+
+## Quando agir vs quando perguntar
+
+Aja sem perguntar:
+- Listagem, filtro, busca, leitura
+- Sumarização, classificação
+- Sugestão de próximos passos
+
+Pergunte primeiro:
+- Criar / atualizar / deletar dados
+- Enviar mensagem pra cliente
+- Mudar status de várias conversas em massa
+- Alterar configuração de conta/inbox

package/dist/docs/resources/conversation-flows.md

@@ -0,0 +1,208 @@
+# Fluxos de Conversação
+
+Como conversas atravessam o LionChat: criação, auto-assignment, IA, automações, resolução. Use quando precisar entender ou diagnosticar comportamento de conversações.
+
+## Ciclo de vida de uma conversa
+
+```
+                          [Cliente envia 1ª msg]
+                                  │
+                                  ▼
+                    ┌──────────────────────────┐
+                    │ ContactInbox criado/      │
+                    │  encontrado por source_id │
+                    └─────────┬────────────────┘
+                              ▼
+                    ┌──────────────────────────┐
+                    │  Conversation.create     │
+                    │  status: 0 (open)        │
+                    └─────────┬────────────────┘
+                              ▼
+                  ┌───────────────────────────┐
+                  │ Greeting (se ativo)       │ → Message outgoing
+                  └─────────┬─────────────────┘
+                            ▼
+                  ┌───────────────────────────┐
+                  │ AutomationRule:            │
+                  │ "conversation_created"     │
+                  └─────────┬─────────────────┘
+                            ▼
+                  ┌───────────────────────────┐
+                  │ Auto-assignment:           │
+                  │ - team OU agent           │
+                  │ - via policy ou simples   │
+                  └─────────┬─────────────────┘
+                            ▼
+                  ┌───────────────────────────┐
+                  │ Captain (IA) Agent:        │
+                  │ se atribuído              │
+                  │ → debounce → LLM response │
+                  └─────────┬─────────────────┘
+                            ▼
+                  ┌───────────────────────────┐
+                  │ Conversa ativa             │
+                  │ (status: open)            │
+                  └─────────┬─────────────────┘
+                            ▼
+              [Agente humano ou IA atende ↔ cliente]
+                            │
+                    ┌───────┴────────┐
+                    ▼                ▼
+            [resolvida]      [adiada]
+            status: 1        status: 3
+                    │                │
+                    │                └──→ desnooze automático
+                    ▼
+              ┌───────────────────────────┐
+              │ Pós-resolução:             │
+              │ - Captain memory + FAQ    │
+              │ - Reporting events        │
+              │ - Automation rules        │
+              │ - CSAT survey send        │
+              └────────────────────────────┘
+```
+
+## Etapas detalhadas
+
+### 1. Criação da conversa
+
+Mensagem chega via webhook do canal (WAHA, WhatsApp Cloud, Email, etc) → `Webhook::IncomingMessageJob` ou similar → `IncomingMessageService` → cria/encontra `Contact`, `ContactInbox`, `Conversation`, `Message`.
+
+**Pontos importantes:**
+- `Conversation` sempre criada com `status = 0` (open)
+- `inbox_id` setado direto
+- `assignee_id` começa `null` (pendente atribuição)
+- `captain_assistant_id` começa `null` (a menos que automação atribua)
+
+### 2. Greeting (mensagem de boas-vindas)
+
+Se `inbox.greeting_enabled = true`:
+- Após criar a conversa, envia `inbox.greeting_message`
+- Vira `Message` outgoing automática
+- NÃO substitui resposta humana — só inicia a conversa
+
+### 3. AutomationRule: "conversation_created"
+
+Cada inbox/conta pode ter regras com `event_name: 'conversation_created'`. Elas rodam **antes** do auto-assignment.
+
+Ações comuns:
+- Atribuir agente/time específico
+- Adicionar labels
+- Marcar prioridade
+- Atribuir Captain Assistant (`captain_assistant_id`)
+
+Avaliação:
+- Condições combinadas com AND
+- Operadores: `equal_to`, `contains`, `includes`, `is_present`
+- Pode usar `inbox`, `content`, `country_code`, `email`, custom_attributes
+
+### 4. Auto-assignment
+
+Roda após automation rules. Lógica simplificada:
+
+```
+SE inbox.enable_auto_assignment_v2:
+  SE inbox.assignment_policy associada:
+    → Política decide (round-robin, balanced, etc)
+  SENAO:
+    → assignee_id fica null (manual)
+```
+
+V2 (Assignment Policy) é o motor moderno. V1 (campo `auto_assignment` simples) é legado.
+
+### 5. Captain (IA Agente)
+
+Se `captain_assistant_id` foi setado (manual ou via automação):
+- Mensagem incoming dispara `Captain::ResponseBuilderJob`
+- Job tem **debounce** (~10s) — agrupa mensagens em rajada
+- Chama LLM com prompt do assistant + histórico
+- LLM pode invocar tools (FAQ, update_contact, create_booking, etc)
+- Resposta vira `Message` outgoing com `sender_type: Captain::Assistant`
+
+**Quando IA é desativada manualmente:**
+- Agente clica em "Desativar AI" → `captain_assistant_id` vira null
+- `custom_attributes.captain_manually_disabled = true`
+- IA não responde mais nessa conversa (mesmo se nova msg)
+
+### 6. Estado "pending" (status 2)
+
+Conversa em "pending" significa "aguardando algo":
+- Cliente respondeu mas agente ainda não viu
+- OU agente respondeu e tá aguardando cliente
+- Geralmente movida automaticamente por automação ("se 24h sem resposta → pending")
+
+### 7. Resolução (status 1)
+
+Agente clica em "Resolver":
+- `status` → 1 (resolved)
+- `resolved_at` setado
+- Dispara `conversation_resolved` event
+- Listeners agem:
+  - `CaptainListener`: gera memory + FAQ se IA atendeu
+  - `HookListener`: dispara webhooks
+  - `AutomationRuleListener`: regras de `conversation_resolved`
+  - `ReportingEventListener`: salva métricas
+  - `CsatSurveyJob` (se config ativa): envia pesquisa CSAT
+
+### 8. Snoozed (status 3)
+
+Adia conversa:
+- `status` → 3 (snoozed)
+- `snoozed_until` setado (datetime futuro)
+- Job periódico `ReopenSnoozedConversationsJob` roda e reabre quando passa do `snoozed_until`
+
+### 9. Reopen
+
+Conversa resolvida que recebe nova mensagem do cliente:
+- Comportamento depende de config `inbox.lock_to_single_conversation`
+- Default: cria NOVA conversa (mantém histórico)
+- Se locked: reabre a mesma conversa (`status` volta a 0)
+
+## Estado relacional
+
+```
+Conversation
+  ├─ messages: array em ordem cronológica
+  ├─ contact: quem é o cliente
+  ├─ inbox: canal de origem
+  ├─ assignee: agente humano atual (null OK)
+  ├─ team: time atribuído (null OK)
+  ├─ captain_assistant: IA atribuída (null OK)
+  ├─ kanban_item: card vinculado (null OK)
+  └─ labels: tags aplicadas
+```
+
+## Como diagnosticar problemas
+
+### "Conversa não atribuiu ninguém"
+
+1. `inbox.enable_auto_assignment_v2` está true?
+2. `inbox.assignment_policy` está setado?
+3. Tem `InboxMember` ativos pra essa inbox?
+4. Tem `automation_rule` que poderia ter atribuído antes?
+
+### "IA não respondeu"
+
+1. `conversation.captain_assistant_id` está setado?
+2. Account tem OpenAI hook configurado?
+3. Captain feature ativa na conta? (`feature_captain_integration`)
+4. Custom attr `captain_manually_disabled = true`?
+5. Sidekiq job `Captain::ResponseBuilderJob` rodou? Tem erro no log?
+
+### "Conversa marcada como pending sem motivo"
+
+1. Tem automation rule com `event_name: conversation_updated` ou similar?
+2. Tem SLA policy ativando state change?
+3. Veio de external API call?
+
+## Eventos importantes (pra automation)
+
+| Evento | Quando dispara |
+|---|---|
+| `conversation_created` | Nova conversa |
+| `conversation_opened` | Status volta pra open (reabertura) |
+| `conversation_resolved` | Agente resolve |
+| `conversation_pending` | Status muda pra pending |
+| `conversation_updated` | Qualquer update |
+| `message_created` | Nova mensagem (incoming ou outgoing) |
+| `first_reply_created` | Primeira resposta humana |

package/dist/docs/resources/kanban-deep-dive.md

@@ -0,0 +1,295 @@
+# Kanban — Guia Profundo
+
+Tudo sobre o módulo Kanban/CRM do LionChat: funis, etapas, cards, valor, automações, integrações com conversação.
+
+## Estrutura
+
+### Funnel (Funil)
+Container de etapas. Conta pode ter vários funis (ex: "Vendas", "Pós-venda", "Renovação").
+
+| Campo | Descrição |
+|---|---|
+| `id` | Identificador |
+| `name` | Nome do funil (ex: "Vendas B2B") |
+| `description` | Descrição livre |
+| `stages` | jsonb com etapas (ver abaixo) |
+| `archived` | Boolean — funis arquivados não aparecem na UI ativa |
+| `active` | Boolean — controla se aceita movimentação |
+| `settings` | jsonb — config customizada (ex: cores, automações) |
+
+### Stages (Etapas) — dentro de `funnel.stages`
+
+Stages NÃO são tabela separada. São armazenadas como jsonb dentro do Funnel:
+
+```json
+{
+  "novo_lead": {
+    "name": "Novo Lead",
+    "color": "#3B82F6",
+    "position": 1,
+    "description": "Lead ainda não qualificado"
+  },
+  "qualificado": {
+    "name": "Qualificado",
+    "color": "#10B981",
+    "position": 2,
+    "description": "Lead com interesse confirmado"
+  },
+  "ganho": {
+    "name": "Ganho",
+    "color": "#22C55E",
+    "position": 99
+  },
+  "perdido": {
+    "name": "Perdido",
+    "color": "#EF4444",
+    "position": 100
+  }
+}
+```
+
+### KanbanItem (Card)
+Um card individual dentro de uma etapa.
+
+| Campo | Descrição |
+|---|---|
+| `id` | Identificador |
+| `funnel_id` | Funil ao qual pertence |
+| `funnel_stage` | Chave da etapa (ex: `"novo_lead"`) |
+| `position` | Ordem dentro da etapa |
+| `stage_entered_at` | Quando entrou na etapa atual (pra métrica de tempo) |
+| `conversation_display_id` | Conversa principal vinculada |
+| `linked_conversations` | jsonb array `[{display_id: 123}, {display_id: 456}]` — múltiplas conversas |
+| `item_details` | jsonb (ver abaixo) |
+| `custom_attributes` | jsonb — campos custom (igual contatos) |
+| `assigned_agents` | jsonb array de agentes responsáveis |
+| `activities` | jsonb array — log de atividades |
+| `checklist` | jsonb array de tarefas dentro do card |
+| `timer_started_at`, `timer_duration` | Timer interno do card |
+
+### item_details (detalhes do card)
+
+```json
+{
+  "title": "Cliente XYZ - Plano Pro",
+  "value": 5000.0,
+  "priority": "high",
+  "description": "Cliente interessado em upgrade",
+  "notes": [
+    {"text": "Ligou pedindo proposta", "created_at": "2026-05-15T10:00:00Z"}
+  ],
+  "offers": [
+    {"id": 12, "title": "Pro 12 meses", "value": 4800}
+  ],
+  "custom_attributes": {
+    "origem_lead": "Facebook Ads"
+  }
+}
+```
+
+**`value`** é onde fica o valor monetário do negócio (usado em pipelines).
+
+### assigned_agents
+
+```json
+[
+  {
+    "id": 5,
+    "name": "Maria Souza",
+    "email": "maria@empresa.com",
+    "avatar_url": "https://...",
+    "assigned_at": "2026-05-14T09:00:00Z",
+    "assigned_by": 1,
+    "source": "manual"
+  }
+]
+```
+
+Múltiplos agentes podem ter o mesmo card. `source` pode ser `manual`, `automation`, `inherited_from_conversation`.
+
+### linked_conversations — IMPORTANTE
+
+```json
+[{"display_id": 123}, {"display_id": 456}]
+```
+
+**NUNCA gravar inteiros direto** — sempre objetos com `{display_id: ...}`. Inteiros diretos causam TypeError no `as_json`.
+
+## Posição (ordering)
+
+Cada KanbanItem tem `position` (integer). Cards ordenados ASC dentro da etapa.
+
+Reordenação:
+- API endpoint: `POST /api/v2/kanban/items/reorder`
+- Recebe array com nova ordem `[{id: 5, position: 1}, {id: 8, position: 2}]`
+- Recalcula `position` em todas as etapas afetadas
+
+Mover entre etapas:
+- API endpoint: `POST /api/v2/kanban/items/{id}/move`
+- Body: `{funnel_stage: "qualificado", position: 1}`
+- Atualiza `funnel_stage`, `stage_entered_at`, e `position`
+
+## Atividades (activities)
+
+Log automático de eventos do card:
+
+```json
+[
+  {
+    "type": "stage_changed",
+    "from": "novo_lead",
+    "to": "qualificado",
+    "by_user_id": 1,
+    "at": "2026-05-15T10:00:00Z"
+  },
+  {
+    "type": "agent_assigned",
+    "agent_id": 5,
+    "by_user_id": 1,
+    "at": "2026-05-15T10:01:00Z"
+  },
+  {
+    "type": "note_added",
+    "note_id": 42,
+    "by_user_id": 5,
+    "at": "2026-05-15T10:05:00Z"
+  }
+]
+```
+
+Tipos comuns: `created`, `stage_changed`, `agent_assigned`, `agent_removed`, `note_added`, `value_changed`, `priority_changed`, `archived`.
+
+## Checklist (tarefas dentro do card)
+
+```json
+[
+  {
+    "id": "abc-123",
+    "title": "Enviar proposta por email",
+    "checked": true,
+    "completed_at": "2026-05-15T10:00:00Z",
+    "completed_by": 5
+  },
+  {
+    "id": "abc-124",
+    "title": "Agendar follow-up",
+    "checked": false
+  }
+]
+```
+
+Útil pra workflows internos. Não confundir com `tasks` (que é módulo separado de tarefas globais).
+
+## Pipeline (visão por valor)
+
+Pipeline = soma de `item_details.value` agrupado por etapa.
+
+Exemplo:
+```
+Funil "Vendas"
+├── Novo Lead: 12 cards | R$ 47.000
+├── Qualificado: 8 cards | R$ 38.000
+├── Negociação: 3 cards | R$ 22.000
+├── Ganho: 5 cards | R$ 28.000 (fechados no mês)
+└── Perdido: 2 cards | R$ 4.000
+```
+
+Endpoint: `GET /api/v2/kanban/items/counts` retorna contagem + soma por etapa.
+
+## Funil arquivado vs ativo
+
+- `archived = true`: funil escondido da UI principal. Cards ainda existem mas não aparecem nas listas
+- `active = false`: bloqueia movimentação (modo "somente leitura")
+
+Use cases:
+- Arquivar funis antigos no fim do ano
+- Pausar funil em manutenção sem deletar cards
+
+## Integração com Conversation
+
+### Quando uma conversa vincula a um card
+- Manual via UI ("vincular ao Kanban")
+- Automação via `automation_rule.actions` com action `add_to_kanban`
+- API call em `POST /api/v2/kanban/items` com `conversation_display_id`
+
+### Como o card "sabe" sobre o cliente
+
+```
+KanbanItem
+  └─ conversation_display_id → Conversation
+                                  └─ contact → Contact (nome, telefone, email)
+```
+
+NÃO existe `contact_id` direto no KanbanItem. Sempre via conversation_display_id.
+
+### Múltiplas conversas no mesmo card
+
+`linked_conversations` permite agrupar várias conversas (ex: cliente que falou em WhatsApp e Email):
+
+```json
+[
+  {"display_id": 100},
+  {"display_id": 101},
+  {"display_id": 105}
+]
+```
+
+A `conversation_display_id` (singular) ainda é a "principal" — mas todas as `linked_conversations` aparecem na sidebar do card.
+
+## Automações relacionadas a Kanban
+
+AutomationRule com evento `kanban_item_created`, `kanban_item_moved`, `kanban_item_stage_changed`:
+
+```json
+{
+  "event_name": "kanban_item_moved",
+  "conditions": [
+    {"attribute_key": "funnel_stage", "operator": "equal_to", "value": "ganho"}
+  ],
+  "actions": [
+    {"action_name": "send_message", "params": ["Parabéns pelo fechamento!"]},
+    {"action_name": "add_label", "params": ["cliente-pagante"]}
+  ]
+}
+```
+
+## Bulk operations
+
+- `POST /api/v2/kanban/items/bulk_actions` — operações em massa (mover, atribuir, arquivar)
+- `POST /api/v2/kanban/items/import` — importar CSV de cards
+- `GET /api/v2/kanban/items/export` — exportar funil completo
+
+## Custom attributes em cards
+
+Igual contatos, cards têm `custom_attributes` (jsonb):
+
+```json
+{
+  "origem_lead": "Google Ads",
+  "campanha": "Black Friday 2026",
+  "score": 85,
+  "produto_interesse": "Plano Pro"
+}
+```
+
+Configurar atributos no Super Admin ou via API `/api/v1/custom_attribute_definitions`.
+
+## Métricas úteis (via GET /api/v2/kanban/items)
+
+- Tempo médio em cada etapa: `stage_entered_at` vs agora
+- Taxa de conversão: cards em "ganho" vs total criado no período
+- Pipeline ativo: soma de `value` em etapas != ganho/perdido
+- Velocity: cards movidos pra "ganho" por mês
+
+## Diagnóstico: "Card sumiu do funil"
+
+1. Está arquivado? `archived = true` em algum nível?
+2. Etapa atual existe ainda? (etapa removida do funil deixa card "órfão")
+3. `position` está faltando? (cards sem position vão pro fim)
+4. Está em outro funil? (mover entre funis muda `funnel_id`)
+
+## Diagnóstico: "Valor do pipeline errado"
+
+1. Algum card sem `item_details.value`?
+2. Cards arquivados estão sendo contados?
+3. Etapas "ganho"/"perdido" estão incluídas no cálculo?

package/dist/docs/resources/troubleshooting.md

@@ -0,0 +1,248 @@
+# Troubleshooting — Códigos de Erro Comuns
+
+Como interpretar e responder a erros do MCP do LionChat.
+
+## HTTP Status Codes
+
+### 200 OK / 201 Created
+Tudo certo. Use o body.
+
+### 204 No Content
+Sucesso, mas sem corpo. Comum em DELETE e algumas updates. NÃO espere JSON de volta.
+
+### 400 Bad Request
+Input malformado. Causas comuns:
+- JSON inválido
+- Campo obrigatório faltando
+- Tipo errado (passou string onde esperava number)
+
+**Ação:** Releia a mensagem de erro. Corrija o payload. NÃO retry sem mudar nada.
+
+### 401 Unauthorized
+Token de API inválido ou expirado.
+
+**Ação:** Parar. Reportar pro usuário que precisa renovar credenciais. NÃO retry — vai falhar igual.
+
+### 403 Forbidden
+Token válido, mas SEM permissão pra essa ação.
+
+Causas:
+- Agente tentando ação de admin
+- Conta diferente do escopo do token
+- Feature flag desativada na conta
+- Recurso pertence a outra conta (multi-tenant)
+
+**Ação:** NÃO bypass. Informar limitação ao usuário.
+
+### 404 Not Found
+Recurso não existe.
+
+Causas comuns:
+- ID errado
+- Recurso foi deletado
+- Está em outra conta
+- Endpoint URL errado
+
+**Ação:** Verificar se ID está correto. Se foi deletado, informar.
+
+### 422 Unprocessable Entity
+Dados passaram na sintaxe mas falharam validação.
+
+Exemplo de response:
+```json
+{
+  "errors": {
+    "email": ["já está em uso"],
+    "phone_number": ["formato inválido"]
+  }
+}
+```
+
+**Ação:** Ler `errors`, ajustar dados, reenviar.
+
+### 429 Too Many Requests
+Rate limit estourado.
+
+Response inclui header `Retry-After: 60` (segundos).
+
+**Ação:**
+- Esperar o tempo indicado
+- Reduzir concorrência
+- Avaliar se está fazendo loop ineficiente
+
+NÃO retry imediato — só piora.
+
+### 500 Internal Server Error
+Erro do servidor LionChat.
+
+**Ação:**
+- Retry 1x após 2-5 segundos
+- Se persiste, reportar pro usuário com timestamp/request ID
+
+### 502 Bad Gateway / 503 Service Unavailable
+Indisponibilidade temporária (deploy, manutenção, sobrecarga).
+
+**Ação:** Retry com backoff exponencial (2s, 4s, 8s). Máx 3 tentativas.
+
+### 504 Gateway Timeout
+Operação demorou demais.
+
+Causas:
+- Query muito pesada (sem filtro)
+- Export grande (use exports assíncronos)
+
+**Ação:** Reformular a chamada com filtros mais agressivos.
+
+## Erros específicos do MCP
+
+### "mcp_not_enabled"
+Status: 403
+
+A conta não tem a feature MCP habilitada.
+
+**Ação:** Pedir admin pra ativar no plano ou via Super Admin.
+
+### "admin_required"
+Status: 403
+
+Só administradores podem usar essa funcionalidade.
+
+**Ação:** Usuário com role `agent` precisa pedir pro admin.
+
+### "invalid_account"
+Status: 400 ou 404
+
+`account_id` não pertence ao usuário autenticado.
+
+**Ação:** Listar contas do user (`list_my_accounts`) e usar uma válida.
+
+### "feature_disabled"
+Status: 403
+
+Feature flag específica (ex: `feature_kanban`, `feature_captain`) está OFF.
+
+**Ação:** Reportar qual feature precisa ser ativada.
+
+## Erros de validação comuns
+
+### Conversation
+- `"contact must exist"` — passou `contact_id` inválido
+- `"inbox must exist"` — `inbox_id` errado
+- `"status invalid"` — use 0, 1, 2 ou 3 (open/resolved/pending/snoozed)
+
+### Contact
+- `"email has already been taken"` — duplicado na conta
+- `"phone_number has already been taken"` — mesmo problema
+- `"phone_number must be a valid number with country code"` — formato E.164: `+5511999999999`
+
+### Message
+- `"content can't be blank"` — mensagem vazia (use template se for attachment-only)
+- `"private must be boolean"` — true/false, não string
+
+### KanbanItem
+- `"funnel_stage does not exist in funnel"` — etapa inválida pro funil
+- `"conversation_display_id must exist"` — conversa não existe ou foi deletada
+- `"position must be a positive integer"` — não pode ser negativo
+
+## Cenários problemáticos
+
+### "Estou recebendo 401 mesmo com token correto"
+Possíveis causas:
+- Token foi revogado
+- Conta foi suspensa (`feature_account_suspended`)
+- Token de outra conta
+
+Verificar: `GET /api/v1/profile` (se 401 aqui, token tá inválido)
+
+### "GET retorna 200 mas POST/PATCH retorna 403"
+Token tem `scope: read` apenas. Precisa de token com scope completo pra escritas.
+
+### "Operação foi pelo MCP mas não aparece na UI"
+- Frontend pode estar com cache (refresh)
+- WebSocket pode estar caído
+- Pode ter sido criado em outra conta (verificar `account_id`)
+
+### "Timer/job rodou mas dados estão errados"
+Sidekiq pode estar retry-ando. Verificar:
+- Job tem `discard_on` apropriado?
+- Status final no banco vs UI
+
+### "Tool não está disponível"
+Possíveis razões:
+- MCP server não foi atualizado (`npm install -g @lionchat/mcp-server@latest`)
+- Feature flag bloqueando endpoint
+- Plano do cliente não inclui a feature
+
+### "Rate limit constante"
+Padrões que causam:
+- Polling agressivo (use webhooks)
+- Listar tudo sem paginar
+- Não cache de dados estáticos
+- Loop sem `break` apropriado
+
+## Webhooks como alternativa a polling
+
+Se você precisa monitorar mudanças em conversas/mensagens, NÃO faça polling:
+
+```
+Polling errado:
+  while True: GET /conversations every 5s → MUITO ruim
+```
+
+Use webhooks (config na conta):
+- `conversation_created`
+- `message_created`
+- `conversation_resolved`
+- Etc
+
+LionChat envia POST pro seu endpoint quando o evento dispara.
+
+## OAuth (apenas MCP Remote)
+
+### "invalid_client_metadata"
+Cliente OAuth registrado errado. Verifique:
+- `token_endpoint_auth_method` = `none` (pra Claude/ChatGPT)
+- `redirect_uris` exato (https, sem trailing slash extra)
+
+### "invalid_grant"
+Auth code expirou (vida curta — segundos). Refazer login.
+
+### "Conector desconectou sozinho"
+Geralmente: refresh_token expirou (TTL passou).
+
+Hoje no LionChat: TTL é ~100 anos. Se desconectar, provavelmente:
+- Token revogado manualmente
+- Conta suspensa
+- Restart do serviço MCP Remote
+
+### "Consent loop infinito"
+Bug conhecido: `Grant` não criado explicitamente. Atualizar MCP Remote pra versão >= 0.3.0.
+
+## Logs e debugging
+
+### Como pegar request ID
+Toda resposta da API tem header `X-Request-ID`. Inclua no relatório se algo falhar.
+
+### Como ver logs do MCP Server local
+```bash
+# Stdio MCP imprime em stderr — capture no Claude Desktop logs:
+~/Library/Logs/Claude/mcp*.log
+```
+
+### Como ver logs do MCP Remote (servidor produção)
+- Painel Portainer → serviço `mcp_remote` → logs
+- Cloudflare Worker logs (se proxy)
+- Sentry pra exceptions
+
+## Quando reportar pro suporte
+
+Reporte se:
+- 500/502/503 persistente após 3 retries
+- 401 com token recém-gerado
+- Dados sumindo sem ação clara
+- Comportamento inconsistente entre contas
+
+NÃO precisa reportar:
+- 4xx (você fez algo errado)
+- Rate limit (esperado)
+- 404 de recurso deletado

package/dist/index.js

@@ -49,8 +49,8 @@ async function main() {
         console.error(`Base URL: ${config.baseUrl}`);
         console.error(`Account: ${config.accountId}`);
         console.error(`Tools registered: ${toolCount}`);
-        console.error(`Resources registered: 4 (glossary, data-model, reports-guide, api-conventions)`);
-        console.error(`Prompts registered: 4 (productivity_report, stuck_leads, weekly_recap, customer_health)`);
+        console.error(`Resources registered: 8 (glossary, data-model, reports-guide, api-conventions, conversation-flows, kanban-deep-dive, best-practices, troubleshooting)`);
+        console.error(`Prompts registered: 8 (productivity_report, stuck_leads, weekly_recap, customer_health, inactive_contacts, team_load_balance, quality_audit, whatsapp_template_usage)`);
         if (config.categories) {
             console.error(`Categories filter: ${config.categories.join(', ')}`);
         }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/resources.js

@@ -29,6 +29,30 @@ export const RESOURCES = [
         description: 'Auth, paginacao, filtros, datas, codigos HTTP, rate limits. Use quando tiver duvida sobre como chamar endpoint.',
         filename: 'api-conventions.md',
     },
+    {
+        name: 'Fluxos de Conversacao',
+        uri: 'lionchat://docs/conversation-flows',
+        description: 'Ciclo de vida de uma conversa: criacao, greeting, auto-assignment, Captain IA, resolucao, snooze. Use pra diagnosticar comportamento de conversas.',
+        filename: 'conversation-flows.md',
+    },
+    {
+        name: 'Kanban Detalhado',
+        uri: 'lionchat://docs/kanban-deep-dive',
+        description: 'Estrutura completa do Kanban: Funnel, stages, KanbanItem, item_details, pipeline, activities. Use ao trabalhar com cards ou funis.',
+        filename: 'kanban-deep-dive.md',
+    },
+    {
+        name: 'Boas Praticas',
+        uri: 'lionchat://docs/best-practices',
+        description: 'Como economizar tokens, evitar rate limits, usar filtros, paginar. Consulte antes de workflows pesados ou loops em massa.',
+        filename: 'best-practices.md',
+    },
+    {
+        name: 'Troubleshooting',
+        uri: 'lionchat://docs/troubleshooting',
+        description: 'Codigos HTTP, erros comuns (401/403/422/429), erros MCP, debugging, quando reportar suporte. Use pra interpretar erros.',
+        filename: 'troubleshooting.md',
+    },
 ];
 function findDocsPath(filename) {
     const candidates = [

package/dist/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,iEAAiE;AAEjE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAS1D,MAAM,CAAC,MAAM,SAAS,GAAkB;IACtC;QACE,IAAI,EAAE,oBAAoB;QAC1B,GAAG,EAAE,0BAA0B;QAC/B,WAAW,EACT,mIAAmI;QACrI,QAAQ,EAAE,aAAa;KACxB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,4BAA4B;QACjC,WAAW,EACT,sGAAsG;QACxG,QAAQ,EAAE,eAAe;KAC1B;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,GAAG,EAAE,+BAA+B;QACpC,WAAW,EACT,4GAA4G;QAC9G,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,GAAG,EAAE,iCAAiC;QACtC,WAAW,EACT,iHAAiH;QACnH,QAAQ,EAAE,oBAAoB;KAC/B;CACF,CAAC;AAEF,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,SAAS,EAAE,mBAAmB,EAAE,QAAQ,CAAC;QAC9C,IAAI,CAAC,SAAS,EAAE,0BAA0B,EAAE,QAAQ,CAAC;KACtD,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,CAAC,gBAAgB,CACrB,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,GAAG,EACP;YACE,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,QAAQ,EAAE,eAAe;SAC1B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;YACZ,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,eAAe;wBACzB,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,iEAAiE;AAEjE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAS1D,MAAM,CAAC,MAAM,SAAS,GAAkB;IACtC;QACE,IAAI,EAAE,oBAAoB;QAC1B,GAAG,EAAE,0BAA0B;QAC/B,WAAW,EACT,mIAAmI;QACrI,QAAQ,EAAE,aAAa;KACxB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,4BAA4B;QACjC,WAAW,EACT,sGAAsG;QACxG,QAAQ,EAAE,eAAe;KAC1B;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,GAAG,EAAE,+BAA+B;QACpC,WAAW,EACT,4GAA4G;QAC9G,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,GAAG,EAAE,iCAAiC;QACtC,WAAW,EACT,iHAAiH;QACnH,QAAQ,EAAE,oBAAoB;KAC/B;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,GAAG,EAAE,oCAAoC;QACzC,WAAW,EACT,oJAAoJ;QACtJ,QAAQ,EAAE,uBAAuB;KAClC;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,GAAG,EAAE,kCAAkC;QACvC,WAAW,EACT,oIAAoI;QACtI,QAAQ,EAAE,qBAAqB;KAChC;IACD;QACE,IAAI,EAAE,eAAe;QACrB,GAAG,EAAE,gCAAgC;QACrC,WAAW,EACT,2HAA2H;QAC7H,QAAQ,EAAE,mBAAmB;KAC9B;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,iCAAiC;QACtC,WAAW,EACT,yHAAyH;QAC3H,QAAQ,EAAE,oBAAoB;KAC/B;CACF,CAAC;AAEF,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,SAAS,EAAE,mBAAmB,EAAE,QAAQ,CAAC;QAC9C,IAAI,CAAC,SAAS,EAAE,0BAA0B,EAAE,QAAQ,CAAC;KACtD,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,CAAC,gBAAgB,CACrB,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,GAAG,EACP;YACE,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,QAAQ,EAAE,eAAe;SAC1B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;YACZ,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,eAAe;wBACzB,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lionchat/mcp-server",
-  "version": "0.3.0",
-  "description": "MCP server for LionChat API — 547 tools + 4 resources + 4 prompts for AI agents",
+  "version": "0.3.1",
+  "description": "MCP server for LionChat API — 547 tools + 8 resources + 8 prompts for AI agents",
   "type": "module",
   "main": "dist/index.js",
   "bin": {