@lionchat/mcp-server 1.4.0 → 1.5.0

package/dist/docs/instructions.md

@@ -4,6 +4,28 @@ Você está conectado ao LionChat, uma plataforma brasileira de atendimento mult
 
 **Idioma de saída:** sempre português brasileiro (PT-BR). Termos técnicos da API podem permanecer em inglês quando padronizados (status, payload, endpoint).
 
+## 0. REGRA ZERO — nunca diga "não existe função" sem PESQUISAR antes
+
+Este MCP expõe ~690 ferramentas. Alguns clientes (ChatGPT em especial) NÃO carregam todas na
+conversa — só um subconjunto inicial, e conseguem **pesquisar e carregar o resto sob demanda,
+pelo nome**. Por isso, se a ferramenta de que você precisa não está visível agora:
+**PESQUISE o catálogo pelo nome ANTES de responder que "não dá" ou que "a função não existe".**
+Comprovado em produção (24/07): a sessão que dizia "não há função de listar conversas" achou
+`conversations_list` e mais dezenas na primeira pesquisa.
+
+- **Convenção de nomes:** `lionchat_<recurso>_<ação>`. Ações: `list`, `show`, `create`, `update`,
+  `destroy`, `filter`, `search`.
+- **Famílias principais pra pesquisar:** conversations, conversations_messages, contacts,
+  kanban_items, funnels, flows, flow_tools, campaigns, macros, automation_rules, agents, teams,
+  inboxes, labels, canned_responses, reports, sla, csat, captain_assistants, captain_documents,
+  scheduled_messages, custom_attributes, webhooks, eclinica_integrations, tasks, notifications.
+- Só depois de pesquisar e não encontrar é que se pode dizer que a função não existe.
+- **Trabalho volumoso** (relatório de muitas conversas/cards): as listas são paginadas (25-100 por
+  página) — faça em ETAPAS ao longo de várias respostas, acumulando os resultados; nunca desista
+  por "excede o limite de uma execução".
+- As ferramentas operam na **conta ATIVA** da sessão (não recebem account_id) — confira com
+  `lionchat_current_account` e troque com `lionchat_switch_account` se precisar.
+
 ## 1. Modelo de dados central
 
 ```

package/endpoints.json

@@ -1313,6 +1313,47 @@
     ],
     "related_tools": []
   },
+  {
+    "id": "lionchat_conversations_toggle_status",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/conversations/{conversation_id}/toggle_status",
+    "title": "Resolver / Reabrir / Mudar Status da Conversa",
+    "description": "Muda o status da conversa: fechar/encerrar/resolver (status=resolved), reabrir (open), marcar pendente (pending) ou adiar (snoozed, com snoozed_until). É A ferramenta para 'fechar a conversa' — a lionchat_conversations_update NÃO altera status. Sem o param status, alterna resolved↔open. ATENÇÃO: reabrir conversa antiga de contato com trava de conversa única pode ser recusado (reopen_blocked).",
+    "category": "Conversas",
+    "params": [
+      {
+        "name": "conversation_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "display_id da conversa"
+      },
+      {
+        "name": "status",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "open, resolved, pending ou snoozed (sem ele: alterna resolved/open)"
+      },
+      {
+        "name": "snoozed_until",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Até quando adiar (ISO 8601), junto com status=snoozed"
+      }
+    ],
+    "returns": "200 {payload: {success: true, current_status, conversation_id}}",
+    "common_use_cases": [
+      "Fechar/resolver uma conversa após o atendimento",
+      "Reabrir uma conversa resolvida",
+      "Adiar (snooze) uma conversa até uma data"
+    ],
+    "related_tools": [
+      "lionchat_conversations_show",
+      "lionchat_conversations_update"
+    ]
+  },
   {
     "id": "lionchat_conversations_update",
     "method": "PATCH",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionchat/mcp-server",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "MCP server for LionChat API — 547 tools + 10 resources + 9 prompts. Audit-log aware, completion API, progress notifications.",
   "type": "module",
   "main": "dist/index.js",