@formfeed/mcp 0.3.1 → 0.3.3

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

@@ -77504,6 +77504,7 @@ function toDate2(value, tz) {
 function escapeHtml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
+var isNamedArgs = (v2) => !!v2 && typeof v2 === "object" && !Array.isArray(v2) && !(v2 instanceof Date);
 var str = (v2) => v2 === void 0 || v2 === null ? "" : String(v2);
 var opt = (v2, fallback) => v2 === void 0 || v2 === null || v2 === "" ? fallback : v2;
 var wordsByLang = {
@@ -77538,7 +77539,7 @@ var formatHelpers = [
     name: "number",
     doc: {
       signature: "number(value, decimals?, locale?)",
-      description: "Formats a number with grouping and a fixed number of decimals.",
+      description: "Formats a number with grouping. With decimals, exactly that many (rounded half away from zero); without, the decimals the number has, at most three, so 1234.5 \u2192 1.234,5 and 2.34567 \u2192 2,346. Use number(0) for whole numbers.",
       example: "{{ qty | number(2) }} \u2192 1.234,00",
       category: "format"
     },
@@ -77632,15 +77633,26 @@ var formatHelpers = [
   {
     name: "round",
     doc: {
-      signature: "round(value, decimals = 0)",
-      description: "Rounds half away from zero.",
-      example: "{{ 2.345 | round(2) }} gives 2.35",
+      signature: "round(value, decimals = 0, method = 'common')",
+      description: "Rounds to the given decimals, as Jinja2's round does: 'common' rounds half away from zero, 'floor' always down and 'ceil' always up.",
+      example: "{{ 2.345 | round(2) }} gives 2.35, {{ 2.349 | round(2, 'floor') }} gives 2.34",
       category: "format"
     },
-    fn: (_ctx, value, decimals) => {
+    // `round(2, method='floor')` (Jinja2) and `round: 2, method: 'floor'` (Liquid) arrive as a
+    // trailing object, as does a Handlebars hash
+    fn: (_ctx, value, ...args2) => {
       const n = toNumber(value);
-      const f2 = 10 ** (decimals === void 0 || decimals === null ? 0 : Number(decimals));
-      return Number.isNaN(n) ? "" : Math.round((Math.abs(n) + Number.EPSILON) * f2) / f2 * Math.sign(n);
+      if (Number.isNaN(n)) return "";
+      const named = args2.find(isNamedArgs) ?? {};
+      const [decimals, method] = args2.filter((a) => !isNamedArgs(a));
+      const places = Number(opt(decimals, opt(named["precision"], opt(named["decimals"], 0))));
+      const how = String(opt(method, opt(named["method"], "common")));
+      const f2 = 10 ** places;
+      const scaled = Number((Math.abs(n) * f2).toPrecision(15));
+      if (how === "floor") return (n < 0 ? -Math.ceil(scaled) : Math.floor(scaled)) / f2;
+      if (how === "ceil") return (n < 0 ? -Math.floor(scaled) : Math.ceil(scaled)) / f2;
+      if (how !== "common") throw new Error(`round: method must be 'common', 'floor' or 'ceil', not '${how}'`);
+      return Math.round(scaled + Number.EPSILON) / f2 * Math.sign(n);
     }
   },
   {
@@ -82779,7 +82791,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.3" };
 var engineSchema = z2.enum(["jinja2", "liquid", "handlebars"]);
 var outputSchema = z2.enum(outputFormats);
 var kindSchema = z2.enum(["pdf", "image", "docx", "pptx"]);
@@ -82820,7 +82833,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 +82974,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 +83058,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.3",
   "description": "Model Context Protocol server for Formfeed: list templates, read data schemas, validate and render documents from AI agents.",
   "license": "MIT",
   "author": {