@connect-xlab/mcp-server 0.1.0

package/dist/tools/togglePlugin.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const togglePluginTool = {
+    name: 'toggle_plugin',
+    description: "Active ou desactive un plug-in par son meta_type. Valeurs typiques : 'facebook' (Meta Pixel), 'google' (Google Ads).",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            meta_type: { type: 'string', description: 'facebook | google | ...' },
+            enabled: { type: 'boolean' },
+        },
+        required: ['lab', 'meta_type', 'enabled'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({ lab: z.string(), meta_type: z.string(), enabled: z.boolean() }),
+    async handler(args) {
+        const parsed = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(parsed.lab)}/plugins/${encodeURIComponent(parsed.meta_type)}/toggle`, { enabled: parsed.enabled });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/unbanMember.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const unbanMemberTool = {
+    name: 'unban_member',
+    description: "Restaure un membre banni : status 'blocked' -> 'approved'. Idempotent.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            member_id: { type: 'number' },
+        },
+        required: ['lab', 'member_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({ lab: z.string(), member_id: z.number().int().positive() }),
+    async handler(args) {
+        const parsed = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(parsed.lab)}/members/${parsed.member_id}/unban`);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/unpublishPodcastEpisode.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const unpublishPodcastEpisodeTool = {
+    name: 'unpublish_podcast_episode',
+    description: "Depublie un episode (published -> draft + published_at=null). Le retire de la vue publique.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            show_id: { type: 'number' },
+            episode_id: { type: 'number' },
+        },
+        required: ['lab', 'show_id', 'episode_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        show_id: z.number().int().positive(),
+        episode_id: z.number().int().positive(),
+    }),
+    async handler(args) {
+        const p = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.patch(`/mcp/labs/${encodeURIComponent(p.lab)}/podcast/shows/${p.show_id}/episodes/${p.episode_id}/unpublish`);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/updateCategory.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateCategoryTool = {
+    name: 'update_category',
+    description: "Met a jour une categorie (nom, description, privee, niveau min). Champs optionnels.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            category_id: { type: 'number' },
+            name: { type: 'string', maxLength: 30 },
+            description: { type: 'string', maxLength: 255 },
+            is_private: { type: 'boolean' },
+            min_user_level: { type: 'number', minimum: 0 },
+        },
+        required: ['lab', 'category_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        category_id: z.number().int().positive(),
+        name: z.string().max(30).optional(),
+        description: z.string().max(255).optional(),
+        is_private: z.boolean().optional(),
+        min_user_level: z.number().int().min(0).nullable().optional(),
+    }),
+    async handler(args) {
+        const parsed = this.zodSchema.parse(args);
+        const { lab, category_id, ...body } = parsed;
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/categories/${category_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/updateClass.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateClassTool = {
+    name: 'update_class',
+    description: "Met a jour une classe/cours (nom, description, publication, prix, niveau min). Champs optionnels : n'envoie que ceux que tu veux changer. Toggle is_published pour publier/depublier.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            class_id: { type: 'number' },
+            name: { type: 'string', maxLength: 50 },
+            description: { type: 'string', maxLength: 400 },
+            access: { type: 'string', maxLength: 255, description: "'all' | 'paid' | autre valeur libre" },
+            min_user_level: { type: 'number', minimum: 0 },
+            is_published: { type: 'boolean' },
+            price: { type: 'string', description: "Prix en euros (chaine, ex '19.90'). null pour gratuit." },
+        },
+        required: ['lab', 'class_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        class_id: z.number().int().positive(),
+        name: z.string().max(50).optional(),
+        description: z.string().max(400).optional(),
+        access: z.string().max(255).optional(),
+        min_user_level: z.number().int().min(0).nullable().optional(),
+        is_published: z.boolean().optional(),
+        price: z.string().max(255).nullable().optional(),
+    }),
+    async handler(args) {
+        const parsed = this.zodSchema.parse(args);
+        const { lab, class_id, ...body } = parsed;
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/classes/${class_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/updateEvent.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateEventTool = {
+    name: 'update_event',
+    description: "Met a jour un evenement du calendrier (titre, description, date, duree, lien, reminder). Champs optionnels.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            event_id: { type: 'number' },
+            title: { type: 'string', maxLength: 50 },
+            description: { type: 'string' },
+            event_date: { type: 'string', description: 'ISO 8601 date' },
+            timezone: { type: 'string' },
+            duration: { type: 'string' },
+            link: { type: 'string' },
+            reminder_enabled: { type: 'boolean' },
+        },
+        required: ['lab', 'event_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        event_id: z.number().int().positive(),
+        title: z.string().max(50).optional(),
+        description: z.string().optional(),
+        event_date: z.string().optional(),
+        timezone: z.string().optional(),
+        duration: z.string().optional(),
+        link: z.string().nullable().optional(),
+        reminder_enabled: z.boolean().optional(),
+    }),
+    async handler(args) {
+        const parsed = this.zodSchema.parse(args);
+        const { lab, event_id, ...body } = parsed;
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/events/${event_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/updateLabLink.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateLabLinkTool = {
+    name: 'update_lab_link',
+    description: "Met a jour un lien sidebar (label ou url). Champs optionnels.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            link_id: { type: 'number' },
+            label: { type: 'string', maxLength: 30 },
+            url: { type: 'string', maxLength: 255 },
+        },
+        required: ['lab', 'link_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        link_id: z.number().int().positive(),
+        label: z.string().max(30).optional(),
+        url: z.string().max(255).optional(),
+    }),
+    async handler(args) {
+        const parsed = this.zodSchema.parse(args);
+        const { lab, link_id, ...body } = parsed;
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/links/${link_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/updateLabSettings.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateLabSettingsTool = {
+    name: 'update_lab_settings',
+    description: "Met a jour les settings d'un Lab. Tous les champs sont optionnels — n'envoie que ceux que tu veux changer. Attention : changer is_free ou monthly_price_eur impacte les futurs paiements. Demande confirmation user.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            name: { type: 'string', maxLength: 255 },
+            description: { type: 'string' },
+            full_description: { type: 'string' },
+            is_free: { type: 'boolean' },
+            monthly_price_eur: { type: 'number', minimum: 0 },
+            trial_period_days: { type: 'number', minimum: 0 },
+            trial_enabled: { type: 'boolean' },
+            affiliation_enabled: { type: 'boolean' },
+            affiliation_percent: { type: 'number', minimum: 0, maximum: 100 },
+        },
+        required: ['lab'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        name: z.string().max(255).optional(),
+        description: z.string().optional(),
+        full_description: z.string().optional(),
+        is_free: z.boolean().optional(),
+        monthly_price_eur: z.number().min(0).optional(),
+        trial_period_days: z.number().int().min(0).optional(),
+        trial_enabled: z.boolean().optional(),
+        affiliation_enabled: z.boolean().optional(),
+        affiliation_percent: z.number().int().min(0).max(100).optional(),
+    }),
+    async handler(args) {
+        const parsed = this.zodSchema.parse(args);
+        const { lab, ...body } = parsed;
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/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/updateLevel.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateLevelTool = {
+    name: 'update_level',
+    description: "Renomme un niveau XP ou modifie le seuil de points requis pour l'atteindre. Champs optionnels.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            level_id: { type: 'number' },
+            name: { type: 'string', maxLength: 255 },
+            points_threshold: { type: 'number', minimum: 0 },
+        },
+        required: ['lab', 'level_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        level_id: z.number().int().positive(),
+        name: z.string().max(255).optional(),
+        points_threshold: z.number().int().min(0).optional(),
+    }),
+    async handler(args) {
+        const parsed = this.zodSchema.parse(args);
+        const { lab, level_id, ...body } = parsed;
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/levels/${level_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/updatePodcastEpisode.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updatePodcastEpisodeTool = {
+    name: 'update_podcast_episode',
+    description: "Met a jour un episode podcast (titre, description, access, season). Champs optionnels.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            show_id: { type: 'number' },
+            episode_id: { type: 'number' },
+            title: { type: 'string', maxLength: 255 },
+            description: { type: 'string' },
+            access: { type: 'string', enum: ['free', 'premium'] },
+            season: { type: 'number', minimum: 1 },
+        },
+        required: ['lab', 'show_id', 'episode_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        show_id: z.number().int().positive(),
+        episode_id: z.number().int().positive(),
+        title: z.string().max(255).optional(),
+        description: z.string().nullable().optional(),
+        access: z.enum(['free', 'premium']).optional(),
+        season: z.number().int().min(1).optional(),
+    }),
+    async handler(args) {
+        const p = this.zodSchema.parse(args);
+        const { lab, show_id, episode_id, ...body } = p;
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/podcast/shows/${show_id}/episodes/${episode_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/updatePost.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updatePostTool = {
+    name: 'update_post',
+    description: "Modifie un post existant (titre / corps / categorie). Champs optionnels : n'envoie que ce que tu veux changer. IMPORTANT : action ecriture, demander confirmation.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            post_id: { type: 'number' },
+            title: { type: 'string', maxLength: 255 },
+            body: { type: 'string' },
+            category_id: { type: 'number' },
+        },
+        required: ['lab', 'post_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        post_id: z.number().int().positive(),
+        title: z.string().max(255).optional(),
+        body: z.string().optional(),
+        category_id: z.number().int().positive().optional(),
+    }),
+    async handler(args) {
+        const parsed = this.zodSchema.parse(args);
+        const { lab, post_id, ...body } = parsed;
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/posts/${post_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/updateShopProduct.js

@@ -0,0 +1,46 @@
+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). Champs optionnels. Prix en centimes.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            shop_id: { type: 'number' },
+            title: { type: 'string', maxLength: 255 },
+            short_description: { type: 'string' },
+            description: { type: 'string' },
+            price_cents: { type: 'number', minimum: 0 },
+            payment_mode: { type: 'string', enum: ['external', 'stripe'] },
+            payment_link_text: { type: 'string', maxLength: 255 },
+            support_email: { type: 'string', format: 'email' },
+            is_published: { type: 'boolean' },
+        },
+        required: ['lab', 'shop_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        shop_id: z.number().int().positive(),
+        title: z.string().max(255).optional(),
+        short_description: z.string().optional(),
+        description: z.string().optional(),
+        price_cents: z.number().int().min(0).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(),
+        is_published: z.boolean().optional(),
+    }),
+    async handler(args) {
+        const p = this.zodSchema.parse(args);
+        const { lab, shop_id, ...body } = p;
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/shops/${shop_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/updateSlug.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const updateSlugTool = {
+    name: 'update_slug',
+    description: "Change l'URL (slug) publique du Lab. Cooldown 30j entre 2 changements. IMPORTANT : les anciennes URLs partagees ne fonctionneront plus.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string' },
+            new_slug: { type: 'string', pattern: '^[a-zA-Z0-9_-]+$', description: 'Nouveau slug (alphanumeric + tirets/underscores)' },
+        },
+        required: ['lab', 'new_slug'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        new_slug: z.string().max(255).regex(/^[a-zA-Z0-9_-]+$/),
+    }),
+    async handler(args) {
+        const p = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(p.lab)}/slug`, { new_slug: p.new_slug });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@connect-xlab/mcp-server",
+  "version": "0.1.0",
+  "description": "Serveur MCP pour piloter ton Lab ConnectXLab depuis Claude Desktop / Cursor / n'importe quel client MCP.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": { "connectxlab-mcp": "dist/index.js" },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": { "node": ">=20" },
+  "keywords": ["mcp", "model-context-protocol", "connectxlab", "claude"],
+  "author": "ConnectXLab",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.7.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0"
+  }
+}