@papermark/mcp-server 0.9.0 → 0.9.1

package/dist/index.js

@@ -58,12 +58,23 @@ import {
   updateDocumentContract,
   updateFolderContract,
   updateLinkContract
-} from "./chunk-STGR2RDC.js";
+} from "./chunk-3I6OOD2X.js";
 
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
+// src/client-info.ts
+var hostName;
+var hostVersion;
+function setClientHost(name, version) {
+  hostName = name?.trim() || void 0;
+  hostVersion = version?.trim() || void 0;
+}
+function getClientHost() {
+  return { name: hostName, version: hostVersion };
+}
+
 // src/tools.ts
 import { readFile, stat } from "fs/promises";
 import { basename } from "path";
@@ -79,6 +90,104 @@ function getApiUrl() {
   return process.env.PAPERMARK_API_URL?.trim() || DEFAULT_API_URL;
 }
 
+// src/debug.ts
+var enabled = process.env.PAPERMARK_DEBUG === "1" || process.env.PAPERMARK_DEBUG === "true";
+function debug(category, ...parts) {
+  if (!enabled) return;
+  const line = parts.map(safeStringify).join(" ");
+  process.stderr.write(`[papermark-mcp:${category}] ${line}
+`);
+}
+function safeStringify(p) {
+  if (typeof p === "string") return p;
+  try {
+    return JSON.stringify(p) ?? String(p);
+  } catch {
+    return String(p);
+  }
+}
+
+// package.json
+var package_default = {
+  name: "@papermark/mcp-server",
+  version: "0.9.1",
+  description: "Model Context Protocol server for Papermark \u2014 give AI assistants access to your data rooms, documents, share links, and analytics.",
+  license: "MIT",
+  homepage: "https://www.papermark.com",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/papermark/papermark-mcp-server.git"
+  },
+  bugs: {
+    url: "https://github.com/papermark/papermark-mcp-server/issues"
+  },
+  keywords: [
+    "papermark",
+    "dataroom",
+    "virtual-dataroom",
+    "datarooms",
+    "mcp",
+    "model-context-protocol",
+    "agents",
+    "documents"
+  ],
+  type: "module",
+  bin: {
+    "papermark-mcp": "dist/index.js"
+  },
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      default: "./dist/index.js"
+    },
+    "./tools-contract": {
+      types: "./dist/tools-contract.d.ts",
+      default: "./dist/tools-contract.js"
+    }
+  },
+  publishConfig: {
+    access: "public"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  engines: {
+    node: ">=24"
+  },
+  scripts: {
+    build: "tsup",
+    dev: "tsx src/index.ts",
+    typecheck: "tsc --noEmit",
+    test: "node --import tsx --test test/*.test.ts",
+    smoke: "npm run build && node scripts/smoke.mjs",
+    changeset: "changeset",
+    version: "changeset version",
+    release: "npm run build && changeset publish",
+    prepublishOnly: "npm run build"
+  },
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "mime-types": "^3.0.2",
+    zod: "^4.4.3"
+  },
+  devDependencies: {
+    "@changesets/changelog-github": "^0.7.0",
+    "@changesets/cli": "^2.31.0",
+    "@types/mime-types": "^3.0.1",
+    "@types/node": "^24.12.4",
+    tsup: "^8.3.5",
+    tsx: "^4.21.0",
+    typescript: "^5.7.2"
+  }
+};
+
+// src/version.ts
+var VERSION = package_default.version;
+var CLIENT_ID = "mcp";
+var USER_AGENT = `papermark-mcp/${VERSION} (node ${process.version}; ${process.platform} ${process.arch})`;
+
 // src/client.ts
 var ApiError = class extends Error {
   code;
@@ -146,9 +255,29 @@ function buildUrl(path, query) {
   }
   return url.toString();
 }
+function isSafeHeaderValue(v) {
+  return !/[\u0000-\u001F\u007F]/.test(v);
+}
+function clientHostHeaders() {
+  const { name, version } = getClientHost();
+  const out = {};
+  if (name && isSafeHeaderValue(name)) out["x-papermark-client-host"] = name;
+  if (version && isSafeHeaderValue(version)) {
+    out["x-papermark-client-host-version"] = version;
+  }
+  return out;
+}
 async function request(path, opts = {}) {
   const headers = {
     Accept: "application/json",
+    // Identify the caller so the API can attribute usage to the MCP server
+    // (vs the CLI or raw HTTP), its version, and the host the agent runs in
+    // (Claude Desktop, Cursor, …). Caller-supplied headers still win via the
+    // spread below.
+    "User-Agent": USER_AGENT,
+    "x-papermark-client": CLIENT_ID,
+    "x-papermark-client-version": VERSION,
+    ...clientHostHeaders(),
     ...opts.headers ?? {}
   };
   if (!opts.anonymous) {
@@ -166,40 +295,63 @@ async function request(path, opts = {}) {
     }
   }
   const url = buildUrl(path, opts.query);
+  const method = opts.method ?? (opts.body ? "POST" : "GET");
   const controller = new AbortController();
   const timeoutMs = opts.timeout ?? DEFAULT_TIMEOUT_MS;
   const timer = setTimeout(() => controller.abort(), timeoutMs);
-  let res;
+  const started = Date.now();
+  debug("http", method, url, body ? "(body)" : "");
+  const asTimeout = (err) => controller.signal.aborted || err instanceof Error && err.name === "AbortError";
   try {
-    res = await fetch(url, {
-      method: opts.method ?? (opts.body ? "POST" : "GET"),
-      headers,
-      body,
-      signal: controller.signal
-    });
-  } catch (err) {
-    if (controller.signal.aborted || err instanceof Error && err.name === "AbortError") {
-      throw new NetworkError(
-        url,
-        new Error(`Request exceeded ${timeoutMs}ms timeout`)
-      );
+    let res;
+    try {
+      res = await fetch(url, {
+        method,
+        headers,
+        body,
+        signal: controller.signal
+      });
+    } catch (err) {
+      if (asTimeout(err)) {
+        debug("http", method, url, "timeout after", `${timeoutMs}ms`);
+        throw new NetworkError(
+          url,
+          new Error(`Request exceeded ${timeoutMs}ms timeout`)
+        );
+      }
+      debug("http", "network error after", `${Date.now() - started}ms`, String(err));
+      throw new NetworkError(url, err);
+    }
+    const requestId = res.headers.get("x-request-id") ?? "";
+    debug("http", method, url, `\u2192 ${res.status}`, requestId, `(${Date.now() - started}ms)`);
+    if (res.status === 204) return void 0;
+    let text;
+    try {
+      text = await res.text();
+    } catch (err) {
+      if (asTimeout(err)) {
+        debug("http", method, url, "timeout reading body after", `${timeoutMs}ms`);
+        throw new NetworkError(
+          url,
+          new Error(`Request exceeded ${timeoutMs}ms timeout`)
+        );
+      }
+      debug("http", "body read error after", `${Date.now() - started}ms`, String(err));
+      throw new NetworkError(url, err);
     }
-    throw new NetworkError(url, err);
+    const parsed = text ? safeParseJson(text) : null;
+    if (!res.ok) {
+      if (parsed && typeof parsed === "object" && "error" in parsed) {
+        throw new ApiError(res.status, parsed.error);
+      }
+      const looksLikeHtml = text.trimStart().toLowerCase().startsWith("<");
+      const msg = looksLikeHtml ? `HTTP ${res.status} (server returned HTML, not JSON \u2014 is the API reachable?)` : text || `HTTP ${res.status}`;
+      throw new ApiError(res.status, msg);
+    }
+    return parsed ?? void 0;
   } finally {
     clearTimeout(timer);
   }
-  if (res.status === 204) return void 0;
-  const text = await res.text();
-  const parsed = text ? safeParseJson(text) : null;
-  if (!res.ok) {
-    if (parsed && typeof parsed === "object" && "error" in parsed) {
-      throw new ApiError(res.status, parsed.error);
-    }
-    const looksLikeHtml = text.trimStart().toLowerCase().startsWith("<");
-    const msg = looksLikeHtml ? `HTTP ${res.status} (server returned HTML, not JSON \u2014 is the API reachable?)` : text || `HTTP ${res.status}`;
-    throw new ApiError(res.status, msg);
-  }
-  return parsed ?? void 0;
 }
 function safeParseJson(s) {
   try {
@@ -224,7 +376,12 @@ var api = {
     body,
     token
   }),
-  createDocument: (body, token) => request("/v1/documents", { method: "POST", body, token }),
+  createDocument: (body, token, opts) => request("/v1/documents", {
+    method: "POST",
+    body,
+    token,
+    timeout: opts?.timeout
+  }),
   // Document versions
   listDocumentVersions: (id, token) => request(`/v1/documents/${id}/versions`, { token }),
   addDocumentVersion: (id, body, token) => request(`/v1/documents/${id}/versions`, {
@@ -445,8 +602,11 @@ function toStructuredContent(result) {
   return { result };
 }
 async function run(fn, label) {
+  const started = Date.now();
+  debug("tool", label, "called");
   try {
     const result = await fn();
+    debug("tool", label, "ok", `(${Date.now() - started}ms)`);
     const structuredContent = toStructuredContent(result);
     return {
       structuredContent,
@@ -455,6 +615,13 @@ async function run(fn, label) {
       ]
     };
   } catch (err) {
+    debug(
+      "tool",
+      label,
+      "error",
+      err instanceof Error ? err.name : "unknown",
+      `(${Date.now() - started}ms)`
+    );
     if (err instanceof ApiError) {
       const detail = err.details !== void 0 && err.details !== null ? `
 Details: ${JSON.stringify(err.details)}` : "";
@@ -643,12 +810,19 @@ Don't add any source the user didn't explicitly point at. Requires scope \`docum
       }
       if (args.source_url) {
         const name = args.name ?? filenameFromUrl(args.source_url);
-        const doc2 = await api.createDocument({
-          name,
-          source_url: args.source_url,
-          folder_id: args.folder_id,
-          create_link: args.create_link
-        });
+        const doc2 = await api.createDocument(
+          {
+            name,
+            source_url: args.source_url,
+            folder_id: args.folder_id,
+            create_link: args.create_link
+          },
+          void 0,
+          // The server streams up to 100 MB from source_url synchronously
+          // before responding; give it the same 5-minute budget as the
+          // file_path PUT so a slow-but-healthy import isn't aborted at 60s.
+          { timeout: 5 * 6e4 }
+        );
         return { document: doc2 };
       }
       const filePath = args.file_path;
@@ -1462,11 +1636,15 @@ Don't add any source the user didn't explicitly point at. Requires scope \`docum
 // src/index.ts
 var SERVER_INFO = {
   name: "papermark-mcp",
-  version: "0.1.0"
+  version: VERSION
 };
 async function main() {
   const server = new McpServer(SERVER_INFO, { capabilities: { tools: {} } });
   registerTools(server);
+  server.server.oninitialized = () => {
+    const client = server.server.getClientVersion();
+    setClientHost(client?.name, client?.version);
+  };
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }