pdfops-mcp 0.1.0 → 0.2.0

package/README.md

@@ -33,7 +33,7 @@ claude mcp add pdfops -- npx -y pdfops-mcp
 | Tool | What it does |
 |---|---|
 | `pdf_inspect` | List a PDF's form fields (names, types, options, values) + a paste-ready fill template. Call first on unfamiliar PDFs. |
-| `pdf_fill` | Fill AcroForm fields → write the filled PDF. |
+| `pdf_fill` | Fill AcroForm fields → write the filled PDF. Optional `flatten` bakes values in and drops the form. |
 | `pdf_merge` | Merge ≥2 PDFs in order → write the result. |
 | `pdf_invoice` | Structured data → complete invoice PDF. Deterministic: same input, byte-identical output. |
 | `pdfops_usage` | Quota check for the configured key. |

package/dist/index.js

@@ -1,24 +1,23 @@
 #!/usr/bin/env node
-
-// src/index.ts
+#!/usr/bin/env node
 import { readFile, writeFile } from "node:fs/promises";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { PdfOps, PdfOpsError } from "pdfops-sdk";
-var client = new PdfOps({
+const client = new PdfOps({
   apiKey: process.env.PDFOPS_API_KEY,
   baseUrl: process.env.PDFOPS_BASE_URL,
   clientTag: "mcp"
 });
-var server = new McpServer({
+const server = new McpServer({
   name: "pdfops",
-  version: "0.1.0"
+  version: "0.1.1"
 });
-var errText = (e) => e instanceof PdfOpsError ? `PDFops API error ${e.status} (${e.code}): ${e.message}` + (e.code === "rate_limited" ? " \u2014 get a free API key (250/mo) at https://pdfops.dev/pricing and set PDFOPS_API_KEY" : "") : String(e);
+const errText = (e) => e instanceof PdfOpsError ? `PDFops API error ${e.status} (${e.code}): ${e.message}` + (e.code === "rate_limited" ? " \u2014 get a free API key (250/mo) at https://pdfops.dev/pricing and set PDFOPS_API_KEY" : "") : String(e);
 server.tool(
   "pdf_inspect",
-  "List a PDF's AcroForm form fields \u2014 names, types, options, current values \u2014 plus a paste-ready fillTemplate object for pdf_fill. A PDF with no form returns count 0. Call this FIRST when filling an unfamiliar PDF: you cannot fill fields whose names you do not know.",
+  "List a PDF's AcroForm form fields \u2014 names, types, options, current values, per-field maxLength where declared \u2014 plus a paste-ready fillTemplate object for pdf_fill and a hasXFA flag (hybrid AcroForm/XFA inputs lose their XFA layer when filled). A PDF with no form returns count 0. Call this FIRST when filling an unfamiliar PDF: you cannot fill fields whose names you do not know, and values longer than a field's maxLength are rejected.",
   { pdf_path: z.string().describe("Absolute path to the PDF to inspect") },
   async ({ pdf_path }) => {
     try {
@@ -31,15 +30,16 @@ server.tool(
 );
 server.tool(
   "pdf_fill",
-  `Fill AcroForm form fields in a PDF and save the result. Field names must exist in the PDF (use pdf_inspect first). All values are strings; checkboxes take "true"/"false"; dropdown/radio/optionlist values must be one of the field's options.`,
+  `Fill AcroForm form fields in a PDF and save the result. Field names must exist in the PDF (use pdf_inspect first). All values are strings; checkboxes take "true"/"false"; dropdown/radio/optionlist values must be one of the field's options; text values must respect the field's maxLength from pdf_inspect. Encrypted PDFs are rejected with decrypt advice (common for government blanks with an empty user password).`,
   {
     pdf_path: z.string().describe("Absolute path to the template PDF"),
     fields: z.record(z.string()).describe("Field name \u2192 string value (from pdf_inspect's fillTemplate)"),
-    output_path: z.string().describe("Absolute path to write the filled PDF")
+    output_path: z.string().describe("Absolute path to write the filled PDF"),
+    flatten: z.boolean().optional().describe("Bake values into page content and drop the AcroForm so fields are no longer editable")
   },
-  async ({ pdf_path, fields, output_path }) => {
+  async ({ pdf_path, fields, output_path, flatten }) => {
     try {
-      const bytes = await client.fillForm(await readFile(pdf_path), fields);
+      const bytes = await client.fillForm(await readFile(pdf_path), fields, { flatten });
       await writeFile(output_path, bytes);
       return {
         content: [
@@ -129,5 +129,5 @@ server.tool(
     }
   }
 );
-var transport = new StdioServerTransport();
+const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "pdfops-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "mcpName": "dev.pdfops/pdfops-mcp",
   "description": "MCP server for the PDFops API \u2014 give AI agents deterministic PDF tools: inspect AcroForm fields, fill forms, merge PDFs, and generate invoices. Works with Claude Code, Claude Desktop, Cursor, and any MCP client.",
   "keywords": [
     "mcp",
@@ -15,7 +16,7 @@
     "cursor"
   ],
   "homepage": "https://pdfops.dev",
-  "bugs": "mailto:hello@pdfops.dev",
+  "bugs": "https://github.com/pdfops/pdfops-mcp/issues",
   "author": "PDFops <hello@pdfops.dev> (https://pdfops.dev)",
   "license": "MIT",
   "type": "module",
@@ -31,7 +32,11 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "pdfops-sdk": "^0.3.0",
+    "pdfops-sdk": "^0.4.0",
     "zod": "^3.23.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pdfops/pdfops-mcp.git"
   }
 }