@formfeed/mcp 0.3.17 → 0.3.18

package/README.md

@@ -5,7 +5,8 @@
 Model Context Protocol server for [Formfeed](https://formfeed.dev/?utm_source=npm&utm_content=mcp).
 Gives Claude, Cursor and other agents eight tools: `list_templates`, `get_template_schema`,
 `validate_template` (free: the data against the template's schema, ad-hoc HTML offline), `check_invoice` (free and offline: the
-`_invoice` block of a ZUGFeRD / Factur-X e-invoice against EN 16931), `render` (with `einvoice`, the PDF becomes that e-invoice),
+`_invoice` block of a ZUGFeRD / Factur-X e-invoice against EN 16931), `render` (with `einvoice`, the PDF becomes that e-invoice; an
+image comes back as a picture the agent can look at),
 `convert_to_pdf` (Word, Excel, PowerPoint and OpenDocument to PDF), `get_render` and `get_workspace` (which workspace the
 server works in, and the units left).
 
@@ -23,8 +24,10 @@ server works in, and the units left).
 }
 ```
 
-A test key renders free with a watermark; a live key consumes units. `FORMFEED_REGION=us` or
-`FORMFEED_BASE_URL` select another API host.
+A test key renders for free (on the Free plan with a test mark); a live key consumes units.
+Without `FORMFEED_API_KEY` the server starts too, with the offline checks only: `validate_template`
+with `html` and `engine`, and `check_invoice`. `FORMFEED_REGION=us` or `FORMFEED_BASE_URL` select
+another API host.
 
 ## Hosted (Streamable HTTP)
 

package/bin/formfeed-mcp.mjs

@@ -7573,7 +7573,7 @@ var require_base64 = __commonJS({
 var require_base64_vlq = __commonJS({
   "node_modules/.pnpm/source-map@0.6.1/node_modules/source-map/lib/base64-vlq.js"(exports) {
     "use strict";
-    var base64 = require_base64();
+    var base642 = require_base64();
     var VLQ_BASE_SHIFT = 5;
     var VLQ_BASE = 1 << VLQ_BASE_SHIFT;
     var VLQ_BASE_MASK = VLQ_BASE - 1;
@@ -7596,7 +7596,7 @@ var require_base64_vlq = __commonJS({
         if (vlq > 0) {
           digit |= VLQ_CONTINUATION_BIT;
         }
-        encoded += base64.encode(digit);
+        encoded += base642.encode(digit);
       } while (vlq > 0);
       return encoded;
     };
@@ -7609,7 +7609,7 @@ var require_base64_vlq = __commonJS({
         if (aIndex >= strLen) {
           throw new Error("Expected more digits in base 64 VLQ value.");
         }
-        digit = base64.decode(aStr.charCodeAt(aIndex++));
+        digit = base642.decode(aStr.charCodeAt(aIndex++));
         if (digit === -1) {
           throw new Error("Invalid base64 digit: " + aStr.charAt(aIndex - 1));
         }
@@ -14656,7 +14656,7 @@ var require_nunjucks = __commonJS({
                 });
                 return result;
               };
-              _proto.fetch = function fetch(url, cb) {
+              _proto.fetch = function fetch2(url, cb) {
                 if (typeof window === "undefined") {
                   throw new Error("WebLoader can only by used in a browser");
                 }
@@ -70857,11 +70857,11 @@ var codeHelpers = [
     aliases: ["epc_qr", "girocode"],
     doc: {
       signature: "epcQr({ name, iban, bic?, amount?, reference?, text? }, { size })",
-      description: "SEPA credit transfer QR code (EPC069-12 / GiroCode) that banking apps scan to prefill a payment. Give the image an `alt`, and print the bank details as text as well: the code is a picture.",
+      description: "SEPA credit transfer QR code (EPC069-12 / GiroCode) that banking apps scan to prefill a payment. Put an invoice number into `text` (the remittance line); `reference` is only for a structured creditor reference (RF\u2026). Give the image an `alt`, and print the bank details as text as well: the code is a picture.",
       examples: {
-        jinja2: '<img src="{{ epcQr({ name: company.name, iban: company.iban, amount: invoice.total, reference: invoice.number }) }}" alt="QR code to pay invoice {{ invoice.number }}">',
-        liquid: '<img src="{{ company.iban | epcQr: name: company.name, amount: invoice.total, reference: invoice.number }}" alt="QR code to pay invoice {{ invoice.number }}">',
-        handlebars: '<img src="{{epcQr name=company.name iban=company.iban amount=invoice.total reference=invoice.number}}" alt="QR code to pay invoice {{invoice.number}}">'
+        jinja2: '<img src="{{ epcQr({ name: company.name, iban: company.iban, amount: invoice.total, text: invoice.number }) }}" alt="QR code to pay invoice {{ invoice.number }}">',
+        liquid: '<img src="{{ company.iban | epcQr: name: company.name, amount: invoice.total, text: invoice.number }}" alt="QR code to pay invoice {{ invoice.number }}">',
+        handlebars: '<img src="{{epcQr name=company.name iban=company.iban amount=invoice.total text=invoice.number}}" alt="QR code to pay invoice {{invoice.number}}">'
       },
       category: "code"
     },
@@ -83841,7 +83841,44 @@ var encoder2 = new TextEncoder();
 // packages/mcp/src/lib/server.ts
 import { z as z3 } from "zod";
 var CONVERT_LIMIT_BYTES = 20 * 1024 * 1024;
-var SERVER_INFO = { name: "formfeed", version: "0.3.17" };
+var NO_KEY = "This tool needs a Formfeed API key. Set FORMFEED_API_KEY to a key from https://app.formfeed.dev/keys (a test key, ff_test_\u2026, renders for free), or connect to https://mcp.formfeed.dev/mcp and sign in. Without a key, validate_template (with html and engine) and check_invoice work.";
+var NO_KEY_INSTRUCTION = "No API key is set, so only validate_template with html and engine, and check_invoice, work here; every other tool answers with how to get a key.";
+var IMAGE_TYPES = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  webp: "image/webp"
+};
+var IMAGE_LIMIT_BYTES = 2 * 1024 * 1024;
+async function readCapped(res, limit) {
+  if (!res.body) return null;
+  const reader = res.body.getReader();
+  const chunks = [];
+  let size = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    size += value.length;
+    if (size > limit) {
+      await reader.cancel();
+      return null;
+    }
+    chunks.push(value);
+  }
+  const bytes = new Uint8Array(size);
+  let offset = 0;
+  for (const chunk of chunks) {
+    bytes.set(chunk, offset);
+    offset += chunk.length;
+  }
+  return bytes;
+}
+function base64(bytes) {
+  let binary = "";
+  for (let i = 0; i < bytes.length; i += 32768)
+    binary += String.fromCharCode(...bytes.subarray(i, i + 32768));
+  return btoa(binary);
+}
+var SERVER_INFO = { name: "formfeed", version: "0.3.18" };
 var READS = {
   readOnlyHint: true,
   destructiveHint: false,
@@ -83856,6 +83893,37 @@ var CREATES = {
 var engineSchema = z3.enum(["jinja2", "liquid", "handlebars"]);
 var outputSchema = z3.enum(outputFormats);
 var kindSchema = z3.enum(["pdf", "image", "docx", "pptx"]);
+var renderOutput = {
+  id: z3.string().describe("rnd_ id of the render"),
+  status: z3.enum(["queued", "rendering", "succeeded", "failed"]),
+  download_url: z3.string().nullable().describe("Signed link to the file; null until the render succeeded"),
+  expires_at: z3.string().nullable().describe("When download_url stops working; get_render issues a fresh one"),
+  page_count: z3.number().nullable(),
+  units: z3.number().describe("Units the render counted"),
+  environment: z3.enum(["live", "test"]),
+  template: z3.object({
+    id: z3.string(),
+    slug: z3.string(),
+    version: z3.number(),
+    channel: z3.string().nullable().optional(),
+    canary: z3.boolean().optional()
+  }).nullable().describe(
+    "The template and version rendered; null for html and conversions"
+  ),
+  error: z3.object({ code: z3.string().optional(), message: z3.string().optional() }).nullable().describe("Why a failed render failed"),
+  accessibility: z3.record(z3.string(), z3.unknown()).optional().describe("The PDF/UA-1 verdict, when the template declares it"),
+  einvoice: z3.record(z3.string(), z3.unknown()).optional().describe("The e-invoice report, when the render made one")
+};
+var diagnosticOutput = z3.object({
+  severity: z3.enum(["error", "warning", "info"]),
+  code: z3.string(),
+  message: z3.string(),
+  path: z3.string().optional().describe("Where in the data, for data errors"),
+  line: z3.number().optional(),
+  column: z3.number().optional(),
+  part: z3.string().optional().describe("Word and PowerPoint templates: the file part of the tag"),
+  paragraph: z3.number().optional()
+});
 var templateSummary = (t) => ({
   id: t.id,
   slug: t.slug,
@@ -83916,7 +83984,7 @@ ${JSON.stringify(details, null, 2)}` : message2
   };
 }
 function createFormfeedServer(options) {
-  const client = new Formfeed({
+  const client = options.apiKey ? new Formfeed({
     apiKey: options.apiKey,
     headers: {
       "user-agent": `formfeed-mcp/${SERVER_INFO.version}`,
@@ -83925,15 +83993,39 @@ function createFormfeedServer(options) {
     ...options.region ? { region: options.region } : {},
     ...options.baseUrl ? { baseUrl: options.baseUrl } : {},
     ...options.fetch ? { fetch: options.fetch } : {}
-  });
+  }) : null;
+  const api = () => {
+    if (!client) throw new Error(NO_KEY);
+    return client;
+  };
+  const fetchImpl = options.fetch ?? ((input, init) => fetch(input, init));
   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. For an e-invoice (ZUGFeRD / Factur-X), put the invoice into data._invoice, check it with check_invoice, and call render with einvoice set; the template prints the same block. convert_to_pdf turns office documents into PDFs. get_workspace says which workspace this server works in and what the period has left."
+    instructions: (client ? "" : `${NO_KEY_INSTRUCTION} `) + "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. An image render also returns the picture itself, so look at it before handing it on. For an e-invoice (ZUGFeRD / Factur-X), put the invoice into data._invoice, check it with check_invoice, and call render with einvoice set; the template prints the same block. convert_to_pdf turns office documents into PDFs. get_workspace says which workspace this server works in and what the period has left."
   });
+  const picture = async (render) => {
+    const mimeType = IMAGE_TYPES[render.output];
+    if (render.status !== "succeeded" || !mimeType || !render.download_url)
+      return [];
+    try {
+      const res = await fetchImpl(render.download_url);
+      const bytes = res.ok ? await readCapped(res, IMAGE_LIMIT_BYTES) : null;
+      return bytes ? [{ type: "image", data: base64(bytes), mimeType }] : [];
+    } catch {
+      return [];
+    }
+  };
+  const renderResult = async (render) => {
+    const result = text3(renderSummary(render));
+    return {
+      ...result,
+      content: [...result.content, ...await picture(render)]
+    };
+  };
   server.registerTool(
     "list_templates",
     {
       title: "List templates",
-      description: "Lists the templates of the workspace the API key belongs to, most recently changed first: id, slug, name, kind (pdf, image, docx for Word, pptx for PowerPoint), engine, tags and published_version. Call it first to find the slug that get_template_schema, validate_template and render take; skip it when the user already named the template. Returns every match in one answer, without archived templates, and an empty list when nothing matches. A template whose published_version is null has never been published, so render cannot use it yet. Read-only and free.",
+      description: "Lists the templates of the workspace this server works in (the one chosen at sign-in, or the API key's), most recently changed first: id, slug, name, kind (pdf, image, docx for Word, pptx for PowerPoint), engine, tags and published_version. Call it first to find the slug that get_template_schema, validate_template and render take; skip it when the user already named the template. Returns every match in one answer, without archived templates, and an empty list when nothing matches. A template whose published_version is null has never been published, so render cannot use it yet. Read-only and free.",
       inputSchema: {
         kind: kindSchema.optional().describe("Only templates that produce this kind of document"),
         engine: engineSchema.optional().describe("Only templates written in this template language"),
@@ -83944,11 +84036,26 @@ function createFormfeedServer(options) {
           "Text to find in the name or slug, case-insensitive (e.g. invoice)"
         )
       },
+      outputSchema: {
+        templates: z3.array(
+          z3.object({
+            id: z3.string().describe("tpl_ id"),
+            slug: z3.string(),
+            name: z3.string(),
+            kind: z3.string().describe("pdf, image, docx (Word) or pptx (PowerPoint)"),
+            engine: z3.string().describe("jinja2, liquid or handlebars"),
+            description: z3.string().nullable(),
+            tags: z3.array(z3.string()),
+            published_version: z3.number().nullable().describe("null: never published, so render cannot use it yet"),
+            updated_at: z3.string()
+          })
+        )
+      },
       annotations: READS
     },
     async (args2) => {
       try {
-        const templates = await client.templates.all(args2);
+        const templates = await api().templates.all(args2);
         return text3({ templates: templates.map(templateSummary) });
       } catch (e) {
         return failure(e);
@@ -83965,13 +84072,22 @@ function createFormfeedServer(options) {
           "Slug (e.g. invoice) or tpl_ id, as list_templates returns them"
         )
       },
+      outputSchema: {
+        template: z3.string(),
+        version: z3.number().describe("The version the schema comes from"),
+        status: z3.string().describe("published, or draft when nothing is published yet"),
+        schema: z3.record(z3.string(), z3.unknown()).describe(
+          "JSON Schema of data; inferred from sample_data when none is stored"
+        ),
+        sample_data: z3.record(z3.string(), z3.unknown())
+      },
       annotations: READS
     },
     async ({ template }) => {
       try {
-        const version = await client.templates.versions.get(template, "published").catch(async (e) => {
+        const version = await api().templates.versions.get(template, "published").catch(async (e) => {
           if (e.status === 404)
-            return client.templates.versions.get(template, "latest");
+            return api().templates.versions.get(template, "latest");
           throw e;
         });
         const schema = version.data_schema ?? inferSchema(version.sample_data ?? {});
@@ -84002,12 +84118,17 @@ function createFormfeedServer(options) {
           "The data the document will be rendered with, shaped as get_template_schema describes. Left out, a stored template is checked with its sample data"
         )
       },
+      outputSchema: {
+        ok: z3.boolean().describe("false when a diagnostic is an error"),
+        template: z3.object({ id: z3.string(), slug: z3.string(), version: z3.number() }).optional().describe("The stored version checked; absent for html"),
+        diagnostics: z3.array(diagnosticOutput)
+      },
       annotations: READS
     },
     async ({ template, html, engine, data }) => {
       try {
         if (template) {
-          const check = (version) => client.templates.validate(template, {
+          const check = (version) => api().templates.validate(template, {
             version,
             ...data ? { data } : {}
           });
@@ -84076,6 +84197,16 @@ function createFormfeedServer(options) {
           "The profile the render will ask for; en16931 when left out. basic cannot carry a rounding amount and is refused between two French businesses"
         )
       },
+      outputSchema: {
+        ok: z3.boolean(),
+        problems: z3.array(
+          z3.object({
+            path: z3.string().describe("The field, e.g. _invoice.seller.vat_id"),
+            rule: z3.string().optional().describe("The EN 16931 rule, e.g. BR-03"),
+            message: z3.string()
+          })
+        )
+      },
       annotations: READS
     },
     async ({ invoice, profile }) => {
@@ -84094,7 +84225,7 @@ function createFormfeedServer(options) {
     "render",
     {
       title: "Render a document",
-      description: "Creates a document by filling a stored template, or ad-hoc html, with data: a PDF or image, or DOCX, PPTX or PDF from Word and PowerPoint templates. Returns the render with status and download_url. Use it to make a document from data; to turn an existing office file into a PDF, use convert_to_pdf. Stored templates render their published version, so one whose published_version is null fails with template_not_found. Every call is a new render: a live key consumes units, a test key is free (watermarked on the Free plan). A render that fails returns status failed and an error with code and message; validate_template finds most causes beforehand. With einvoice the PDF becomes a ZUGFeRD / Factur-X e-invoice built from data._invoice (check the block with check_invoice first): the render then carries einvoice, the validator's report, and a refused invoice names the fields and rules to fix. The link expires at expires_at; get_render issues a fresh one.",
+      description: "Creates a document by filling a stored template, or ad-hoc html, with data: a PDF or image, or DOCX, PPTX or PDF from Word and PowerPoint templates. Returns the render with status and download_url; for an image (png, jpg or webp) up to 2 MB the result also carries the picture itself, so look at what you made before handing it on (a PDF comes as its link). Use it to make a document from data; to turn an existing office file into a PDF, use convert_to_pdf. Stored templates render their published version, so one whose published_version is null fails with template_not_found. Every call is a new render: a live key or a signed-in agent consumes units, a test key is free (watermarked on the Free plan). A render that fails returns status failed and an error with code and message; validate_template finds most causes beforehand. With einvoice the PDF becomes a ZUGFeRD / Factur-X e-invoice built from data._invoice (check the block with check_invoice first): the render then carries einvoice, the validator's report, and a refused invoice names the fields and rules to fix. The link expires at expires_at; get_render issues a fresh one.",
       inputSchema: {
         template: z3.string().optional().describe("Slug or tpl_ id of a stored template; pass this or html"),
         html: z3.string().optional().describe(
@@ -84136,6 +84267,7 @@ function createFormfeedServer(options) {
           "Makes the PDF a ZUGFeRD / Factur-X e-invoice whose XML is built from data._invoice: true for the defaults, an object to choose, false to switch off what the template declares. PDF only; live renders from the Starter plan, test keys on Free make 20 marked ones a day"
         )
       },
+      outputSchema: renderOutput,
       annotations: CREATES
     },
     async ({
@@ -84152,7 +84284,7 @@ function createFormfeedServer(options) {
       try {
         if (!template && !html)
           return failure(new Error("Pass template or html"));
-        let render = await client.renders.create({
+        let render = await api().renders.create({
           ...template ? { template } : {},
           ...html ? { html } : {},
           ...engine ? { engine } : {},
@@ -84164,8 +84296,8 @@ function createFormfeedServer(options) {
           meta: { source: "mcp" }
         });
         if (wait && render.status !== "succeeded" && render.status !== "failed")
-          render = await client.renders.waitFor(render.id);
-        return text3(renderSummary(render));
+          render = await api().renders.waitFor(render.id);
+        return await renderResult(render);
       } catch (e) {
         return failure(e);
       }
@@ -84200,6 +84332,7 @@ function createFormfeedServer(options) {
         single_page_sheets: z3.boolean().optional().describe("Each spreadsheet sheet on one page"),
         filename: z3.string().optional().describe("Name of the PDF behind download_url, e.g. report.pdf")
       },
+      outputSchema: renderOutput,
       annotations: CREATES
     },
     async (args2) => {
@@ -84232,7 +84365,7 @@ function createFormfeedServer(options) {
         };
         let render;
         if (render_id) {
-          render = await client.pdf.convert(render_id, convert);
+          render = await api().pdf.convert(render_id, convert);
         } else {
           let data;
           let name;
@@ -84263,7 +84396,7 @@ function createFormfeedServer(options) {
               );
             name = file_name;
           }
-          render = await client.pdf.convert(
+          render = await api().pdf.convert(
             { file: { data, name } },
             {
               ...convert,
@@ -84272,8 +84405,8 @@ function createFormfeedServer(options) {
           );
         }
         if (render.status !== "succeeded" && render.status !== "failed")
-          render = await client.renders.waitFor(render.id);
-        return text3(renderSummary(render));
+          render = await api().renders.waitFor(render.id);
+        return await renderResult(render);
       } catch (e) {
         return failure(e);
       }
@@ -84283,17 +84416,18 @@ function createFormfeedServer(options) {
     "get_render",
     {
       title: "Get a render",
-      description: "Returns the current state of a render: status (queued, rendering, succeeded or failed), download_url with expires_at, page_count, units and error. Use it to follow a render started with wait false, or to get a fresh link once the old one has expired; render and convert_to_pdf already return this for the render they just made. Read-only and free; an unknown id returns an error.",
+      description: "Returns the current state of a render: status (queued, rendering, succeeded or failed), download_url with expires_at, page_count, units and error, and the picture of a finished image render up to 2 MB. Use it to follow a render started with wait false, or to get a fresh link once the old one has expired; render and convert_to_pdf already return this for the render they just made. Read-only and free; an unknown id returns an error.",
       inputSchema: {
         id: z3.string().describe(
           "rnd_ id of the render, as render or convert_to_pdf returned it"
         )
       },
+      outputSchema: renderOutput,
       annotations: READS
     },
     async ({ id }) => {
       try {
-        return text3(renderSummary(await client.renders.get(id)));
+        return await renderResult(await api().renders.get(id));
       } catch (e) {
         return failure(e);
       }
@@ -84305,11 +84439,36 @@ function createFormfeedServer(options) {
       title: "Which workspace this server works in",
       description: "Returns the workspace and organisation this server acts in, the plan, the environment (live or test) and the units of the current period: included, used and the balance of prepaid units. Call it when the user asks where a document will land or how many renders are left, or when list_templates returns nothing you expected. A signed-in agent works in the workspace chosen when it was connected, which the person changes in Formfeed under Account \u2192 Connected agents; an API key works in the workspace it was made for. Read-only and free.",
       inputSchema: {},
+      outputSchema: {
+        workspace: z3.object({
+          id: z3.string(),
+          slug: z3.string(),
+          name: z3.string(),
+          region: z3.string().describe("eu, us or apac")
+        }),
+        organization: z3.object({
+          id: z3.string(),
+          slug: z3.string(),
+          name: z3.string()
+        }),
+        plan: z3.object({
+          id: z3.string(),
+          name: z3.string(),
+          monthly_units: z3.number().nullable().optional().describe("Units included a month; null where the plan sets none")
+        }),
+        environment: z3.enum(["live", "test"]).optional().describe("live renders count units; test renders are free"),
+        period: z3.object({ start: z3.string(), end: z3.string() }).describe("The current billing period"),
+        units: z3.object({
+          included: z3.number().nullable().optional(),
+          used: z3.number(),
+          overage_balance: z3.number().optional().describe("Prepaid units left beyond the included ones")
+        })
+      },
       annotations: READS
     },
     async () => {
       try {
-        const { workspace, organization, plan, environment, period: period2, units } = await client.account.get();
+        const { workspace, organization, plan, environment, period: period2, units } = await api().account.get();
         return text3({
           workspace,
           organization,
@@ -84670,7 +84829,7 @@ var authorizationServer = flag("--auth-server") ?? process.env["FORMFEED_AUTH_SE
 var publicOrigin = flag("--public-origin") ?? process.env["FORMFEED_PUBLIC_ORIGIN"];
 if (args.includes("--help") || args.includes("-h")) {
   process.stdout.write(
-    "formfeed-mcp: Model Context Protocol server for Formfeed\n\n  formfeed-mcp              stdio; needs FORMFEED_API_KEY\n  formfeed-mcp --http       Streamable HTTP on --port (8790) and --host (127.0.0.1); the key comes from Authorization: Bearer\n                            --auth-server <issuer> (or FORMFEED_AUTH_SERVER) also takes OAuth access tokens on /mcp and /mcp/<workspace id>;\n                            --public-origin <url> (or FORMFEED_PUBLIC_ORIGIN) is the origin clients see behind a proxy\n"
+    "formfeed-mcp: Model Context Protocol server for Formfeed\n\n  formfeed-mcp              stdio; FORMFEED_API_KEY, without it the offline checks only\n  formfeed-mcp --http       Streamable HTTP on --port (8790) and --host (127.0.0.1); the key comes from Authorization: Bearer\n                            --auth-server <issuer> (or FORMFEED_AUTH_SERVER) also takes OAuth access tokens on /mcp and /mcp/<workspace id>;\n                            --public-origin <url> (or FORMFEED_PUBLIC_ORIGIN) is the origin clients see behind a proxy\n"
   );
 } else if (args.includes("--http")) {
   startHttp({
@@ -84683,17 +84842,16 @@ if (args.includes("--help") || args.includes("-h")) {
   }).then((h) => process.stderr.write(`formfeed-mcp listening on ${h.url}
 `));
 } else {
-  const apiKey = process.env["FORMFEED_API_KEY"];
-  if (!apiKey) {
-    process.stderr.write("FORMFEED_API_KEY is required for the stdio server\n");
-    process.exitCode = 3;
-  } else {
-    startStdio({ apiKey, baseUrl, region }).catch((e) => {
-      process.stderr.write(`${e instanceof Error ? e.message : String(e)}
+  const apiKey = process.env["FORMFEED_API_KEY"] || void 0;
+  if (!apiKey)
+    process.stderr.write(
+      "FORMFEED_API_KEY is not set: only validate_template (with html) and check_invoice work\n"
+    );
+  startStdio({ apiKey, baseUrl, region }).catch((e) => {
+    process.stderr.write(`${e instanceof Error ? e.message : String(e)}
 `);
-      process.exitCode = 1;
-    });
-  }
+    process.exitCode = 1;
+  });
 }
 /*! Bundled license information:
 

package/package.json

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