faxseal-mcp 2.1.0 → 2.2.0

package/index.js

@@ -9,7 +9,7 @@ import {
 const BASE_URL = (process.env.FAXSEAL_BASE_URL ?? 'https://faxseal.com').replace(/\/+$/, '');
 const API_KEY  = process.env.FAXSEAL_API_KEY ?? '';
 const FETCH_TIMEOUT_MS = 30_000;
-const SERVER_VERSION = '2.1.0';
+const SERVER_VERSION = '2.2.0';
 
 if (!API_KEY) {
   process.stderr.write('Error: FAXSEAL_API_KEY environment variable is required.\n');
@@ -232,6 +232,37 @@ const handlers = {
 
     return ok(lines);
   },
+  open_pdf_editor: async (args) => {
+    if (!args.file_url) throw new Error('file_url is required');
+    const data = await apiFetch('/api/v1/pdf', {
+      method: 'POST',
+      headers: authHeaders(),
+      body: JSON.stringify({ file_url: args.file_url }),
+    });
+    return ok([
+      'PDF opened in the FaxSeal editor. Nothing has been edited, signed or sent yet.',
+      `Document ID: ${data.document_id}`,
+      `Pages: ${data.pages}`,
+      `Editor: ${data.editor_url}`,
+      `Link expires: ${data.expires_at}`,
+      'Give the user the editor link. They place their own text, dates and signature, click Apply and can download free.',
+      'Then call get_edited_pdf with this document ID. Ready means edits were applied; it does not verify a signature was added. Never claim it is signed unless the user confirms that.',
+    ]);
+  },
+
+  get_edited_pdf: async (args) => {
+    if (!args.document_id) throw new Error('document_id is required');
+    const data = await apiFetch(`/api/v1/pdf/${encodeURIComponent(args.document_id)}`, { headers: authHeaders() });
+    if (!data.ready) return ok([`Document ${args.document_id}: not finished yet. The user must apply their edits in the editor first.`]);
+    return ok([
+      `Document ${data.document_id} is ready.`,
+      `Pages: ${data.pages}`,
+      data.filename && `File: ${data.filename}`,
+      `Download: ${data.download_url}`,
+      `Download link expires: ${data.expires_at}`,
+      'Faxing is optional: only send this file with send_fax after the user explicitly approves the recipient and cost.',
+    ]);
+  },
 };
 
 // ---------------------------------------------------------------------------
@@ -334,6 +365,30 @@ const TOOL_DEFS = [
       },
     },
   },
+  {
+    name: 'open_pdf_editor',
+    description:
+      'Open a PDF from an HTTPS URL in the free FaxSeal editor so the user can add text, dates, checkboxes and their own signature, rotate or remove pages, and download. Does not send a fax or spend credits. Requires an API token with the "Edit and sign PDFs" permission on a personal account. The user must apply edits themselves; never claim the document is signed because this returned a link.',
+    inputSchema: {
+      type: 'object',
+      required: ['file_url'],
+      properties: {
+        file_url: { type: 'string', description: 'Publicly accessible HTTPS URL to a PDF file' },
+      },
+    },
+  },
+  {
+    name: 'get_edited_pdf',
+    description:
+      'Check whether the user has applied their edits to a document opened with open_pdf_editor. Returns not ready until they do, then a short-lived download URL that can also be passed to send_fax with separate user approval.',
+    inputSchema: {
+      type: 'object',
+      required: ['document_id'],
+      properties: {
+        document_id: { type: 'string', description: 'Document ID returned by open_pdf_editor' },
+      },
+    },
+  },
 ];
 
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "faxseal-mcp",
-  "version": "2.1.0",
-  "description": "MCP server for FaxSeal — send, receive, and verify faxes from AI assistants and agents",
+  "version": "2.2.0",
+  "description": "MCP server for FaxSeal — send, receive, and verify faxes, and edit or sign PDFs free, from AI assistants and agents",
   "main": "index.js",
   "bin": {
     "faxseal-mcp": "index.js"

package/server-http.js

@@ -13,7 +13,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 const PORT = parseInt(process.env.PORT ?? '3001', 10);
 const BASE_URL = (process.env.FAXSEAL_BASE_URL ?? 'https://faxseal.com').replace(/\/+$/, '');
 const FETCH_TIMEOUT_MS = 30_000;
-const SERVER_VERSION = '2.1.0';
+const SERVER_VERSION = '2.2.0';
 
 // ---------------------------------------------------------------------------
 // HTTP helper — per-request API key, hard timeout, no timer leaks
@@ -207,6 +207,36 @@ function makeHandlers(apiFetch) {
       }
       return ok(lines);
     },
+    open_pdf_editor: async (args) => {
+      if (!args.file_url) throw new Error('file_url is required');
+      const data = await apiFetch('/api/v1/pdf', {
+        method: 'POST',
+        body: JSON.stringify({ file_url: args.file_url }),
+      });
+      return ok([
+        'PDF opened in the FaxSeal editor. Nothing has been edited, signed or sent yet.',
+        `Document ID: ${data.document_id}`,
+        `Pages: ${data.pages}`,
+        `Editor: ${data.editor_url}`,
+        `Link expires: ${data.expires_at}`,
+        'Give the user the editor link. They place their own text, dates and signature, click Apply and can download free.',
+        'Then call get_edited_pdf with this document ID. Ready means edits were applied; it does not verify a signature was added. Never claim it is signed unless the user confirms that.',
+      ]);
+    },
+
+    get_edited_pdf: async (args) => {
+      if (!args.document_id) throw new Error('document_id is required');
+      const data = await apiFetch(`/api/v1/pdf/${encodeURIComponent(args.document_id)}`);
+      if (!data.ready) return ok([`Document ${args.document_id}: not finished yet. The user must apply their edits in the editor first.`]);
+      return ok([
+        `Document ${data.document_id} is ready.`,
+        `Pages: ${data.pages}`,
+        data.filename && `File: ${data.filename}`,
+        `Download: ${data.download_url}`,
+        `Download link expires: ${data.expires_at}`,
+        'Faxing is optional: only send this file with send_fax after the user explicitly approves the recipient and cost.',
+      ]);
+    },
   };
 }
 
@@ -293,6 +323,30 @@ const TOOL_DEFS = [
       },
     },
   },
+  {
+    name: 'open_pdf_editor',
+    description:
+      'Open a PDF from an HTTPS URL in the free FaxSeal editor so the user can add text, dates, checkboxes and their own signature, rotate or remove pages, and download. Does not send a fax or spend credits. Requires an API token with the "Edit and sign PDFs" permission on a personal account. The user must apply edits themselves; never claim the document is signed because this returned a link.',
+    inputSchema: {
+      type: 'object',
+      required: ['file_url'],
+      properties: {
+        file_url: { type: 'string', description: 'Publicly accessible HTTPS URL to a PDF file' },
+      },
+    },
+  },
+  {
+    name: 'get_edited_pdf',
+    description:
+      'Check whether the user has applied their edits to a document opened with open_pdf_editor. Returns not ready until they do, then a short-lived download URL that can also be passed to send_fax with separate user approval.',
+    inputSchema: {
+      type: 'object',
+      required: ['document_id'],
+      properties: {
+        document_id: { type: 'string', description: 'Document ID returned by open_pdf_editor' },
+      },
+    },
+  },
 ];
 
 // ---------------------------------------------------------------------------

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.grichardomi/faxseal",
   "title": "FaxSeal",
   "description": "Send, receive, and verify faxes from AI assistants and agents via FaxSeal.",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "repository": {
     "url": "https://github.com/grichardomi/mcp-server",
     "source": "github"
@@ -19,7 +19,7 @@
       "registryType": "npm",
       "name": "faxseal-mcp",
       "identifier": "faxseal-mcp",
-      "version": "2.1.0",
+      "version": "2.2.0",
       "runtime": "node",
       "transport": { "type": "stdio" },
       "environmentVariables": [