@lionchat/mcp-server 1.12.0 → 1.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/endpoints.json CHANGED
@@ -12573,7 +12573,7 @@
12573
12573
  "method": "PATCH",
12574
12574
  "path": "/api/v1/accounts/{account_id}/flow_sessions/{id}",
12575
12575
  "title": "Atualizar Sessão do Flow",
12576
- "description": "Pausa, retoma ou remove a sessao de flow (action_type: pause/resume/remove).",
12576
+ "description": "Pausa, retoma ou remove a sessao de flow (action_type: pause/resume/remove). remove = o botao Parar do Historico de execucoes: encerra a sessao DE VEZ (status completed) e registra atividade na conversa dizendo quem parou. Valor fora da lista e no-op.",
12577
12577
  "category": "Sessoes",
12578
12578
  "params": [
12579
12579
  {
@@ -28254,5 +28254,544 @@
28254
28254
  "lionchat_captain_assistants_show",
28255
28255
  "lionchat_conversations_show"
28256
28256
  ]
28257
+ },
28258
+ {
28259
+ "id": "lionchat_lead_forms_list",
28260
+ "method": "GET",
28261
+ "path": "/api/v1/accounts/{account_id}/lead_forms",
28262
+ "title": "Listar Formularios",
28263
+ "description": "Lista os formularios publicos de captacao da conta (estilo Typeform/Typebot), mais recentes primeiro. Cada item traz form_data (rascunho), settings, public_url e counts {views, responses, completed}. NAO traz media_urls (so no show). Leitura liberada a qualquer agente.",
28264
+ "category": "Formularios",
28265
+ "params": [],
28266
+ "returns": "array de formularios (id, name, slug, display_mode, active, form_data, published_at, settings, public_url, counts)",
28267
+ "common_use_cases": [
28268
+ "Ver os formularios da conta e seus numeros",
28269
+ "Achar o id antes de editar/publicar",
28270
+ "Copiar o link publico (public_url)"
28271
+ ],
28272
+ "related_tools": [
28273
+ "lionchat_lead_forms_show",
28274
+ "lionchat_lead_forms_create",
28275
+ "lionchat_lead_forms_stats"
28276
+ ]
28277
+ },
28278
+ {
28279
+ "id": "lionchat_lead_forms_create",
28280
+ "method": "POST",
28281
+ "path": "/api/v1/accounts/{account_id}/lead_forms",
28282
+ "title": "Criar Formulario",
28283
+ "description": "Cria um formulario publico de captacao. So name e obrigatorio (o desenho pode vir depois via update). O slug do link publico e GERADO pelo servidor e imutavel. Nasce inativo e nao publicado — publique com lead_forms_publish e ative com update {active: true}. Escrita admin-only (401 para agente comum). Guia completo do form_data: resource lionchat://docs/formularios-publicos.",
28284
+ "category": "Formularios",
28285
+ "params": [
28286
+ {
28287
+ "name": "name",
28288
+ "type": "string",
28289
+ "location": "body",
28290
+ "required": true,
28291
+ "description": "Nome do formulario"
28292
+ },
28293
+ {
28294
+ "name": "display_mode",
28295
+ "type": "string",
28296
+ "location": "body",
28297
+ "required": false,
28298
+ "description": "Formato da pagina publica: cards (um bloco por tela, estilo Typeform) ou chat (conversa, estilo Typebot). Default cards"
28299
+ },
28300
+ {
28301
+ "name": "active",
28302
+ "type": "boolean",
28303
+ "location": "body",
28304
+ "required": false,
28305
+ "description": "Liga/desliga o link publico (so responde ativo E publicado)"
28306
+ },
28307
+ {
28308
+ "name": "form_data",
28309
+ "type": "object",
28310
+ "location": "body",
28311
+ "required": false,
28312
+ "description": "Desenho do formulario {nodes:[{id,type,position:{x,y},data}], edges:[{id,source,target,sourceHandle}]}. Tipos: start, question, choice, message, condition, action, send_message, end, api_request, ai. Chave de data fora da lista permitida do tipo e DESCARTADA em silencio. Teto 2MB. Contrato completo, variaveis e exemplos: resource lionchat://docs/formularios-publicos. ATENCAO: substitui o desenho INTEIRO — leia com lead_forms_show antes de editar."
28313
+ },
28314
+ {
28315
+ "name": "settings",
28316
+ "type": "object",
28317
+ "location": "body",
28318
+ "required": false,
28319
+ "description": "Configuracao visual/comportamento: {primary_color: '#7C3AED', theme: 'light'|'dark', abandon_minutes: 1..1440 (default 15), button_label: string|null}."
28320
+ }
28321
+ ],
28322
+ "returns": "formulario criado (201) com slug gerado e public_url; 422 {errors} em validacao",
28323
+ "common_use_cases": [
28324
+ "Criar formulario de captacao do zero via API",
28325
+ "Importar um desenho pronto (form_data completo)"
28326
+ ],
28327
+ "related_tools": [
28328
+ "lionchat_lead_forms_list",
28329
+ "lionchat_lead_forms_show",
28330
+ "lionchat_lead_forms_update",
28331
+ "lionchat_lead_forms_publish",
28332
+ "lionchat_lead_forms_stats"
28333
+ ]
28334
+ },
28335
+ {
28336
+ "id": "lionchat_lead_forms_show",
28337
+ "method": "GET",
28338
+ "path": "/api/v1/accounts/{account_id}/lead_forms/{id}",
28339
+ "title": "Detalhe do Formulario",
28340
+ "description": "Retorna o formulario completo, incluindo form_data (rascunho atual) e media_urls (mapa blob_id -> url das imagens de bloco/opcao — SO neste endpoint). published_data (a foto que o publico usa) nunca sai pela API.",
28341
+ "category": "Formularios",
28342
+ "params": [
28343
+ {
28344
+ "name": "id",
28345
+ "type": "integer",
28346
+ "location": "path",
28347
+ "required": true,
28348
+ "description": "ID do formulario"
28349
+ }
28350
+ ],
28351
+ "returns": "formulario (objeto completo + media_urls + counts)",
28352
+ "common_use_cases": [
28353
+ "Ler o form_data atual antes de editar (update substitui o desenho inteiro)",
28354
+ "Conferir estado publicado/ativo e o link publico"
28355
+ ],
28356
+ "related_tools": [
28357
+ "lionchat_lead_forms_update",
28358
+ "lionchat_lead_forms_publish",
28359
+ "lionchat_lead_forms_responses_list"
28360
+ ]
28361
+ },
28362
+ {
28363
+ "id": "lionchat_lead_forms_update",
28364
+ "method": "PATCH",
28365
+ "path": "/api/v1/accounts/{account_id}/lead_forms/{id}",
28366
+ "title": "Atualizar Formulario",
28367
+ "description": "Atualiza nome, desenho (form_data), settings, formato ou ativo. IMPORTANTE: mudanca no form_data so vale pro PUBLICO depois de lead_forms_publish (quem preenche usa sempre a foto publicada). form_data enviado SUBSTITUI o desenho inteiro — leia com lead_forms_show antes. Admin-only.",
28368
+ "category": "Formularios",
28369
+ "params": [
28370
+ {
28371
+ "name": "id",
28372
+ "type": "integer",
28373
+ "location": "path",
28374
+ "required": true,
28375
+ "description": "ID do formulario"
28376
+ },
28377
+ {
28378
+ "name": "name",
28379
+ "type": "string",
28380
+ "location": "body",
28381
+ "required": false,
28382
+ "description": "Nome do formulario"
28383
+ },
28384
+ {
28385
+ "name": "display_mode",
28386
+ "type": "string",
28387
+ "location": "body",
28388
+ "required": false,
28389
+ "description": "cards ou chat"
28390
+ },
28391
+ {
28392
+ "name": "active",
28393
+ "type": "boolean",
28394
+ "location": "body",
28395
+ "required": false,
28396
+ "description": "Liga/desliga o link publico"
28397
+ },
28398
+ {
28399
+ "name": "form_data",
28400
+ "type": "object",
28401
+ "location": "body",
28402
+ "required": false,
28403
+ "description": "Desenho do formulario {nodes:[{id,type,position:{x,y},data}], edges:[{id,source,target,sourceHandle}]}. Tipos: start, question, choice, message, condition, action, send_message, end, api_request, ai. Chave de data fora da lista permitida do tipo e DESCARTADA em silencio. Teto 2MB. Contrato completo, variaveis e exemplos: resource lionchat://docs/formularios-publicos. ATENCAO: substitui o desenho INTEIRO — leia com lead_forms_show antes de editar."
28404
+ },
28405
+ {
28406
+ "name": "settings",
28407
+ "type": "object",
28408
+ "location": "body",
28409
+ "required": false,
28410
+ "description": "Configuracao visual/comportamento: {primary_color: '#7C3AED', theme: 'light'|'dark', abandon_minutes: 1..1440 (default 15), button_label: string|null}."
28411
+ }
28412
+ ],
28413
+ "returns": "formulario atualizado; 422 {errors} em validacao",
28414
+ "common_use_cases": [
28415
+ "Editar o desenho do formulario",
28416
+ "Ativar/desativar o link publico",
28417
+ "Trocar tema/cor/tempo de abandono"
28418
+ ],
28419
+ "related_tools": [
28420
+ "lionchat_lead_forms_show",
28421
+ "lionchat_lead_forms_publish"
28422
+ ]
28423
+ },
28424
+ {
28425
+ "id": "lionchat_lead_forms_destroy",
28426
+ "method": "DELETE",
28427
+ "path": "/api/v1/accounts/{account_id}/lead_forms/{id}",
28428
+ "title": "Excluir Formulario",
28429
+ "description": "Exclui o formulario e (assincronamente) todas as respostas. Irreversivel — confirme com o usuario antes. Admin-only.",
28430
+ "category": "Formularios",
28431
+ "params": [
28432
+ {
28433
+ "name": "id",
28434
+ "type": "integer",
28435
+ "location": "path",
28436
+ "required": true,
28437
+ "description": "ID do formulario"
28438
+ }
28439
+ ],
28440
+ "returns": "204 sem corpo",
28441
+ "common_use_cases": [
28442
+ "Remover formulario descontinuado"
28443
+ ],
28444
+ "related_tools": [
28445
+ "lionchat_lead_forms_list"
28446
+ ]
28447
+ },
28448
+ {
28449
+ "id": "lionchat_lead_forms_publish",
28450
+ "method": "POST",
28451
+ "path": "/api/v1/accounts/{account_id}/lead_forms/{id}/publish",
28452
+ "title": "Publicar Formulario",
28453
+ "description": "Valida o desenho e copia form_data para a foto publicada (published_data) — e o que faz as edicoes chegarem ao publico. Falha de validacao devolve 422 {errors: [chaves]} com chaves como no_start, no_reachable_end, question_without_label, condition_without_else, api_without_url, api_without_error_exit, ai_without_prompt, ai_without_other_exit (lista completa e significado: resource lionchat://docs/formularios-publicos). Admin-only.",
28454
+ "category": "Formularios",
28455
+ "params": [
28456
+ {
28457
+ "name": "id",
28458
+ "type": "integer",
28459
+ "location": "path",
28460
+ "required": true,
28461
+ "description": "ID do formulario"
28462
+ }
28463
+ ],
28464
+ "returns": "formulario com published_at carimbado; 422 {errors: [chaves i18n]} se o desenho nao passa",
28465
+ "common_use_cases": [
28466
+ "Colocar edicoes do desenho no ar",
28467
+ "Descobrir o que falta no desenho (as chaves do 422 dizem exatamente)"
28468
+ ],
28469
+ "related_tools": [
28470
+ "lionchat_lead_forms_update",
28471
+ "lionchat_lead_forms_show"
28472
+ ]
28473
+ },
28474
+ {
28475
+ "id": "lionchat_lead_forms_duplicate",
28476
+ "method": "POST",
28477
+ "path": "/api/v1/accounts/{account_id}/lead_forms/{id}/duplicate",
28478
+ "title": "Duplicar Formulario",
28479
+ "description": "Cria uma copia do formulario: nome + ' (copia)', slug novo, INATIVA e NAO publicada; as imagens dos blocos sao duplicadas (arquivos novos). Admin-only.",
28480
+ "category": "Formularios",
28481
+ "params": [
28482
+ {
28483
+ "name": "id",
28484
+ "type": "integer",
28485
+ "location": "path",
28486
+ "required": true,
28487
+ "description": "ID do formulario"
28488
+ }
28489
+ ],
28490
+ "returns": "201 + copia serializada",
28491
+ "common_use_cases": [
28492
+ "Usar um formulario existente como modelo"
28493
+ ],
28494
+ "related_tools": [
28495
+ "lionchat_lead_forms_list",
28496
+ "lionchat_lead_forms_update"
28497
+ ]
28498
+ },
28499
+ {
28500
+ "id": "lionchat_lead_forms_stats",
28501
+ "method": "GET",
28502
+ "path": "/api/v1/accounts/{account_id}/lead_forms/{id}/stats",
28503
+ "title": "Funil do Formulario",
28504
+ "description": "Estatisticas agregadas: views, starts, completed, abandoned, completion_rate (%), funil bloco a bloco (reached + percent, so blocos visiveis, ordem do desenho publicado) e marcos (milestones).",
28505
+ "category": "Formularios",
28506
+ "params": [
28507
+ {
28508
+ "name": "id",
28509
+ "type": "integer",
28510
+ "location": "path",
28511
+ "required": true,
28512
+ "description": "ID do formulario"
28513
+ },
28514
+ {
28515
+ "name": "days",
28516
+ "type": "integer",
28517
+ "location": "query",
28518
+ "required": false,
28519
+ "description": "Janela em dias (default 30, maximo 90)"
28520
+ }
28521
+ ],
28522
+ "returns": "{views, starts, completed, abandoned, completion_rate, funnel: [{node_id, type, label, reached, percent}], milestones: [{node_id, name, reached}]}",
28523
+ "common_use_cases": [
28524
+ "Onde os leads abandonam (funil por bloco)",
28525
+ "Taxa de conclusao do formulario",
28526
+ "Alcance de cada marco"
28527
+ ],
28528
+ "related_tools": [
28529
+ "lionchat_lead_forms_responses_list",
28530
+ "lionchat_lead_forms_list"
28531
+ ]
28532
+ },
28533
+ {
28534
+ "id": "lionchat_lead_forms_responses_list",
28535
+ "method": "GET",
28536
+ "path": "/api/v1/accounts/{account_id}/lead_forms/{lead_form_id}/responses",
28537
+ "title": "Listar Respostas do Formulario",
28538
+ "description": "Lista as respostas (25 por pagina, colunas leves — as respostas em si NAO vem na lista, use o show). Filtra por status e janela de dias.",
28539
+ "category": "Formularios",
28540
+ "params": [
28541
+ {
28542
+ "name": "lead_form_id",
28543
+ "type": "integer",
28544
+ "location": "path",
28545
+ "required": true,
28546
+ "description": "ID do formulario"
28547
+ },
28548
+ {
28549
+ "name": "status",
28550
+ "type": "string",
28551
+ "location": "query",
28552
+ "required": false,
28553
+ "description": "in_progress, completed ou abandoned (fora da lista e ignorado)"
28554
+ },
28555
+ {
28556
+ "name": "days",
28557
+ "type": "integer",
28558
+ "location": "query",
28559
+ "required": false,
28560
+ "description": "Janela em dias (default 30, maximo 90)"
28561
+ },
28562
+ {
28563
+ "name": "page",
28564
+ "type": "integer",
28565
+ "location": "query",
28566
+ "required": false,
28567
+ "description": "Pagina (default 1)"
28568
+ }
28569
+ ],
28570
+ "returns": "{payload: [{id, status, contact: {id,name,phone}|null, current_node_label, answered_count, created_at, completed_at}], meta: {current_page, per_page, total_count}}",
28571
+ "common_use_cases": [
28572
+ "Ver quem respondeu/abandonou",
28573
+ "Achar o id de uma resposta pro detalhe"
28574
+ ],
28575
+ "related_tools": [
28576
+ "lionchat_lead_forms_responses_show",
28577
+ "lionchat_lead_forms_stats"
28578
+ ]
28579
+ },
28580
+ {
28581
+ "id": "lionchat_lead_forms_responses_show",
28582
+ "method": "GET",
28583
+ "path": "/api/v1/accounts/{account_id}/lead_forms/{lead_form_id}/responses/{id}",
28584
+ "title": "Detalhe da Resposta do Formulario",
28585
+ "description": "Resposta completa: answers legiveis [{label, value_label, at, download_url? (so arquivo enviado)}], marcos, utm_params e effects — o desfecho de cada bloco de API/IA ({node_id, label, state done|error|pending, error, status HTTP, url_short}) pra investigar consulta que falhou.",
28586
+ "category": "Formularios",
28587
+ "params": [
28588
+ {
28589
+ "name": "lead_form_id",
28590
+ "type": "integer",
28591
+ "location": "path",
28592
+ "required": true,
28593
+ "description": "ID do formulario"
28594
+ },
28595
+ {
28596
+ "name": "id",
28597
+ "type": "integer",
28598
+ "location": "path",
28599
+ "required": true,
28600
+ "description": "ID da resposta"
28601
+ }
28602
+ ],
28603
+ "returns": "{id, status, contact, answers: [...], milestones: [...], effects: [...], utm_params, started_at, completed_at, abandoned_at}",
28604
+ "common_use_cases": [
28605
+ "Ler o que o lead respondeu",
28606
+ "Investigar por que a consulta externa/IA falhou (effects)",
28607
+ "Ver a origem (utm_params)"
28608
+ ],
28609
+ "related_tools": [
28610
+ "lionchat_lead_forms_responses_list",
28611
+ "lionchat_lead_forms_stats"
28612
+ ]
28613
+ },
28614
+ {
28615
+ "id": "lionchat_guru_subscription_show",
28616
+ "method": "GET",
28617
+ "path": "/api/v1/accounts/{account_id}/guru_subscription",
28618
+ "title": "Ver Assinatura (Guru)",
28619
+ "description": "Assinatura da PROPRIA conta na plataforma, direto do Guru (passthrough) + dados locais do plano (plan_name, billing_period, subscription_expires_at, valor). Requer a feature 'Gestao de assinatura (Guru)' ligada pra conta no Super Admin — desligada devolve 404 {code: 'feature_disabled'} (diferente do 404 de assinatura inexistente no Guru). Somente administrator (403). 422 = validacao/nao configurado; 503 = Guru fora do ar.",
28620
+ "category": "Assinatura",
28621
+ "params": [],
28622
+ "returns": "{subscription: <objeto do Guru>, local: {plan_name, plan_slug, billing_period, subscription_expires_at, subscription_value_cents}}",
28623
+ "common_use_cases": [
28624
+ "Ver status/vencimento da assinatura da conta",
28625
+ "Conferir o plano atual antes de simular troca"
28626
+ ],
28627
+ "related_tools": [
28628
+ "lionchat_guru_subscription_available_plans",
28629
+ "lionchat_guru_subscription_invoices"
28630
+ ]
28631
+ },
28632
+ {
28633
+ "id": "lionchat_guru_subscription_available_plans",
28634
+ "method": "GET",
28635
+ "path": "/api/v1/accounts/{account_id}/guru_subscription/available_plans",
28636
+ "title": "Planos Disponiveis (Guru)",
28637
+ "description": "Ofertas do Guru FILTRADAS: so aparecem ofertas vinculadas a um plano da plataforma (cada uma com local_plan {plan_name, plan_slug, period}). Requer a feature 'Gestao de assinatura (Guru)' ligada pra conta no Super Admin — desligada devolve 404 {code: 'feature_disabled'} (diferente do 404 de assinatura inexistente no Guru). Somente administrator (403). 422 = validacao/nao configurado; 503 = Guru fora do ar.",
28638
+ "category": "Assinatura",
28639
+ "params": [],
28640
+ "returns": "{offers: [...com local_plan], local: {...}}",
28641
+ "common_use_cases": [
28642
+ "Listar opcoes de upgrade/downgrade antes de simular"
28643
+ ],
28644
+ "related_tools": [
28645
+ "lionchat_guru_subscription_simulate",
28646
+ "lionchat_guru_subscription_change_plan"
28647
+ ]
28648
+ },
28649
+ {
28650
+ "id": "lionchat_guru_subscription_invoices",
28651
+ "method": "GET",
28652
+ "path": "/api/v1/accounts/{account_id}/guru_subscription/invoices",
28653
+ "title": "Faturas da Assinatura (Guru)",
28654
+ "description": "Faturas da assinatura, direto do Guru (passthrough). Requer a feature 'Gestao de assinatura (Guru)' ligada pra conta no Super Admin — desligada devolve 404 {code: 'feature_disabled'} (diferente do 404 de assinatura inexistente no Guru). Somente administrator (403). 422 = validacao/nao configurado; 503 = Guru fora do ar.",
28655
+ "category": "Assinatura",
28656
+ "params": [],
28657
+ "returns": "{invoices: <passthrough do Guru>}",
28658
+ "common_use_cases": [
28659
+ "Historico de faturas da conta"
28660
+ ],
28661
+ "related_tools": [
28662
+ "lionchat_guru_subscription_transactions",
28663
+ "lionchat_guru_subscription_show"
28664
+ ]
28665
+ },
28666
+ {
28667
+ "id": "lionchat_guru_subscription_transactions",
28668
+ "method": "GET",
28669
+ "path": "/api/v1/accounts/{account_id}/guru_subscription/transactions",
28670
+ "title": "Transacoes da Assinatura (Guru)",
28671
+ "description": "Transacoes de pagamento da assinatura, direto do Guru (passthrough). Requer a feature 'Gestao de assinatura (Guru)' ligada pra conta no Super Admin — desligada devolve 404 {code: 'feature_disabled'} (diferente do 404 de assinatura inexistente no Guru). Somente administrator (403). 422 = validacao/nao configurado; 503 = Guru fora do ar.",
28672
+ "category": "Assinatura",
28673
+ "params": [],
28674
+ "returns": "{transactions: <passthrough do Guru>}",
28675
+ "common_use_cases": [
28676
+ "Conferir pagamentos aprovados/recusados"
28677
+ ],
28678
+ "related_tools": [
28679
+ "lionchat_guru_subscription_invoices"
28680
+ ]
28681
+ },
28682
+ {
28683
+ "id": "lionchat_guru_subscription_activities",
28684
+ "method": "GET",
28685
+ "path": "/api/v1/accounts/{account_id}/guru_subscription/activities",
28686
+ "title": "Atividades da Assinatura (Guru)",
28687
+ "description": "Linha do tempo de eventos da assinatura no Guru (passthrough). Requer a feature 'Gestao de assinatura (Guru)' ligada pra conta no Super Admin — desligada devolve 404 {code: 'feature_disabled'} (diferente do 404 de assinatura inexistente no Guru). Somente administrator (403). 422 = validacao/nao configurado; 503 = Guru fora do ar.",
28688
+ "category": "Assinatura",
28689
+ "params": [],
28690
+ "returns": "{activities: <passthrough do Guru>}",
28691
+ "common_use_cases": [
28692
+ "Auditar mudancas recentes da assinatura"
28693
+ ],
28694
+ "related_tools": [
28695
+ "lionchat_guru_subscription_show"
28696
+ ]
28697
+ },
28698
+ {
28699
+ "id": "lionchat_guru_subscription_simulate",
28700
+ "method": "POST",
28701
+ "path": "/api/v1/accounts/{account_id}/guru_subscription/simulate",
28702
+ "title": "Simular Troca de Plano (Guru)",
28703
+ "description": "Previa do rateio de uma troca de plano SEM efetivar nada. offer_id precisa estar entre as ofertas vinculadas (available_plans) — senao 422 offer_not_allowed. Requer a feature 'Gestao de assinatura (Guru)' ligada pra conta no Super Admin — desligada devolve 404 {code: 'feature_disabled'} (diferente do 404 de assinatura inexistente no Guru). Somente administrator (403). 422 = validacao/nao configurado; 503 = Guru fora do ar.",
28704
+ "category": "Assinatura",
28705
+ "params": [
28706
+ {
28707
+ "name": "offer_id",
28708
+ "type": "string",
28709
+ "location": "body",
28710
+ "required": true,
28711
+ "description": "ID da oferta do Guru (das available_plans)"
28712
+ }
28713
+ ],
28714
+ "returns": "previa de rateio (passthrough do Guru)",
28715
+ "common_use_cases": [
28716
+ "Mostrar ao usuario quanto custaria a troca antes de confirmar"
28717
+ ],
28718
+ "related_tools": [
28719
+ "lionchat_guru_subscription_available_plans",
28720
+ "lionchat_guru_subscription_change_plan"
28721
+ ]
28722
+ },
28723
+ {
28724
+ "id": "lionchat_guru_subscription_change_plan",
28725
+ "method": "POST",
28726
+ "path": "/api/v1/accounts/{account_id}/guru_subscription/change_plan",
28727
+ "title": "Trocar Plano (Guru)",
28728
+ "description": "EFETIVA a troca de plano: upgrade cobra o proporcional NA HORA; downgrade agenda pro fim do ciclo. Confirme com o usuario e rode simulate antes. Acoes de escrita tem trava de 30s por conta — segunda tentativa na janela devolve 422 'operacao em andamento'. Requer a feature 'Gestao de assinatura (Guru)' ligada pra conta no Super Admin — desligada devolve 404 {code: 'feature_disabled'} (diferente do 404 de assinatura inexistente no Guru). Somente administrator (403). 422 = validacao/nao configurado; 503 = Guru fora do ar.",
28729
+ "category": "Assinatura",
28730
+ "params": [
28731
+ {
28732
+ "name": "offer_id",
28733
+ "type": "string",
28734
+ "location": "body",
28735
+ "required": true,
28736
+ "description": "ID da oferta do Guru (das available_plans)"
28737
+ }
28738
+ ],
28739
+ "returns": "resultado da troca (passthrough do Guru)",
28740
+ "common_use_cases": [
28741
+ "Upgrade/downgrade da assinatura da propria conta apos confirmacao explicita"
28742
+ ],
28743
+ "related_tools": [
28744
+ "lionchat_guru_subscription_simulate",
28745
+ "lionchat_guru_subscription_show"
28746
+ ]
28747
+ },
28748
+ {
28749
+ "id": "lionchat_guru_subscription_cancel",
28750
+ "method": "POST",
28751
+ "path": "/api/v1/accounts/{account_id}/guru_subscription/cancel",
28752
+ "title": "Cancelar Assinatura (Guru)",
28753
+ "description": "ACAO SENSIVEL: cancela a assinatura da conta. Por padrao cancela no FIM do ciclo (cancel_at_cycle_end true); so false explicito cancela imediato. SEMPRE confirme com o usuario antes. Acoes de escrita tem trava de 30s por conta — segunda tentativa na janela devolve 422 'operacao em andamento'. Requer a feature 'Gestao de assinatura (Guru)' ligada pra conta no Super Admin — desligada devolve 404 {code: 'feature_disabled'} (diferente do 404 de assinatura inexistente no Guru). Somente administrator (403). 422 = validacao/nao configurado; 503 = Guru fora do ar.",
28754
+ "category": "Assinatura",
28755
+ "params": [
28756
+ {
28757
+ "name": "comment",
28758
+ "type": "string",
28759
+ "location": "body",
28760
+ "required": false,
28761
+ "description": "Motivo do cancelamento (opcional)"
28762
+ },
28763
+ {
28764
+ "name": "cancel_at_cycle_end",
28765
+ "type": "boolean",
28766
+ "location": "body",
28767
+ "required": false,
28768
+ "description": "Default true (cancela no fim do ciclo). false = imediato"
28769
+ }
28770
+ ],
28771
+ "returns": "resultado do cancelamento (passthrough do Guru)",
28772
+ "common_use_cases": [
28773
+ "Cancelamento pedido explicitamente pelo dono da conta"
28774
+ ],
28775
+ "related_tools": [
28776
+ "lionchat_guru_subscription_revert_cancel",
28777
+ "lionchat_guru_subscription_show"
28778
+ ]
28779
+ },
28780
+ {
28781
+ "id": "lionchat_guru_subscription_revert_cancel",
28782
+ "method": "POST",
28783
+ "path": "/api/v1/accounts/{account_id}/guru_subscription/revert_cancel",
28784
+ "title": "Reverter Cancelamento (Guru)",
28785
+ "description": "Desfaz um cancelamento agendado pro fim do ciclo (enquanto ainda nao venceu). Acoes de escrita tem trava de 30s por conta — segunda tentativa na janela devolve 422 'operacao em andamento'. Requer a feature 'Gestao de assinatura (Guru)' ligada pra conta no Super Admin — desligada devolve 404 {code: 'feature_disabled'} (diferente do 404 de assinatura inexistente no Guru). Somente administrator (403). 422 = validacao/nao configurado; 503 = Guru fora do ar.",
28786
+ "category": "Assinatura",
28787
+ "params": [],
28788
+ "returns": "resultado (passthrough do Guru)",
28789
+ "common_use_cases": [
28790
+ "Cliente desistiu de cancelar"
28791
+ ],
28792
+ "related_tools": [
28793
+ "lionchat_guru_subscription_cancel",
28794
+ "lionchat_guru_subscription_show"
28795
+ ]
28257
28796
  }
28258
28797
  ]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lionchat/mcp-server",
3
- "version": "1.12.0",
3
+ "version": "1.13.0",
4
4
  "description": "MCP server for LionChat API — 547 tools + 10 resources + 9 prompts. Audit-log aware, completion API, progress notifications.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",