quizfunnel-mcp 1.0.0

package/build/index.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+const API_KEY = process.env.QUIZFUNNEL_API_KEY;
+const BASE_URL = (process.env.QUIZFUNNEL_APP_URL || 'https://quizfunnel-dusky.vercel.app').replace(/\/$/, '');
+if (!API_KEY) {
+    console.error('QuizFunnel MCP: QUIZFUNNEL_API_KEY manquant.');
+    console.error('Générez une clé dans QuizFunnel → Comptes Plateformes → Clés API (MCP)');
+    process.exit(1);
+}
+// ─── HTTP helper ────────────────────────────────────────────────────────────
+async function api(method, path, body) {
+    const res = await fetch(`${BASE_URL}/api/v1${path}`, {
+        method,
+        headers: {
+            'Authorization': `Bearer ${API_KEY}`,
+            'Content-Type': 'application/json',
+        },
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    const data = await res.json();
+    if (!res.ok)
+        throw new Error(data.error || `HTTP ${res.status}`);
+    return data;
+}
+function ok(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function json(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+// ─── server ─────────────────────────────────────────────────────────────────
+const server = new McpServer({ name: 'quizfunnel', version: '2.0.0' });
+server.registerTool('list_quizzes', {
+    description: 'Liste tous tes quiz avec statut et URLs.',
+    inputSchema: {},
+}, async () => json(await api('GET', '/quizzes')));
+server.registerTool('get_quiz', {
+    description: 'Récupère la structure complète d\'un quiz : étapes, options, style.',
+    inputSchema: { quiz_id: z.string().describe('ID du quiz') },
+}, async ({ quiz_id }) => json(await api('GET', `/quizzes/${quiz_id}`)));
+server.registerTool('create_quiz', {
+    description: 'Crée un nouveau quiz vide.',
+    inputSchema: { title: z.string().describe('Titre du quiz') },
+}, async ({ title }) => {
+    const data = await api('POST', '/quizzes', { title });
+    return ok(`✅ Quiz créé — ID: ${data.id}\nBuilder: ${BASE_URL}/quizzes/${data.id}/builder`);
+});
+server.registerTool('update_quiz_title', {
+    description: 'Renomme un quiz.',
+    inputSchema: {
+        quiz_id: z.string(),
+        title: z.string().describe('Nouveau titre'),
+    },
+}, async ({ quiz_id, title }) => {
+    await api('PATCH', `/quizzes/${quiz_id}`, { title });
+    return ok(`✅ Quiz renommé en "${title}"`);
+});
+server.registerTool('publish_quiz', {
+    description: 'Publie ou dépublie un quiz.',
+    inputSchema: {
+        quiz_id: z.string(),
+        publish: z.boolean().describe('true=publier, false=brouillon'),
+    },
+}, async ({ quiz_id, publish }) => {
+    const data = await api('POST', `/quizzes/${quiz_id}/publish`, { publish });
+    return ok(publish ? `✅ Quiz publié — ${BASE_URL}/q/${quiz_id}` : `✅ Quiz dépublié (brouillon)`);
+});
+server.registerTool('delete_quiz', {
+    description: 'Supprime définitivement un quiz.',
+    inputSchema: {
+        quiz_id: z.string(),
+        confirm: z.boolean().describe('Doit être true'),
+    },
+}, async ({ quiz_id, confirm }) => {
+    if (!confirm)
+        return ok('Annulé. Passe confirm: true.');
+    await api('DELETE', `/quizzes/${quiz_id}`);
+    return ok(`✅ Quiz supprimé.`);
+});
+server.registerTool('add_questions', {
+    description: 'Ajoute une ou plusieurs questions avec leurs options de réponse.',
+    inputSchema: {
+        quiz_id: z.string(),
+        questions: z.array(z.object({
+            title: z.string().describe('Texte de la question'),
+            question_type: z.enum(['single_choice', 'multiple_choice']),
+            options: z.array(z.object({
+                label: z.string(),
+                image_url: z.string().optional(),
+                tag: z.string().optional().describe('Ex: qualifie, chaud, debutant'),
+            })).min(2),
+        })),
+    },
+}, async ({ quiz_id, questions }) => {
+    const created = await api('POST', `/quizzes/${quiz_id}/steps`, questions);
+    const lines = questions.map((q) => `  • "${q.title}" (${q.options.length} options)`);
+    return ok(`✅ ${questions.length} question(s) ajoutée(s) :\n${lines.join('\n')}`);
+});
+server.registerTool('add_trust_card', {
+    description: 'Ajoute une carte de confiance / preuve sociale.',
+    inputSchema: {
+        quiz_id: z.string(),
+        card_title: z.string().describe('Ex: "97% de nos clients sont satisfaits"'),
+        description: z.string().optional(),
+    },
+}, async ({ quiz_id, card_title, description }) => {
+    await api('POST', `/quizzes/${quiz_id}/steps`, [{ type: 'trust_card', card_title, description }]);
+    return ok(`✅ Carte ajoutée : "${card_title}"`);
+});
+server.registerTool('update_question', {
+    description: 'Modifie titre et/ou options d\'une question existante.',
+    inputSchema: {
+        quiz_id: z.string(),
+        step_id: z.string().describe('ID de l\'étape (obtenu via get_quiz)'),
+        title: z.string().optional(),
+        question_type: z.enum(['single_choice', 'multiple_choice']).optional(),
+        options: z.array(z.object({
+            label: z.string(),
+            image_url: z.string().optional(),
+            tag: z.string().optional(),
+        })).optional().describe('Remplace toutes les options si fourni'),
+    },
+}, async ({ quiz_id, step_id, title, question_type, options }) => {
+    await api('PATCH', `/quizzes/${quiz_id}/steps/${step_id}`, { title, question_type, options });
+    return ok(`✅ Question mise à jour.`);
+});
+server.registerTool('delete_step', {
+    description: 'Supprime une étape (question ou carte).',
+    inputSchema: {
+        quiz_id: z.string(),
+        step_id: z.string().describe('ID de l\'étape'),
+    },
+}, async ({ quiz_id, step_id }) => {
+    await api('DELETE', `/quizzes/${quiz_id}/steps/${step_id}`);
+    return ok(`✅ Étape supprimée.`);
+});
+server.registerTool('clear_quiz', {
+    description: 'Supprime toutes les étapes d\'un quiz.',
+    inputSchema: {
+        quiz_id: z.string(),
+        confirm: z.boolean(),
+    },
+}, async ({ quiz_id, confirm }) => {
+    if (!confirm)
+        return ok('Annulé. Passe confirm: true.');
+    const quiz = await api('GET', `/quizzes/${quiz_id}`);
+    const count = quiz.steps?.length || 0;
+    for (const step of quiz.steps || []) {
+        await api('DELETE', `/quizzes/${quiz_id}/steps/${step.id}`);
+    }
+    return ok(`✅ Quiz vidé — ${count} étape(s) supprimée(s).`);
+});
+server.registerTool('update_style', {
+    description: 'Modifie le style visuel : couleurs, fond, police, bouton.',
+    inputSchema: {
+        quiz_id: z.string(),
+        background_type: z.enum(['solid', 'gradient']).optional(),
+        background_color: z.string().optional().describe('Hex, ex: "#ffffff"'),
+        gradient_from: z.string().optional(),
+        gradient_to: z.string().optional(),
+        button_color: z.string().optional().describe('Hex, ex: "#E53935"'),
+        button_text_color: z.string().optional(),
+        progress_bar_color: z.string().optional(),
+        font_family: z.enum(['Inter', 'Poppins', 'Roboto', 'Montserrat', 'Playfair Display']).optional(),
+        border_radius: z.number().min(0).max(32).optional(),
+        shadow_enabled: z.boolean().optional(),
+    },
+}, async ({ quiz_id, ...style }) => {
+    const res = await api('PATCH', `/quizzes/${quiz_id}/style`, style);
+    const parts = (res.updated || []).map((k) => `  • ${k}: ${style[k]}`);
+    return ok(`🎨 Style mis à jour :\n${parts.join('\n')}`);
+});
+server.registerTool('get_leads', {
+    description: 'Récupère les leads d\'un quiz.',
+    inputSchema: {
+        quiz_id: z.string(),
+        limit: z.number().min(1).max(100).default(20),
+    },
+}, async ({ quiz_id, limit }) => json(await api('GET', `/quizzes/${quiz_id}/leads?limit=${limit}`)));
+server.registerTool('get_analytics', {
+    description: 'Stats du funnel : vues, complétions, drop-off par étape.',
+    inputSchema: { quiz_id: z.string() },
+}, async ({ quiz_id }) => json(await api('GET', `/quizzes/${quiz_id}/analytics`)));
+// ─── start ───────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('QuizFunnel MCP v2 running — connected to', BASE_URL);
+}
+main().catch((err) => { console.error('Fatal:', err); process.exit(1); });

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "quizfunnel-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for QuizFunnel — build quiz funnels by talking to Claude",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "quizfunnel-mcp": "build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js",
+    "prepublishOnly": "npm run build",
+    "start": "node build/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.25.42"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["mcp", "claude", "quizfunnel", "quiz", "funnel", "marketing"],
+  "license": "MIT"
+}