@plaud-ai/mcp 0.3.5 → 0.3.7

package/dist/{chunk-SEOLTKA5.js → chunk-3K3M2X74.js}

@@ -1,7 +1,7 @@
 import {
   PlaudClient,
   capture
-} from "./chunk-FDWRBOUI.js";
+} from "./chunk-OYI4PXYP.js";
 import {
   httpClientDuration,
   httpClientRequests

package/dist/{chunk-FDWRBOUI.js → chunk-OYI4PXYP.js}

@@ -429,6 +429,23 @@ function runOAuthCallback(opts) {
   });
 }
 
+// ../shared/dist/source-block.js
+async function loadBlockContent(block) {
+  if (!block)
+    return "";
+  const inline = block.data_content;
+  if (typeof inline === "string" && inline.length > 0)
+    return inline;
+  const link = block.data_link;
+  if (typeof link === "string" && link.length > 0) {
+    const res = await fetch(link);
+    if (!res.ok)
+      throw new Error(`Failed to fetch block content from data_link (HTTP ${res.status})`);
+    return await res.text();
+  }
+  return "";
+}
+
 // ../telemetry/dist/client.js
 import { PostHog } from "posthog-node";
 
@@ -841,6 +858,7 @@ export {
   clientUserIdFromAccessToken,
   PlaudClient,
   runOAuthCallback,
+  loadBlockContent,
   shutdown,
   initTelemetry,
   setUser,

package/dist/{chunk-YI4KJEAG.js → chunk-VLZPO2CO.js}

@@ -1,7 +1,8 @@
 import {
   capture,
-  classifyError
-} from "./chunk-FDWRBOUI.js";
+  classifyError,
+  loadBlockContent
+} from "./chunk-OYI4PXYP.js";
 import {
   logger
 } from "./chunk-NPCCDRWQ.js";
@@ -16,6 +17,22 @@ import { randomUUID } from "crypto";
 var toolHooks = null;
 var MAX_FILTER_PAGES = 5;
 var FILTER_PAGE_SIZE = 100;
+var TRANSCRIPT_PAGE_SIZE = 50;
+var TRANSCRIPT_BLOCKS = ["transaction", "outline", "transaction_polish"];
+function encodeTranscriptCursor(offset) {
+  return Buffer.from(JSON.stringify({ o: offset }), "utf8").toString("base64url");
+}
+function decodeTranscriptCursor(cursor) {
+  try {
+    const parsed = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+    if (typeof parsed?.o === "number" && Number.isInteger(parsed.o) && parsed.o >= 0) {
+      return parsed.o;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
 function parseDate(s) {
   if (!s) return null;
   const d = new Date(s);
@@ -157,9 +174,14 @@ function registerTools(server, client, hooks) {
       const requestId = emitToolClick("get_file", { file_id });
       try {
         const file = await client.getFile(file_id);
+        let text = JSON.stringify(file, null, 2);
+        if (!file.presigned_url) {
+          const synced = !!(file.duration || file.source_list && file.source_list.length);
+          text += synced ? "\n\nNote: `presigned_url` (audio download URL) is null for this otherwise-synced recording. This is usually a transient backend signing issue \u2014 retry get_file in a few minutes to obtain the URL." : "\n\nNote: `presigned_url` (audio download URL) is null \u2014 audio may not yet be available for this recording.";
+        }
         recordToolMetric("get_file", "success", Date.now() - start, requestId, { file_id });
-        logger.info({ event: "tool_call_end", tool: "get_file", duration_ms: Date.now() - start });
-        return { content: [{ type: "text", text: JSON.stringify(file, null, 2) }] };
+        logger.info({ event: "tool_call_end", tool: "get_file", duration_ms: Date.now() - start, presigned_url_present: !!file.presigned_url });
+        return { content: [{ type: "text", text }] };
       } catch (err) {
         recordToolMetric("get_file", "error", Date.now() - start, requestId, { file_id }, err);
         logger.error({ event: "tool_call_error", tool: "get_file", duration_ms: Date.now() - start, error: String(err) });
@@ -198,24 +220,90 @@ function registerTools(server, client, hooks) {
   server.registerTool(
     "get_transcript",
     {
-      description: "Fetch the full timestamped transcript with speaker attribution for a Plaud recording",
+      description: "Fetch the timestamped transcript with speaker attribution for a Plaud recording. Defaults to the `transaction` block (real speaker names + timestamps), returned one page of utterances at a time to stay within client size limits \u2014 call again with the returned `next_cursor` to fetch the next page. Set `block` to `outline` or `transaction_polish` to fetch those blocks instead.",
       annotations: {
         title: "Get recording transcript",
         readOnlyHint: true,
         destructiveHint: false,
         openWorldHint: true
       },
-      inputSchema: { file_id: z.string().describe("The file ID to retrieve transcript for") }
+      inputSchema: {
+        file_id: z.string().describe("The file ID to retrieve transcript for"),
+        block: z.enum(TRANSCRIPT_BLOCKS).optional().describe(
+          "Which source block to fetch: `transaction` (default; raw transcript, speaker + timestamps), `transaction_polish` (AI-cleaned transcript; same per-utterance shape, keeps speaker + timestamps), or `outline`."
+        ),
+        cursor: z.string().optional().describe("Opaque pagination cursor from a previous call's `next_cursor`. Omit to start from the first utterance."),
+        limit: z.number().int().min(1).max(500).optional().describe(`Max utterances to return in this page (default ${TRANSCRIPT_PAGE_SIZE}). Only applies to blocks returned as an utterance list.`)
+      }
     },
-    async ({ file_id }) => {
+    async ({ file_id, block, cursor, limit }) => {
       const start = Date.now();
-      logger.info({ event: "tool_call", tool: "get_transcript", file_id });
+      const blockType = block ?? "transaction";
+      logger.info({ event: "tool_call", tool: "get_transcript", file_id, block: blockType });
       const requestId = emitToolClick("get_transcript", { file_id });
       try {
         const file = await client.getFile(file_id);
+        const sourceList = file.source_list ?? [];
+        if (sourceList.length === 0) {
+          recordToolMetric("get_transcript", "success", Date.now() - start, requestId, { file_id });
+          logger.info({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start, paginated: false });
+          return { content: [{ type: "text", text: JSON.stringify(file.source_list ?? [], null, 2) }] };
+        }
+        const selected = sourceList.find((s) => s.data_type === blockType);
+        if (!selected) {
+          const available = sourceList.map((s) => s.data_type).filter(Boolean).join(", ") || "(none)";
+          recordToolMetric("get_transcript", "success", Date.now() - start, requestId, { file_id });
+          logger.info({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start, block: blockType, found: false });
+          return {
+            content: [{ type: "text", text: `Block "${blockType}" not available for this recording. Available blocks: ${available}.` }]
+          };
+        }
+        const content = await loadBlockContent(selected);
+        let segments = null;
+        if (content) {
+          try {
+            const parsed = JSON.parse(content);
+            if (Array.isArray(parsed)) segments = parsed;
+          } catch {
+            segments = null;
+          }
+        }
+        if (!segments) {
+          recordToolMetric("get_transcript", "success", Date.now() - start, requestId, { file_id });
+          logger.info({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start, block: blockType, paginated: false });
+          const text = content || `Block "${blockType}" has no content for this recording yet.`;
+          return { content: [{ type: "text", text }] };
+        }
+        let offset = 0;
+        if (cursor !== void 0) {
+          const decoded = decodeTranscriptCursor(cursor);
+          if (decoded === null) {
+            recordToolMetric("get_transcript", "error", Date.now() - start, requestId, { file_id }, new Error("invalid_cursor"));
+            logger.warn({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start, error: "invalid_cursor" });
+            return {
+              content: [{ type: "text", text: "Invalid cursor. Omit `cursor` to start from the first utterance." }],
+              isError: true
+            };
+          }
+          offset = decoded;
+        }
+        const pageSize = limit ?? TRANSCRIPT_PAGE_SIZE;
+        const page = segments.slice(offset, offset + pageSize);
+        const nextOffset = offset + page.length;
+        const hasMore = nextOffset < segments.length;
+        const payload = {
+          file_id,
+          block: blockType,
+          total: segments.length,
+          offset,
+          limit: pageSize,
+          returned: page.length,
+          next_cursor: hasMore ? encodeTranscriptCursor(nextOffset) : null,
+          segments: page
+        };
         recordToolMetric("get_transcript", "success", Date.now() - start, requestId, { file_id });
-        logger.info({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start });
-        return { content: [{ type: "text", text: JSON.stringify(file.source_list ?? [], null, 2) }] };
+        logger.info({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start, block: blockType, paginated: true, total: segments.length, offset, returned: page.length });
+        return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
       } catch (err) {
         recordToolMetric("get_transcript", "error", Date.now() - start, requestId, { file_id }, err);
         logger.error({ event: "tool_call_error", tool: "get_transcript", duration_ms: Date.now() - start, error: String(err) });

package/dist/index.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   getClient
-} from "./chunk-SEOLTKA5.js";
+} from "./chunk-3K3M2X74.js";
 import {
   loadSkills
 } from "./chunk-242FRP4P.js";
 import {
   normalizeMcpHost,
   registerTools
-} from "./chunk-YI4KJEAG.js";
+} from "./chunk-VLZPO2CO.js";
 import {
   capture,
   classifyError,
@@ -21,7 +21,7 @@ import {
   setMcpHost,
   setUser,
   shutdown
-} from "./chunk-FDWRBOUI.js";
+} from "./chunk-OYI4PXYP.js";
 import "./chunk-NPCCDRWQ.js";
 import "./chunk-RUFCT6DQ.js";
 
@@ -31,7 +31,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import open from "open";
 var server = new McpServer({
   name: "plaud",
-  version: "0.3.5"
+  version: "0.3.7"
 });
 var CALLBACK_PORT = 8199;
 var LOGIN_TIMEOUT_MS = 12e4;
@@ -158,7 +158,7 @@ async function main() {
   const sub = process.argv[2];
   const sub2 = process.argv[3];
   if (sub === "install") {
-    const { runInstall } = await import("./install-OHOKLBHH.js");
+    const { runInstall } = await import("./install-3E63G6QX.js");
     const args = process.argv.slice(3);
     const yes = args.some((a) => a === "--yes" || a === "-y");
     const noLogin = args.some((a) => a === "--no-login");
@@ -191,7 +191,7 @@ async function main() {
     return;
   }
   if (sub === "http") {
-    const { startHttpServer } = await import("./server-XUKJZCFN.js");
+    const { startHttpServer } = await import("./server-2HG4R4LT.js");
     const { startMetricsServer } = await import("./server-NKCNUA6P.js");
     startMetricsServer();
     startHttpServer();
@@ -217,7 +217,7 @@ Usage:
   try {
     await initTelemetry({
       surface: "mcp",
-      appVersion: "0.3.5",
+      appVersion: "0.3.7",
       transport: "stdio"
     });
   } catch {

package/dist/{install-OHOKLBHH.js → install-3E63G6QX.js}

@@ -1,6 +1,6 @@
 import {
   getClient
-} from "./chunk-SEOLTKA5.js";
+} from "./chunk-3K3M2X74.js";
 import {
   commandPathIsStale,
   copyToClipboard,
@@ -12,7 +12,7 @@ import {
 } from "./chunk-242FRP4P.js";
 import {
   runOAuthCallback
-} from "./chunk-FDWRBOUI.js";
+} from "./chunk-OYI4PXYP.js";
 import "./chunk-RUFCT6DQ.js";
 
 // src/install.ts

package/dist/{server-XUKJZCFN.js → server-2HG4R4LT.js}

@@ -1,10 +1,10 @@
 import {
   normalizeMcpHost,
   registerTools
-} from "./chunk-YI4KJEAG.js";
+} from "./chunk-VLZPO2CO.js";
 import {
   PlaudClient
-} from "./chunk-FDWRBOUI.js";
+} from "./chunk-OYI4PXYP.js";
 import {
   logger
 } from "./chunk-NPCCDRWQ.js";
@@ -1205,8 +1205,8 @@ function startHttpServer() {
     common: {
       serviceName: process.env.PLAUD_WAREHOUSE_SERVICE_NAME ?? "plaudmcp",
       // matches §1.3 key label `plaudmcp:TRACKING_KEY_PLAUDMCP`; confirm exact string with David
-      serviceVersion: "0.3.5",
-      buildId: "38e7de5",
+      serviceVersion: "0.3.7",
+      buildId: "43da41f",
       // mcp tsup TODO: inject git short SHA (like CLI)
       region: process.env.PLAUD_REGION ?? "US",
       env: process.env.PLAUD_ENV ?? process.env.NODE_ENV ?? "development"
@@ -1428,7 +1428,15 @@ function startHttpServer() {
       issuerUrl,
       baseUrl: issuerUrl,
       resourceServerUrl: new URL(mcpResourceUrl),
-      resourceName: "Plaud MCP Server"
+      resourceName: "Plaud MCP Server",
+      // Disable the SDK's default DCR rate limit (20/hour, keyed per client IP).
+      // Directory clients like Claude perform Dynamic Client Registration from a
+      // small pool of *shared server-side egress IPs*, so a per-IP cap acts as a
+      // near-global limit and rejects legitimate new users with "Couldn't
+      // register…" once new-registration rate exceeds ~20/hour. Real auth still
+      // happens upstream at Plaud; abuse/unbounded-growth should be bounded on
+      // the in-memory client store (size/TTL cap) rather than via this per-IP limiter.
+      clientRegistrationOptions: { rateLimit: false }
     })
   );
   app.post(
@@ -1447,7 +1455,7 @@ function startHttpServer() {
         apiBase,
         staticToken: token
       });
-      const mcpServer = new McpServer({ name: "plaud", version: "0.3.5" });
+      const mcpServer = new McpServer({ name: "plaud", version: "0.3.7" });
       registerTools(mcpServer, client, warehouseToolHooks);
       const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: void 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaud-ai/mcp",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "plaud",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Access your Plaud recordings in Claude",
   "author": {
     "name": "Plaud AI"

package/skills/plaud-read/SKILL.md

@@ -22,7 +22,7 @@ metadata:
 | User wants | Tool | Notes |
 |---|---|---|
 | AI summary, TL;DR, action items | `get_note` | Returns Markdown; usually enough — try this before `get_transcript` |
-| Verbatim quotes, full dialogue | `get_transcript` | Timestamped; larger |
+| Verbatim quotes, full dialogue | `get_transcript` | Timestamped; paginated — follow `next_cursor` for long recordings |
 | Audio download link | `get_file` then use `presigned_url` | Link expires in 24h |
 | Full metadata + availability flags | `get_file` | Check `source_list` / `note_list` populated before claiming content exists |
 
@@ -47,5 +47,5 @@ Common schemas:
 
 ## Anti-patterns
 
-- Do not call `get_transcript` speculatively — it's the largest payload.
+- Do not call `get_transcript` speculatively — it's the largest payload (paged; a long recording needs several `next_cursor` calls).
 - Do not paraphrase the AI summary unless the user asked; quote it verbatim.