@clipform/mcp-server 1.0.0 → 1.1.0

package/dist/tools/get-daily-content.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetDailyContentTool(server: McpServer): void;

package/dist/tools/get-daily-content.js

@@ -0,0 +1,66 @@
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+function truncate(text, maxLength = 500) {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength - 3) + "...";
+}
+export function registerGetDailyContentTool(server) {
+    server.registerTool("formgen_get_daily_content", {
+        title: "Get Daily Content",
+        description: `Get today's rotating content for quiz generation. Returns NASA's Astronomy Picture of the Day and Wikipedia's featured content (featured article, "on this day" events, most-read articles, current news). Great for generating daily quizzes with fresh content.`,
+        inputSchema: {},
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async () => {
+        const result = await callInternalApi("/internal/formgen/get-daily-content", {});
+        if (!result.ok)
+            return errorResult(result.error);
+        const daily = result.data.daily;
+        const lines = [];
+        if (daily.nasaApod) {
+            const a = daily.nasaApod;
+            lines.push("## NASA Astronomy Picture of the Day");
+            lines.push(`Title: ${a.title}`);
+            lines.push(`Date: ${a.date}`);
+            lines.push(`Type: ${a.mediaType}`);
+            lines.push(`URL: ${a.url}`);
+            if (a.hdUrl)
+                lines.push(`HD URL: ${a.hdUrl}`);
+            lines.push(`Explanation: ${truncate(a.explanation, 400)}`);
+            if (a.copyright)
+                lines.push(`Copyright: ${a.copyright}`);
+            lines.push("");
+        }
+        if (daily.wikipedia) {
+            const w = daily.wikipedia;
+            if (w.todaysFeaturedArticle) {
+                lines.push("## Wikipedia Featured Article");
+                lines.push(`Title: ${w.todaysFeaturedArticle.title}`);
+                lines.push(truncate(w.todaysFeaturedArticle.extract, 300));
+                lines.push("");
+            }
+            if (w.onThisDay?.length > 0) {
+                lines.push(`## On This Day (${w.onThisDay.length} events)`);
+                for (const event of w.onThisDay.slice(0, 8)) {
+                    lines.push(`- ${event.year}: ${event.text}`);
+                }
+                lines.push("");
+            }
+            if (w.mostRead?.length > 0) {
+                lines.push(`## Most Read Today (top 10)`);
+                for (const article of w.mostRead.slice(0, 10)) {
+                    lines.push(`- ${article.title}: ${truncate(article.extract, 100)}`);
+                }
+                lines.push("");
+            }
+            if (w.newsItems?.length > 0) {
+                lines.push(`## In The News`);
+                for (const item of w.newsItems.slice(0, 5)) {
+                    lines.push(`- ${item.story}`);
+                }
+                lines.push("");
+            }
+        }
+        return textResult(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=get-daily-content.js.map

package/dist/tools/get-daily-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-daily-content.js","sourceRoot":"","sources":["../../src/tools/get-daily-content.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-question-media.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetQuestionMediaTool(server: McpServer): void;

package/dist/tools/get-question-media.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { callApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerGetQuestionMediaTool(server) {
+    server.registerTool("clipform_get_question_media", {
+        title: "Get Question Media",
+        description: `Get the media attached to a question, including processing status. Useful for checking if a video upload has finished processing.`,
+        inputSchema: {
+            form_id: z.string().describe("The form ID"),
+            edit_token: z.string().describe("The edit token"),
+            question_id: z.string().describe("The question ID"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ form_id, edit_token, question_id }) => {
+        const result = await callApi(`/forms/${form_id}/questions/${question_id}/media`, {
+            method: "GET",
+            token: edit_token,
+        });
+        if (!result.ok) {
+            return errorResult(result.error);
+        }
+        const media = result.data.media;
+        if (!media) {
+            return textResult("No media attached to this question.");
+        }
+        return textResult(`Media ID: ${media.id}\n` +
+            `Type: ${media.media_type}\n` +
+            `Status: ${media.status}\n` +
+            (media.playback_id ? `Playback ID: ${media.playback_id}\n` : "") +
+            (media.storage_path ? `Storage path: ${media.storage_path}\n` : "") +
+            (media.duration ? `Duration: ${media.duration}s\n` : "") +
+            `Transcription: ${media.transcription_status}`);
+    });
+}
+//# sourceMappingURL=get-question-media.js.map

package/dist/tools/get-question-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-question-media.js","sourceRoot":"","sources":["../../src/tools/get-question-media.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,mIAAmI;QAChJ,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SACpD;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,UAAU,OAAO,cAAc,WAAW,QAAQ,EAClD;YACE,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,UAAU;SAClB,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAuC,CAAC;QAClE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,UAAU,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,UAAU,CACf,aAAa,KAAK,CAAC,EAAE,IAAI;YACvB,SAAS,KAAK,CAAC,UAAU,IAAI;YAC7B,WAAW,KAAK,CAAC,MAAM,IAAI;YAC3B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,kBAAkB,KAAK,CAAC,oBAAoB,EAAE,CACjD,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-trivia.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetTriviaTool(server: McpServer): void;

package/dist/tools/get-trivia.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+const CATEGORIES = [
+    "General Knowledge", "Entertainment: Books", "Entertainment: Film",
+    "Entertainment: Music", "Entertainment: Musicals & Theatres",
+    "Entertainment: Television", "Entertainment: Video Games",
+    "Entertainment: Board Games", "Science & Nature", "Science: Computers",
+    "Science: Mathematics", "Science: Gadgets", "Mythology", "Sports",
+    "Geography", "History", "Politics", "Art", "Celebrities", "Animals",
+    "Vehicles", "Entertainment: Comics", "Entertainment: Japanese Anime & Manga",
+    "Entertainment: Cartoon & Animations",
+];
+export function registerGetTriviaTool(server) {
+    server.registerTool("formgen_get_trivia", {
+        title: "Get Trivia Questions",
+        description: `Get ready-made trivia questions from the Open Trivia Database (4,000+ questions across 24 categories). NOT keyword-searchable - works by category and difficulty only. Each question includes the correct answer, incorrect answers, category, and difficulty level.
+
+Available categories: ${CATEGORIES.join(", ")}`,
+        inputSchema: {
+            amount: z.number().min(1).max(50).default(10).optional()
+                .describe("Number of questions (default 10)"),
+            category: z.string().optional()
+                .describe("Category name (must match exactly from the list)"),
+            difficulty: z.enum(["easy", "medium", "hard"]).optional()
+                .describe("Difficulty level"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async ({ amount, category, difficulty }) => {
+        const result = await callInternalApi("/internal/formgen/get-trivia", {
+            body: { amount, category, difficulty },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const results = result.data.results;
+        if (!results.length)
+            return textResult("No trivia questions returned. Try a different category or fewer questions.");
+        const lines = [`${results.length} trivia questions:\n`];
+        for (let i = 0; i < results.length; i++) {
+            const q = results[i];
+            lines.push(`${i + 1}. [${q.difficulty}] ${q.question}`);
+            lines.push(`   Correct: ${q.correctAnswer}`);
+            lines.push(`   Wrong: ${q.incorrectAnswers.join(", ")}`);
+            lines.push(`   Category: ${q.category}`);
+            lines.push("");
+        }
+        return textResult(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=get-trivia.js.map

package/dist/tools/get-trivia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trivia.js","sourceRoot":"","sources":["../../src/tools/get-trivia.ts"],"names":[],"mappings":"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"}

package/dist/tools/log-generation.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLogGenerationTool(server: McpServer): void;

package/dist/tools/log-generation.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerLogGenerationTool(server) {
+    server.registerTool("clipform_log_generation", {
+        title: "Log Form Generation Audit",
+        description: `Save an audit trail for a generated form. Records where content came from - the sources and image attributions. Call this as the final step after building a form or quiz.`,
+        inputSchema: {
+            form_id: z.string().describe("The form ID"),
+            edit_token: z.string().describe("The edit token"),
+            summary: z.string().describe("Short description of what was generated"),
+            details: z.object({
+                sources: z.array(z.object({
+                    title: z.string(),
+                    url: z.string().optional(),
+                    type: z.string().optional(),
+                })).optional().describe("Knowledge sources used"),
+                images: z.array(z.object({
+                    url: z.string(),
+                    attribution: z.string().optional(),
+                    license: z.string().optional(),
+                })).optional().describe("Images used with attribution"),
+            }).describe("Content sources and attributions"),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ form_id, edit_token, summary, details }) => {
+        const result = await callInternalApi("/internal/formgen/log-generation", {
+            body: { form_id, summary, details },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        return textResult(`Audit log saved for form ${form_id}\nSummary: ${summary}`);
+    });
+}
+//# sourceMappingURL=log-generation.js.map

package/dist/tools/log-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-generation.js","sourceRoot":"","sources":["../../src/tools/log-generation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,4KAA4K;QACzL,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YACvE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;gBAChB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;oBACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;oBACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC5B,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;gBACjD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;oBACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;oBACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC/B,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;aACxD,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;SAChD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1G,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,kCAAkC,EAAE;YACvE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,OAAO,UAAU,CAAC,4BAA4B,OAAO,cAAc,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/lookup-country.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLookupCountryTool(server: McpServer): void;

package/dist/tools/lookup-country.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerLookupCountryTool(server) {
+    server.registerTool("formgen_lookup_country", {
+        title: "Lookup Country",
+        description: `Look up country data by name. Returns structured info including capital, population, languages, currencies, flag URLs, borders, and timezones. Partial name matching works (e.g. "united" returns United Kingdom, United States, etc.). Useful for geography quiz questions.`,
+        inputSchema: {
+            name: z.string().describe("Country name or partial name (e.g. 'France', 'united', 'japan')"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ name }) => {
+        const result = await callInternalApi("/internal/formgen/lookup-country", {
+            body: { name },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const country = result.data.country;
+        if (!country)
+            return textResult(`No country found for "${name}".`);
+        const lines = [
+            `Country: ${country.name}`,
+            `Official name: ${country.officialName}`,
+            `Capital: ${country.capital || "N/A"}`,
+            `Region: ${country.region}${country.subregion ? ` (${country.subregion})` : ""}`,
+            `Population: ${Number(country.population).toLocaleString()}`,
+            `Area: ${country.area ? `${Number(country.area).toLocaleString()} km²` : "N/A"}`,
+            `Languages: ${country.languages?.join(", ") || "N/A"}`,
+            `Currencies: ${country.currencies?.map((c) => `${c.name} (${c.symbol})`).join(", ") || "N/A"}`,
+            `Timezones: ${country.timezones?.join(", ")}`,
+            `Borders: ${country.borders?.join(", ") || "None (island/isolated)"}`,
+            `Flag (PNG): ${country.flagPng}`,
+            `Flag (SVG): ${country.flagSvg}`,
+            country.coatOfArmsUrl ? `Coat of arms: ${country.coatOfArmsUrl}` : "",
+        ].filter(Boolean);
+        return textResult(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=lookup-country.js.map

package/dist/tools/lookup-country.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-country.js","sourceRoot":"","sources":["../../src/tools/lookup-country.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,8QAA8Q;QAC3R,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;SAC7F;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACvG,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,kCAAkC,EAAE;YACvE,IAAI,EAAE,EAAE,IAAI,EAAE;SACf,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,OAAO,GAAI,MAAM,CAAC,IAAY,CAAC,OAAO,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,UAAU,CAAC,yBAAyB,IAAI,IAAI,CAAC,CAAC;QAEnE,MAAM,KAAK,GAAG;YACZ,YAAY,OAAO,CAAC,IAAI,EAAE;YAC1B,kBAAkB,OAAO,CAAC,YAAY,EAAE;YACxC,YAAY,OAAO,CAAC,OAAO,IAAI,KAAK,EAAE;YACtC,WAAW,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAChF,eAAe,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,cAAc,EAAE,EAAE;YAC5D,SAAS,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE;YAChF,cAAc,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE;YACtD,eAAe,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE;YACnG,cAAc,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YAC7C,YAAY,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,wBAAwB,EAAE;YACrE,eAAe,OAAO,CAAC,OAAO,EAAE;YAChC,eAAe,OAAO,CAAC,OAAO,EAAE;YAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;SACtE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAElB,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/search-images.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchImagesTool(server: McpServer): void;

package/dist/tools/search-images.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerSearchImagesTool(server) {
+    server.registerTool("formgen_search_images", {
+        title: "Search Images",
+        description: `Search for royalty-free images across multiple providers (Pexels, Unsplash, Pixabay, Wikimedia Commons, NASA, iNaturalist). Automatically routes to the most relevant providers based on the query topic. Returns image URLs you can use with clipform_upload_media or clipform_generate_slideshow.`,
+        inputSchema: {
+            query: z.string().describe("Search query (e.g. 'komodo dragon', 'saturn rings', 'french cuisine')"),
+            count: z.number().min(1).max(20).default(6).optional()
+                .describe("Max results per provider (default 6)"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ query, count }) => {
+        const result = await callInternalApi("/internal/formgen/search-images", {
+            body: { query, count },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const results = result.data.results;
+        if (!results.length)
+            return textResult(`No images found for "${query}".`);
+        const lines = [`Found ${results.length} images for "${query}":\n`];
+        for (const img of results.slice(0, 15)) {
+            lines.push(`- [${img.source}] ${img.title}`);
+            lines.push(`  URL: ${img.url}`);
+            if (img.width && img.height)
+                lines.push(`  Size: ${img.width}x${img.height}`);
+            if (img.attribution)
+                lines.push(`  Attribution: ${img.attribution}`);
+            lines.push(`  License: ${img.license}`);
+            lines.push("");
+        }
+        return textResult(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=search-images.js.map

package/dist/tools/search-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-images.js","sourceRoot":"","sources":["../../src/tools/search-images.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,qSAAqS;QAClT,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;YACnG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACnD,QAAQ,CAAC,sCAAsC,CAAC;SACpD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACvG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,iCAAiC,EAAE;YACtE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,OAAO,GAAI,MAAM,CAAC,IAAY,CAAC,OAAgB,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC,wBAAwB,KAAK,IAAI,CAAC,CAAC;QAE1E,MAAM,KAAK,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,gBAAgB,KAAK,MAAM,CAAC,CAAC;QACnE,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YAChC,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,IAAI,GAAG,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACrE,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/search-knowledge.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchKnowledgeTool(server: McpServer): void;

package/dist/tools/search-knowledge.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+function truncate(text, maxLength = 500) {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength - 3) + "...";
+}
+export function registerSearchKnowledgeTool(server) {
+    server.registerTool("formgen_search_knowledge", {
+        title: "Search Knowledge",
+        description: `Search Wikipedia for encyclopaedia-quality information about a topic. Returns article summaries with thumbnails. Use this to research a topic before crafting quiz questions.`,
+        inputSchema: {
+            query: z.string().describe("Topic to research (e.g. 'komodo dragon', 'black holes', 'French Revolution')"),
+            count: z.number().min(1).max(10).default(3).optional()
+                .describe("Number of articles to return (default 3)"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ query, count }) => {
+        const result = await callInternalApi("/internal/formgen/search-knowledge", {
+            body: { query, count },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const results = result.data.results;
+        if (!results.length)
+            return textResult(`No knowledge articles found for "${query}".`);
+        const lines = [`Found ${results.length} articles for "${query}":\n`];
+        for (const article of results) {
+            lines.push(`## ${article.title}`);
+            lines.push(truncate(article.summary, 600));
+            if (article.thumbnailUrl)
+                lines.push(`Thumbnail: ${article.thumbnailUrl}`);
+            if (article.sourceUrl)
+                lines.push(`Source: ${article.sourceUrl}`);
+            lines.push("");
+        }
+        return textResult(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=search-knowledge.js.map

package/dist/tools/search-knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-knowledge.js","sourceRoot":"","sources":["../../src/tools/search-knowledge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhF,SAAS,QAAQ,CAAC,IAAY,EAAE,SAAS,GAAG,GAAG;IAC7C,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,+KAA+K;QAC5L,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;YAC1G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACnD,QAAQ,CAAC,0CAA0C,CAAC;SACxD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACvG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,oCAAoC,EAAE;YACzE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,OAAO,GAAI,MAAM,CAAC,IAAY,CAAC,OAAgB,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC,oCAAoC,KAAK,IAAI,CAAC,CAAC;QAEtF,MAAM,KAAK,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,kBAAkB,KAAK,MAAM,CAAC,CAAC;QACrE,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YAC3C,IAAI,OAAO,CAAC,YAAY;gBAAE,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;YAC3E,IAAI,OAAO,CAAC,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/search-news.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchNewsTool(server: McpServer): void;

package/dist/tools/search-news.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerSearchNewsTool(server) {
+    server.registerTool("formgen_search_news", {
+        title: "Search News",
+        description: `Search for current news articles from NewsAPI and The Guardian. Use this to find trending topics, recent events, and current affairs for topical quiz content.`,
+        inputSchema: {
+            query: z.string().describe("News search query (e.g. 'climate change', 'space exploration', 'UK politics')"),
+            count: z.number().min(1).max(15).default(5).optional()
+                .describe("Max results per provider (default 5)"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ query, count }) => {
+        const result = await callInternalApi("/internal/formgen/search-news", {
+            body: { query, count },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const results = result.data.results;
+        if (!results.length)
+            return textResult(`No news articles found for "${query}".`);
+        const lines = [`Found ${results.length} articles for "${query}":\n`];
+        for (const article of results) {
+            lines.push(`- [${article.source}] ${article.title}`);
+            if (article.description)
+                lines.push(`  ${article.description}`);
+            if (article.author)
+                lines.push(`  Author: ${article.author}`);
+            lines.push(`  Date: ${article.publishedAt}`);
+            lines.push(`  URL: ${article.url}`);
+            if (article.imageUrl)
+                lines.push(`  Image: ${article.imageUrl}`);
+            lines.push("");
+        }
+        return textResult(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=search-news.js.map

package/dist/tools/search-news.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-news.js","sourceRoot":"","sources":["../../src/tools/search-news.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,gKAAgK;QAC7K,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;YAC3G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACnD,QAAQ,CAAC,sCAAsC,CAAC;SACpD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACvG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,+BAA+B,EAAE;YACpE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,OAAO,GAAI,MAAM,CAAC,IAAY,CAAC,OAAgB,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC,+BAA+B,KAAK,IAAI,CAAC,CAAC;QAEjF,MAAM,KAAK,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,kBAAkB,KAAK,MAAM,CAAC,CAAC;QACrE,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACrD,IAAI,OAAO,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;YAChE,IAAI,OAAO,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACpC,IAAI,OAAO,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/search-videos.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchVideosTool(server: McpServer): void;

package/dist/tools/search-videos.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerSearchVideosTool(server) {
+    server.registerTool("formgen_search_videos", {
+        title: "Search Videos",
+        description: `Search for royalty-free stock video clips from Pexels and Pixabay. Returns video URLs with duration and resolution info.`,
+        inputSchema: {
+            query: z.string().describe("Search query (e.g. 'ocean waves', 'city timelapse')"),
+            count: z.number().min(1).max(10).default(3).optional()
+                .describe("Max results per provider (default 3)"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ query, count }) => {
+        const result = await callInternalApi("/internal/formgen/search-videos", {
+            body: { query, count },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const results = result.data.results;
+        if (!results.length)
+            return textResult(`No videos found for "${query}".`);
+        const lines = [`Found ${results.length} videos for "${query}":\n`];
+        for (const vid of results) {
+            lines.push(`- [${vid.source}] ${vid.title}`);
+            lines.push(`  URL: ${vid.url}`);
+            if (vid.duration)
+                lines.push(`  Duration: ${vid.duration}s`);
+            if (vid.width && vid.height)
+                lines.push(`  Resolution: ${vid.width}x${vid.height}`);
+            if (vid.attribution)
+                lines.push(`  Attribution: ${vid.attribution}`);
+            lines.push("");
+        }
+        return textResult(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=search-videos.js.map

package/dist/tools/search-videos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-videos.js","sourceRoot":"","sources":["../../src/tools/search-videos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,0HAA0H;QACvI,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;YACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACnD,QAAQ,CAAC,sCAAsC,CAAC;SACpD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACvG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,iCAAiC,EAAE;YACtE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,OAAO,GAAI,MAAM,CAAC,IAAY,CAAC,OAAgB,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC,wBAAwB,KAAK,IAAI,CAAC,CAAC;QAE1E,MAAM,KAAK,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,gBAAgB,KAAK,MAAM,CAAC,CAAC;QACnE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YAChC,IAAI,GAAG,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACpF,IAAI,GAAG,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/set-question-logic.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSetQuestionLogicTool(server: McpServer): void;

package/dist/tools/set-question-logic.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { callApi, errorResult, textResult } from "../lib/api-client.js";
+const LogicRuleSchema = z.object({
+    option_content: z
+        .string()
+        .optional()
+        .describe("The option text to match. Omit for a default rule (applies to all unmatched options)."),
+    target_question_id: z
+        .string()
+        .describe("The question ID to jump to when this rule matches"),
+});
+export function registerSetQuestionLogicTool(server) {
+    server.registerTool("clipform_set_logic", {
+        title: "Set Question Logic",
+        description: `Set branching logic on a question. Routes respondents to different questions based on their answer.
+
+Each rule maps an option (by its text content) to a target question. Rules without option_content are "default" rules applied to all unmatched options.
+
+Example: Route correct answer to a "Well done" node, everything else to "Wrong":
+  rules: [
+    { option_content: "42", target_question_id: "well-done-id" },
+    { target_question_id: "wrong-id" }
+  ]`,
+        inputSchema: {
+            form_id: z.string().describe("The form ID"),
+            edit_token: z.string().describe("The edit token"),
+            question_id: z
+                .string()
+                .describe("The question ID to set logic on"),
+            rules: z
+                .array(LogicRuleSchema)
+                .min(1)
+                .describe("Branching rules. Each maps an option or default to a target question."),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ form_id, edit_token, question_id, rules }) => {
+        const result = await callApi(`/forms/${form_id}/questions/${question_id}/logic`, {
+            method: "PUT",
+            token: edit_token,
+            body: { rules },
+        });
+        if (!result.ok) {
+            return errorResult(result.error);
+        }
+        return textResult(`Logic set on question ${question_id}.\n` +
+            `Rules created: ${result.data.rules_count}`);
+    });
+}
+//# sourceMappingURL=set-question-logic.js.map

package/dist/tools/set-question-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-question-logic.js","sourceRoot":"","sources":["../../src/tools/set-question-logic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uFAAuF,CACxF;IACH,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,QAAQ,CAAC,mDAAmD,CAAC;CACjE,CAAC,CAAC;AAEH,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE;;;;;;;;IAQf;QACE,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACjD,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,iCAAiC,CAAC;YAC9C,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,eAAe,CAAC;iBACtB,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,uEAAuE,CAAC;SACrF;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE;QACpD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,UAAU,OAAO,cAAc,WAAW,QAAQ,EAClD;YACE,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,EAAE,KAAK,EAAE;SAChB,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,UAAU,CACf,yBAAyB,WAAW,KAAK;YACvC,kBAAkB,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAC9C,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/upload-question-media.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerUploadQuestionMediaTool(server: McpServer): void;

package/dist/tools/upload-question-media.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { callApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerUploadQuestionMediaTool(server) {
+    server.registerTool("clipform_upload_question_media", {
+        title: "Upload Question Media",
+        description: `Initiate a media upload for a question. Returns a signed upload URL - upload the file directly to that URL. Only works on question types that support media (choice, open, scale, button). For video: returns a Mux TUS upload URL. For image: returns a Supabase presigned PUT URL.`,
+        inputSchema: {
+            form_id: z.string().describe("The form ID"),
+            edit_token: z.string().describe("The edit token"),
+            question_id: z.string().describe("The question ID"),
+            media_type: z
+                .enum(["video", "still"])
+                .describe("Type of media to upload"),
+            media_source: z
+                .enum(["uploaded", "recorded"])
+                .default("uploaded")
+                .describe("How the media was created"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ form_id, edit_token, question_id, media_type, media_source }) => {
+        const result = await callApi(`/forms/${form_id}/questions/${question_id}/media`, {
+            method: "POST",
+            token: edit_token,
+            body: { media_type, media_source },
+        });
+        if (!result.ok) {
+            return errorResult(result.error);
+        }
+        return textResult(`Media upload initiated.\n` +
+            `Media ID: ${result.data.media_id}\n` +
+            `Upload URL: ${result.data.upload_url}\n` +
+            `Upload method: ${result.data.upload_method}\n` +
+            `Upload the file directly to the upload URL using ${result.data.upload_method === "tus" ? "TUS resumable upload" : "HTTP PUT"}.`);
+    });
+}
+//# sourceMappingURL=upload-question-media.js.map

package/dist/tools/upload-question-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-question-media.js","sourceRoot":"","sources":["../../src/tools/upload-question-media.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC/D,MAAM,CAAC,YAAY,CACjB,gCAAgC,EAChC;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,sRAAsR;QACnS,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACnD,UAAU,EAAE,CAAC;iBACV,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;iBACxB,QAAQ,CAAC,yBAAyB,CAAC;YACtC,YAAY,EAAE,CAAC;iBACZ,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;iBAC9B,OAAO,CAAC,UAAU,CAAC;iBACnB,QAAQ,CAAC,2BAA2B,CAAC;SACzC;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE;QACvE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,UAAU,OAAO,cAAc,WAAW,QAAQ,EAClD;YACE,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE;SACnC,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,UAAU,CACf,2BAA2B;YACzB,aAAa,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI;YACrC,eAAe,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI;YACzC,kBAAkB,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI;YAC/C,oDAAoD,MAAM,CAAC,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,UAAU,GAAG,CACnI,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipform/mcp-server",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for building and managing Clipform video forms",
   "license": "MIT",
   "repository": {
@@ -10,6 +10,10 @@
   },
   "type": "module",
   "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./server": "./dist/server.js"
+  },
   "bin": {
     "mcp-server-clipform": "dist/index.js"
   },