@clipform/mcp-server 1.0.0 → 1.1.3

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,15 +1,15 @@
 {
   "name": "@clipform/mcp-server",
-  "version": "1.0.0",
+  "version": "1.1.3",
   "description": "MCP server for building and managing Clipform video forms",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/andy-cb-smith/vid-master",
-    "directory": "packages/mcp-server"
-  },
+  "homepage": "https://clipform.io",
   "type": "module",
   "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./server": "./dist/server.js"
+  },
   "bin": {
     "mcp-server-clipform": "dist/index.js"
   },