@formfeed/mcp 0.3.1 → 0.3.2

package/README.md

@@ -1,8 +1,8 @@
 # @formfeed/mcp
 
-Model Context Protocol server for Formfeed. Gives Claude, Cursor and other agents five tools:
+Model Context Protocol server for Formfeed. Gives Claude, Cursor and other agents six tools:
 `list_templates`, `get_template_schema`, `validate_template` (offline, with the shared engine),
-`render` and `get_render`.
+`render`, `convert_to_pdf` (Word, Excel, PowerPoint and OpenDocument to PDF) and `get_render`.
 
 ## stdio (Claude Desktop, Cursor, Claude Code)
 

package/bin/formfeed-mcp.mjs

@@ -82779,7 +82779,8 @@ var encoder2 = new TextEncoder();
 
 // packages/mcp/src/lib/server.ts
 import { z as z2 } from "zod";
-var SERVER_INFO = { name: "formfeed", version: "0.3.1" };
+var CONVERT_LIMIT_BYTES = 20 * 1024 * 1024;
+var SERVER_INFO = { name: "formfeed", version: "0.3.2" };
 var engineSchema = z2.enum(["jinja2", "liquid", "handlebars"]);
 var outputSchema = z2.enum(outputFormats);
 var kindSchema = z2.enum(["pdf", "image", "docx", "pptx"]);
@@ -82820,7 +82821,7 @@ function createFormfeedServer(options) {
     ...options.fetch ? { fetch: options.fetch } : {}
   });
   const server = new McpServer(SERVER_INFO, {
-    instructions: "Formfeed renders PDFs and images from HTML templates, and fills Word and PowerPoint templates (as DOCX, PPTX or PDF). Start with list_templates, read the data shape with get_template_schema, check data with validate_template, then call render and hand the download_url to the user."
+    instructions: "Formfeed renders PDFs and images from HTML templates, and fills Word and PowerPoint templates (as DOCX, PPTX or PDF). Start with list_templates, read the data shape with get_template_schema, check data with validate_template, then call render and hand the download_url to the user. convert_to_pdf turns office documents into PDFs."
   });
   server.registerTool(
     "list_templates",
@@ -82961,6 +82962,69 @@ function createFormfeedServer(options) {
       }
     }
   );
+  server.registerTool(
+    "convert_to_pdf",
+    {
+      title: "Convert an office document to PDF",
+      description: [
+        "Converts a Word, Excel, PowerPoint, OpenDocument, RTF or HTML document (up to 20 MB) to a PDF and returns a download URL (Starter plan and above; units follow the PDF rule).",
+        "Pass exactly one source: render_id, the render of a Word or PowerPoint template (output docx or pptx);",
+        options.localFiles ? "path, a file on this machine; or file_base64 with file_name." : "or file_base64 with file_name, the document itself.",
+        "The document is converted and not kept."
+      ].join(" "),
+      inputSchema: {
+        render_id: z2.string().optional().describe("rnd_ id of a render whose output is docx or pptx"),
+        ...options.localFiles ? { path: z2.string().optional().describe("Absolute path of a document on this machine") } : {},
+        file_base64: z2.string().optional().describe("The document, base64 encoded"),
+        file_name: z2.string().optional().describe("Name of the document, e.g. report.xlsx; the type is read from the content"),
+        page_ranges: z2.string().regex(/^\d+(-\d+)?(,\d+(-\d+)?)*$/).optional().describe("Pages to convert, e.g. 1-3,5"),
+        landscape: z2.boolean().optional().describe("Landscape for spreadsheets and documents without their own page setup"),
+        single_page_sheets: z2.boolean().optional().describe("Each spreadsheet sheet on one page"),
+        filename: z2.string().optional().describe("Name of the PDF")
+      },
+      annotations: { readOnlyHint: false, idempotentHint: false }
+    },
+    async (args2) => {
+      try {
+        const { render_id, file_base64, file_name, page_ranges, landscape, single_page_sheets, filename } = args2;
+        const path = args2.path;
+        const sources = [render_id, file_base64, path].filter((s) => s !== void 0 && s !== "");
+        if (sources.length !== 1) return failure(new Error("Pass exactly one of render_id, file_base64" + (options.localFiles ? " or path" : "")));
+        const convert = {
+          meta: { source: "mcp" },
+          ...page_ranges ? { page_ranges } : {},
+          ...landscape !== void 0 ? { landscape } : {},
+          ...single_page_sheets !== void 0 ? { single_page_sheets } : {},
+          ...filename ? { filename } : {}
+        };
+        let render;
+        if (render_id) {
+          render = await client.pdf.convert(render_id, convert);
+        } else {
+          let data;
+          let name;
+          if (path) {
+            const { readFile, stat } = await import("node:fs/promises");
+            const { basename } = await import("node:path");
+            if ((await stat(path)).size > CONVERT_LIMIT_BYTES) return failure(new Error(`${path} is larger than 20 MB, the limit for conversions`));
+            data = new Uint8Array(await readFile(path));
+            name = file_name ?? basename(path);
+          } else {
+            if (!file_name) return failure(new Error("file_name is required with file_base64"));
+            data = Uint8Array.from(Buffer.from(file_base64, "base64"));
+            if (data.length === 0) return failure(new Error("file_base64 is empty or not base64"));
+            if (data.length > CONVERT_LIMIT_BYTES) return failure(new Error("The document is larger than 20 MB, the limit for conversions"));
+            name = file_name;
+          }
+          render = await client.pdf.convert({ file: { data, name } }, { ...convert, ...filename ? {} : { filename: `${name.replace(/\.[^.]+$/, "")}.pdf` } });
+        }
+        if (render.status !== "succeeded" && render.status !== "failed") render = await client.renders.waitFor(render.id);
+        return text(renderSummary(render));
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
   server.registerTool(
     "get_render",
     {
@@ -82982,7 +83046,7 @@ function createFormfeedServer(options) {
 
 // packages/mcp/src/lib/transports.ts
 async function startStdio(options) {
-  const server = createFormfeedServer(options);
+  const server = createFormfeedServer({ localFiles: true, ...options });
   await server.connect(new StdioServerTransport());
 }
 async function startHttp(options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formfeed/mcp",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Model Context Protocol server for Formfeed: list templates, read data schemas, validate and render documents from AI agents.",
   "license": "MIT",
   "author": {