@connect-xlab/mcp-server 0.2.0 → 0.3.0

package/dist/tools/updateLinkInBioBlock.js

@@ -1,21 +1,24 @@
 /**
  * Tool `update_link_in_bio_block` — modifie un bloc existant. Tous les champs
- * sont optionnels : seuls ceux fournis sont modifies.
+ * sont optionnels : seuls ceux fournis sont modifies (l'API complete le reste
+ * avec les valeurs actuelles du bloc).
  */
 import { z } from 'zod';
 import { http, formatApiError } from '../http.js';
 export const updateLinkInBioBlockTool = {
     name: 'update_link_in_bio_block',
-    description: "Modifie un bloc existant (identifie par block_id, entier renvoye par get_link_in_bio ou create_link_in_bio_block). Champs modifiables : title, subtitle, action_url, image_url, is_active (afficher/masquer sans supprimer).",
+    description: "Modifie un bloc existant (identifie par block_id, entier renvoye par get_link_in_bio ou create_link_in_bio_block). Seuls les champs fournis changent : title, subtitle, url (bloc externe), image_url, quiz_id (bloc quiz), lab_group_id (bloc Lab), is_active (afficher/masquer sans supprimer). Le type (kind) d'un bloc ne change pas.",
     inputSchema: {
         type: 'object',
         properties: {
             lab: { type: 'string' },
             block_id: { type: 'number', minimum: 1 },
-            title: { type: 'string', maxLength: 60 },
-            subtitle: { type: 'string', maxLength: 120 },
-            action_url: { type: 'string' },
+            title: { type: 'string', maxLength: 200 },
+            subtitle: { type: 'string', maxLength: 300 },
+            url: { type: 'string' },
             image_url: { type: 'string' },
+            quiz_id: { type: 'number', minimum: 1 },
+            lab_group_id: { type: 'number', minimum: 1 },
             is_active: { type: 'boolean' },
         },
         required: ['lab', 'block_id'],
@@ -24,10 +27,12 @@ export const updateLinkInBioBlockTool = {
     zodSchema: z.object({
         lab: z.string(),
         block_id: z.number().int().positive(),
-        title: z.string().max(60).optional(),
-        subtitle: z.string().max(120).optional(),
-        action_url: z.string().optional(),
+        title: z.string().max(200).optional(),
+        subtitle: z.string().max(300).optional(),
+        url: z.string().optional(),
         image_url: z.string().optional(),
+        quiz_id: z.number().int().positive().optional(),
+        lab_group_id: z.number().int().positive().optional(),
         is_active: z.boolean().optional(),
     }),
     async handler(args) {

package/dist/tools/updateQuiz.js

@@ -0,0 +1,56 @@
+/**
+ * Tool `update_quiz` — modifie l'accueil / l'apparence / la capture d'un quiz.
+ * Scope : quiz.write.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateQuizTool = {
+    name: 'update_quiz',
+    description: "Modifie un quiz (seuls les champs fournis changent) : accueil (title, subtitle, cta_label), capture (capture_phone = demander le WhatsApp, capture_promise = promesse affichee au moment de laisser ses coordonnees, footer_note), apparence (color hex, show_progress, background_type text|image, logo_path, background_path).",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab' },
+            quiz_id: { type: 'number', minimum: 1, description: 'id du quiz (list_quizzes)' },
+            title: { type: 'string', maxLength: 255 },
+            subtitle: { type: 'string' },
+            cta_label: { type: 'string', maxLength: 120 },
+            capture_phone: { type: 'boolean' },
+            capture_promise: { type: 'string' },
+            footer_note: { type: 'string', maxLength: 255 },
+            color: { type: 'string', maxLength: 16, description: 'couleur hex, ex #5A6BE3' },
+            show_progress: { type: 'boolean' },
+            background_type: { type: 'string', enum: ['text', 'image'] },
+            logo_path: { type: 'string', maxLength: 255 },
+            background_path: { type: 'string', maxLength: 255 },
+        },
+        required: ['lab', 'quiz_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        quiz_id: z.number().int().positive(),
+        title: z.string().max(255).nullable().optional(),
+        subtitle: z.string().nullable().optional(),
+        cta_label: z.string().max(120).nullable().optional(),
+        capture_phone: z.boolean().optional(),
+        capture_promise: z.string().nullable().optional(),
+        footer_note: z.string().max(255).nullable().optional(),
+        color: z.string().max(16).nullable().optional(),
+        show_progress: z.boolean().optional(),
+        background_type: z.enum(['text', 'image']).optional(),
+        logo_path: z.string().max(255).nullable().optional(),
+        background_path: z.string().max(255).nullable().optional(),
+    }),
+    async handler(args) {
+        const { lab, quiz_id, ...body } = this.zodSchema.parse(args);
+        const p = { lab, quiz_id };
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(p.lab)}/quiz/quizzes/${p.quiz_id}`, body);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/updateQuizAnswer.js

@@ -0,0 +1,44 @@
+/**
+ * Tool `update_quiz_answer` — modifie une reponse.
+ * Scope : quiz.write.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateQuizAnswerTool = {
+    name: 'update_quiz_answer',
+    description: "Modifie une reponse (label, points 0-4, profile_id). Seuls les champs fournis changent.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab' },
+            quiz_id: { type: 'number', minimum: 1, description: 'id du quiz (list_quizzes)' },
+            item_id: { type: 'number', minimum: 1, description: 'id de la question / page (get_quiz)' },
+            answer_id: { type: 'number', minimum: 1, description: 'id de la reponse (get_quiz)' },
+            label: { type: 'string', maxLength: 300 },
+            points: { type: 'number', minimum: 0, maximum: 4 },
+            profile_id: { type: 'number', minimum: 1 },
+        },
+        required: ['lab', 'quiz_id', 'item_id', 'answer_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        quiz_id: z.number().int().positive(),
+        item_id: z.number().int().positive(),
+        answer_id: z.number().int().positive(),
+        label: z.string().max(300).nullable().optional(),
+        points: z.number().int().min(0).max(4).optional(),
+        profile_id: z.number().int().min(1).nullable().optional(),
+    }),
+    async handler(args) {
+        const { lab, quiz_id, item_id, answer_id, ...body } = this.zodSchema.parse(args);
+        const p = { lab, quiz_id, item_id, answer_id };
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(p.lab)}/quiz/quizzes/${p.quiz_id}/items/${p.item_id}/answers/${p.answer_id}`, body);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/updateQuizItem.js

@@ -0,0 +1,46 @@
+/**
+ * Tool `update_quiz_item` — modifie une question / page.
+ * Scope : quiz.write.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateQuizItemTool = {
+    name: 'update_quiz_item',
+    description: "Modifie une question ou page intermediaire (seuls les champs fournis changent). Le type (kind) ne se change pas.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab' },
+            quiz_id: { type: 'number', minimum: 1, description: 'id du quiz (list_quizzes)' },
+            item_id: { type: 'number', minimum: 1, description: 'id de la question / page (get_quiz)' },
+            title: { type: 'string', maxLength: 500 },
+            body: { type: 'string' },
+            image_path: { type: 'string', maxLength: 255 },
+            button_label: { type: 'string', maxLength: 120 },
+            key: { type: 'string', maxLength: 60 },
+        },
+        required: ['lab', 'quiz_id', 'item_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        quiz_id: z.number().int().positive(),
+        item_id: z.number().int().positive(),
+        title: z.string().max(500).nullable().optional(),
+        body: z.string().nullable().optional(),
+        image_path: z.string().max(255).nullable().optional(),
+        button_label: z.string().max(120).nullable().optional(),
+        key: z.string().max(60).nullable().optional(),
+    }),
+    async handler(args) {
+        const { lab, quiz_id, item_id, ...body } = this.zodSchema.parse(args);
+        const p = { lab, quiz_id, item_id };
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(p.lab)}/quiz/quizzes/${p.quiz_id}/items/${p.item_id}`, body);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/updateQuizProfile.js

@@ -0,0 +1,52 @@
+/**
+ * Tool `update_quiz_profile` — modifie un profil de resultat.
+ * Scope : quiz.write.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateQuizProfileTool = {
+    name: 'update_quiz_profile',
+    description: "Modifie un profil de resultat (seuls les champs fournis changent). Memes champs que create_quiz_profile.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab' },
+            quiz_id: { type: 'number', minimum: 1, description: 'id du quiz (list_quizzes)' },
+            profile_id: { type: 'number', minimum: 1, description: 'id du profil de resultat (get_quiz)' },
+            name: { type: 'string', maxLength: 120 },
+            color: { type: 'string', maxLength: 16 },
+            diagnosis: { type: 'string' },
+            video_url: { type: 'string', maxLength: 500 },
+            plan: { type: 'array', maxItems: 5, items: { type: 'object', properties: { text: { type: 'string' }, locked: { type: 'boolean' } }, required: ['text', 'locked'] } },
+            cta_label: { type: 'string', maxLength: 120 },
+            destination_type: { type: 'string', enum: ['product', 'join', 'calendar', 'url'] },
+            destination_ref: { type: 'string', maxLength: 255 },
+        },
+        required: ['lab', 'quiz_id', 'profile_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        quiz_id: z.number().int().positive(),
+        profile_id: z.number().int().positive(),
+        name: z.string().max(120).nullable().optional(),
+        color: z.string().max(16).nullable().optional(),
+        diagnosis: z.string().nullable().optional(),
+        video_url: z.string().max(500).nullable().optional(),
+        plan: z.array(z.object({ text: z.string(), locked: z.boolean() })).max(5).nullable().optional(),
+        cta_label: z.string().max(120).nullable().optional(),
+        destination_type: z.enum(['product', 'join', 'calendar', 'url']).optional(),
+        destination_ref: z.string().max(255).nullable().optional(),
+    }),
+    async handler(args) {
+        const { lab, quiz_id, profile_id, ...body } = this.zodSchema.parse(args);
+        const p = { lab, quiz_id, profile_id };
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(p.lab)}/quiz/quizzes/${p.quiz_id}/profiles/${p.profile_id}`, body);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/updateQuizSettings.js

@@ -0,0 +1,34 @@
+/**
+ * Tool `update_quiz_settings` — active / desactive le plug-in Quiz.
+ * Scope : quiz.write.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateQuizSettingsTool = {
+    name: 'update_quiz_settings',
+    description: "Active ou desactive le plug-in Quiz du Lab. Desactive, plus aucun quiz n'est accessible publiquement (meme publie).",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab' },
+            enabled: { type: 'boolean' },
+        },
+        required: ['lab', 'enabled'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        enabled: z.boolean(),
+    }),
+    async handler(args) {
+        const { lab, ...body } = this.zodSchema.parse(args);
+        const p = { lab };
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(p.lab)}/quiz/settings`, body);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/updateShopProduct.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { http, formatApiError } from '../http.js';
 export const updateShopProductTool = {
     name: 'update_shop_product',
-    description: "Modifie un produit boutique (titre, prix, description, publication, type d'offre). Champs optionnels. Prix en centimes. Passe offer_type=formation + course_id (list_classes) pour que l'achat debloque un cours ; tout autre offer_type detache le cours lie.",
+    description: "Modifie un produit boutique (titre, prix, description, publication, type d'offre, quiz embarque). Champs optionnels. Prix en centimes. Paiement toujours via Stripe ConnectXLab. Passe offer_type=formation + course_id (list_classes) pour que l'achat debloque un cours ; tout autre offer_type detache le cours lie. offer_type=digital : quiz_id (list_quizzes, null pour retirer), quiz_cta_label, quiz_cta_subtext ; tout autre type detache le quiz.",
     inputSchema: {
         type: 'object',
         properties: {
@@ -14,9 +14,10 @@ export const updateShopProductTool = {
             price_cents: { type: 'number', minimum: 0 },
             offer_type: { type: 'string', enum: ['digital', 'calendar', 'formation'] },
             course_id: { type: 'number', description: "Id d'un cours du Lab (list_classes) — requis/utilise quand offer_type=formation." },
-            payment_mode: { type: 'string', enum: ['external', 'stripe'] },
-            payment_link_text: { type: 'string', maxLength: 255 },
             support_email: { type: 'string', format: 'email' },
+            quiz_id: { type: ['number', 'null'], description: 'offer_type=digital : id du quiz a embarquer (list_quizzes), null pour le retirer' },
+            quiz_cta_label: { type: 'string', maxLength: 150 },
+            quiz_cta_subtext: { type: 'string', maxLength: 500 },
             is_published: { type: 'boolean' },
         },
         required: ['lab', 'shop_id'],
@@ -31,9 +32,10 @@ export const updateShopProductTool = {
         price_cents: z.number().int().min(0).nullable().optional(),
         offer_type: z.enum(['digital', 'calendar', 'formation']).optional(),
         course_id: z.number().int().positive().nullable().optional(),
-        payment_mode: z.enum(['external', 'stripe']).optional(),
-        payment_link_text: z.string().max(255).nullable().optional(),
         support_email: z.string().email().nullable().optional(),
+        quiz_id: z.number().int().positive().nullable().optional(),
+        quiz_cta_label: z.string().max(150).nullable().optional(),
+        quiz_cta_subtext: z.string().max(500).nullable().optional(),
         is_published: z.boolean().optional(),
     }),
     async handler(args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@connect-xlab/mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Serveur MCP pour piloter ton Lab ConnectXLab depuis Claude Desktop / Cursor / n'importe quel client MCP.",
   "type": "module",
   "main": "dist/index.js",