gurupdf-mcp 0.1.0 → 0.1.2

package/README.md

@@ -1,8 +1,7 @@
 # GuruPDF MCP — convert PDFs & 100+ file formats from your AI agent
 
 [![npm version](https://img.shields.io/npm/v/gurupdf-mcp.svg)](https://www.npmjs.com/package/gurupdf-mcp)
-[![npm downloads](https://img.shields.io/npm/dm/gurupdf-mcp.svg)](https://www.npmjs.com/package/gurupdf-mcp)
-[![license: MIT](https://img.shields.io/npm/l/gurupdf-mcp.svg)](./LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/GuruPDF/gurupdf-mcp/blob/main/LICENSE)
 
 A free **[Model Context Protocol](https://modelcontextprotocol.io) (MCP) server** that lets Claude, Cursor, VS Code, Windsurf and other AI agents **convert, compress, merge, split and edit PDFs — and convert between 100+ file formats** (Word, Excel, PowerPoint, JPG, PNG, HEIC, ebooks, and more), right on your own machine. Powered by [GuruPDF](https://gurupdf.com).
 

package/dist/client.js

@@ -45,8 +45,17 @@ export class GuruPdfClient {
         }
         if (!res.ok) {
             const err = parsed?.error ?? {};
-            throw new GuruPdfError(err.message ?? `Request failed (HTTP ${res.status})`, {
-                code: err.code ?? `HTTP_${res.status}`,
+            // Laravel validation errors come back as { message, errors: { field: [msg,…] } }
+            // with no `error` wrapper — surface those instead of a bare "HTTP 422".
+            const validation = parsed?.errors && typeof parsed.errors === "object"
+                ? Object.values(parsed.errors).flat().filter(Boolean)
+                : [];
+            const message = (err.message ??
+                (validation.length ? validation.join(" ") : undefined) ??
+                parsed?.message ??
+                `Request failed (HTTP ${res.status})`).replace(/\bfiles\.\d+\b/g, "file");
+            throw new GuruPdfError(message, {
+                code: err.code ?? parsed?.code ?? `HTTP_${res.status}`,
                 status: res.status,
                 meta: parsed?.meta ?? err.meta,
                 retryAfter,
@@ -99,7 +108,7 @@ export class GuruPdfClient {
                 /* ignore */
             }
             const err = parsed?.error ?? {};
-            throw new GuruPdfError(err.message ?? `Download failed (HTTP ${res.status})`, {
+            throw new GuruPdfError(err.message ?? parsed?.message ?? `Download failed (HTTP ${res.status})`, {
                 code: err.code ?? `HTTP_${res.status}`,
                 status: res.status,
                 meta: parsed?.meta,

package/dist/index.js

@@ -52,7 +52,7 @@ async function pollUntilDone(uuid, timeoutMs = 5 * 60 * 1000) {
     }
     return (await client.getConversion(uuid)).data;
 }
-const server = new McpServer({ name: "gurupdf", version: "0.1.0" });
+const server = new McpServer({ name: "gurupdf", version: "0.1.2" });
 server.tool("convert_file", "Convert or process a local file (or URL) with GuruPDF. Convert between 100+ formats (PDF ⇄ Word/Excel/PowerPoint, images, ebooks, etc.) or run a PDF tool (compress, merge, split, rotate, protect, watermark, OCR…). Saves the result next to the input and returns the path.", {
     input: z
         .union([z.string(), z.array(z.string())])
@@ -74,7 +74,15 @@ server.tool("convert_file", "Convert or process a local file (or URL) with GuruP
         const urlMode = inputs.length === 1 && isUrl(inputs[0]);
         const inputExt = urlMode ? "" : extname(inputs[0]).toLowerCase();
         const tools = await catalog();
-        const tool = resolveTool(tools, to, inputExt);
+        // URL inputs only work with URL tools (e.g. url-to-pdf). resolveTool keys off the
+        // input extension, which is empty for a URL, so route URL mode explicitly — otherwise
+        // it falls through to the shortest-slug file tool (merge-pdf, …) and the API 422s.
+        const tool = urlMode
+            ? tools.find((t) => t.slug === to) ??
+                tools.find((t) => (t.accepted_formats?.length ?? 0) === 0 &&
+                    t.output_format?.toLowerCase() === "." + to.replace(/^\./, "").toLowerCase()) ??
+                tools.find((t) => (t.accepted_formats?.length ?? 0) === 0)
+            : resolveTool(tools, to, inputExt);
         if (!tool) {
             return text(`I couldn't find a GuruPDF tool to turn ${inputExt || "that input"} into "${to}". ` +
                 `Run list_conversions${inputExt ? ` with from_format "${inputExt.slice(1)}"` : ""} to see the options.`);

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "gurupdf-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Model Context Protocol server for GuruPDF — convert, compress, merge and edit PDFs and 100+ file formats from any AI agent (Claude, Cursor, VS Code, Windsurf).",
   "license": "MIT",
+  "mcpName": "io.github.GuruPDF/gurupdf-mcp",
   "type": "module",
   "bin": {
     "gurupdf-mcp": "dist/index.js"