@clipform/mcp-server 1.0.0 → 1.1.3

package/dist/tools/attach-question-audio.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { callApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerAttachQuestionAudioTool(server) {
+    server.registerTool("clipform_attach_audio", {
+        title: "Attach Audio to Question",
+        description: `Attach a sound effect or audio file to a question with existing media (stills only). The audio auto-plays once when a respondent reaches this question. Provide a public URL to the audio file (WAV, MP3, or OGG). The question must already have media uploaded (use clipform_upload_question_media first).`,
+        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 (must already have media attached)"),
+            url: z
+                .string()
+                .url()
+                .describe("Public URL to the audio file (WAV, MP3, or OGG)"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ form_id, edit_token, question_id, url }) => {
+        const result = await callApi(`/forms/${form_id}/questions/${question_id}/audio`, {
+            method: "PUT",
+            token: edit_token,
+            body: { url },
+        });
+        if (!result.ok) {
+            return errorResult(result.error);
+        }
+        return textResult(`Audio attached to question ${question_id}.\n` +
+            `Audio path: ${result.data.audio_storage_path}`);
+    });
+}
+//# sourceMappingURL=attach-question-audio.js.map

package/dist/tools/attach-question-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-question-audio.js","sourceRoot":"","sources":["../../src/tools/attach-question-audio.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,uBAAuB,EACvB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,8SAA8S;QAC3T,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,oDAAoD,CAAC;YACjE,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,CAAC,iDAAiD,CAAC;SAC/D;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,GAAG,EAAE,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,UAAU,OAAO,cAAc,WAAW,QAAQ,EAClD;YACE,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,EAAE,GAAG,EAAE;SACd,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,8BAA8B,WAAW,KAAK;YAC5C,eAAe,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAClD,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { callApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerDeleteQuestionMediaTool(server) {
+    server.registerTool("clipform_delete_question_media", {
+        title: "Delete Question Media",
+        description: `Remove media from a question. Deletes the media record and cleans up external resources (Mux video asset, storage file).`,
+        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: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ form_id, edit_token, question_id }) => {
+        const result = await callApi(`/forms/${form_id}/questions/${question_id}/media`, {
+            method: "DELETE",
+            token: edit_token,
+        });
+        if (!result.ok) {
+            return errorResult(result.error);
+        }
+        return textResult("Media removed from question.");
+    });
+}
+//# sourceMappingURL=delete-question-media.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-question-media.js","sourceRoot":"","sources":["../../src/tools/delete-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,0HAA0H;QACvI,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,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,KAAK;YACrB,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,QAAQ;YAChB,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,OAAO,UAAU,CAAC,8BAA8B,CAAC,CAAC;IACpD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-slideshow.d.ts

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

package/dist/tools/generate-slideshow.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerGenerateSlideshowTool(server) {
+    server.registerTool("clipform_generate_slideshow", {
+        title: "Generate Ken Burns Slideshow",
+        description: `Generate a Ken Burns slideshow video from images and audio. Uses FFmpeg to create a video with pan/zoom effects and crossfade transitions. The video is uploaded to storage and a public URL is returned.
+
+Workflow:
+1. Find images (use formgen_search_images or provide URLs)
+2. Provide an audio track URL (e.g. TTS narration from clipform_generate_tts)
+3. This tool creates a video with Ken Burns pan/zoom effects over the images, synced to the audio duration
+4. Attach the resulting public URL to a question using clipform_upload_media with media_type "video"
+
+Effects: zoom-in, zoom-out, pan-left, pan-right, pan-up, pan-down, zoom-in-pan-left, zoom-in-pan-right, random, static.
+Transitions: fade, fadeblack, fadewhite, slideleft, slideright, circlecrop, circleopen, circleclose, dissolve, pixelize, radial, smoothleft, smoothright.`,
+        inputSchema: {
+            images: z.array(z.object({
+                url: z.string().url().describe("Image URL"),
+                effect: z.string().optional().describe("Ken Burns effect (e.g. 'zoom-in', 'pan-left', 'random'). Default: random"),
+            })).min(1).max(20).describe("Images for the slideshow (1-20)"),
+            audio_url: z.string().url().describe("URL of the audio track (mp3/wav)"),
+            random_effects: z.boolean().optional().default(true).describe("Randomise effects (default: true)"),
+            transition: z.object({
+                type: z.string().optional().default("fade").describe("Transition type (default: 'fade')"),
+                duration: z.number().optional().default(1).describe("Transition duration in seconds (default: 1)"),
+            }).optional().describe("Transition settings"),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async ({ images, audio_url, random_effects, transition }) => {
+        const result = await callInternalApi("/internal/media/slideshow", {
+            body: {
+                images,
+                audio_url,
+                random_effects: random_effects ?? true,
+                transition: transition ?? { type: "fade", duration: 1 },
+            },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const data = result.data;
+        return textResult([
+            `Slideshow generated successfully!`,
+            ``,
+            `Storage path: ${data.storage_path}`,
+            `Public URL: ${data.public_url}`,
+            `Duration: ${data.duration_seconds}s`,
+            ``,
+            `Use clipform_upload_media with the public URL to attach this video to a question.`,
+        ].join("\n"));
+    });
+}
+//# sourceMappingURL=generate-slideshow.js.map

package/dist/tools/generate-slideshow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-slideshow.js","sourceRoot":"","sources":["../../src/tools/generate-slideshow.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,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE;;;;;;;;;0JASuI;QACpJ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;gBACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0EAA0E,CAAC;aACnH,CAAC,CACH,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC5D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YACxE,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAClG,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;gBACzF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;aACnG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;SAC9C;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;KACzG,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,EAAE,EAAE;QAC1D,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,2BAA2B,EAAE;YAChE,IAAI,EAAE;gBACJ,MAAM;gBACN,SAAS;gBACT,cAAc,EAAE,cAAc,IAAI,IAAI;gBACtC,UAAU,EAAE,UAAU,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;aACxD;SACF,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAW,CAAC;QAChC,OAAO,UAAU,CACf;YACE,mCAAmC;YACnC,EAAE;YACF,iBAAiB,IAAI,CAAC,YAAY,EAAE;YACpC,eAAe,IAAI,CAAC,UAAU,EAAE;YAChC,aAAa,IAAI,CAAC,gBAAgB,GAAG;YACrC,EAAE;YACF,mFAAmF;SACpF,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-tts.d.ts

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

package/dist/tools/generate-tts.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { callInternalApi, errorResult, textResult } from "../lib/api-client.js";
+export function registerGenerateTtsTool(server) {
+    server.registerTool("clipform_generate_tts", {
+        title: "Generate Text-to-Speech",
+        description: `Generate narration audio from text using Edge TTS (free) with ElevenLabs fallback. The audio is uploaded to storage and a public URL is returned.
+
+Use this to create narration for slideshow videos. Workflow:
+1. Generate TTS audio with this tool
+2. Search for images with formgen_search_images
+3. Create a slideshow with clipform_generate_slideshow (pass the audio URL + image URLs)
+4. Attach the video to a question with clipform_upload_media
+
+Available voices:
+- ryan: British male (default)
+- sonia: British female
+- andrew: American male
+- ava: American female
+- guy: American male (casual)
+
+Returns the audio public URL and word-level captions for subtitle display.`,
+        inputSchema: {
+            text: z.string().min(1).max(5000).describe("The narration text to convert to speech"),
+            voice: z.enum(["ryan", "sonia", "andrew", "ava", "guy"]).optional().default("ryan").describe("TTS voice (default: ryan)"),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async ({ text, voice }) => {
+        const result = await callInternalApi("/internal/formgen/generate-tts", {
+            body: { text, voice },
+        });
+        if (!result.ok)
+            return errorResult(result.error);
+        const data = result.data;
+        return textResult([
+            `TTS audio generated successfully!`,
+            ``,
+            `Voice: ${data.voice}`,
+            `Audio URL: ${data.audioUrl}`,
+            `Storage path: ${data.storagePath}`,
+            `Captions: ${data.captions.length} segments`,
+            `Captions JSON: ${JSON.stringify(data.captions)}`,
+            ``,
+            `Use the Audio URL with clipform_generate_slideshow to create a video.`,
+            `Pass the Captions JSON to clipform_upload_media to enable subtitles.`,
+        ].join("\n"));
+    });
+}
+//# sourceMappingURL=generate-tts.js.map

package/dist/tools/generate-tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tts.js","sourceRoot":"","sources":["../../src/tools/generate-tts.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,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE;;;;;;;;;;;;;;;2EAewD;QACrE,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YACrF,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;SAC1H;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;KACzG,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,gCAAgC,EAAE;YACrE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAW,CAAC;QAChC,OAAO,UAAU,CACf;YACE,mCAAmC;YACnC,EAAE;YACF,UAAU,IAAI,CAAC,KAAK,EAAE;YACtB,cAAc,IAAI,CAAC,QAAQ,EAAE;YAC7B,iBAAiB,IAAI,CAAC,WAAW,EAAE;YACnC,aAAa,IAAI,CAAC,QAAQ,CAAC,MAAM,WAAW;YAC5C,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;YACjD,EAAE;YACF,uEAAuE;YACvE,sEAAsE;SACvE,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

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;