@speakai/mcp-server 1.8.0 → 1.10.0

package/README.md

@@ -242,7 +242,7 @@ For questions about data handling, see [speakai.co/privacy](https://speakai.co/p
 
 ## What you can do once installed
 
-Speak AI ships 83 tools your AI assistant can call. You don't memorize them — Claude/ChatGPT pick the right ones based on what you ask. Examples by category:
+Speak AI ships 84 tools your AI assistant can call. You don't memorize them — Claude/ChatGPT pick the right ones based on what you ask. Examples by category:
 
 | Ask | Tools used (auto) |
 |---|---|
@@ -250,6 +250,7 @@ Speak AI ships 83 tools your AI assistant can call. You don't memorize them —
 | "Summarize this week's meetings into decisions, owners, and risks" | `list_media`, `get_media_insights` |
 | "Pull action items from yesterday's call" | `get_media_insights`, `ask_magic_prompt` |
 | "Schedule the AI to join my 2pm Zoom" | `schedule_meeting_event` |
+| "Pull the live transcript from my current MS Teams meeting since last fetch" | `list_meeting_events`, `get_live_meeting_transcript` |
 | "Find a 30-second webinar highlight and export captions" | `create_clip`, `export_media` |
 | "Export the transcript as a PDF and captions as SRT" | `export_media` |
 | "Compare Q1 sales calls against Q2 sales calls and summarize changed objections" | `search_media`, `ask_magic_prompt` |
@@ -271,7 +272,7 @@ Get a Speak AI API key at [app.speakai.co/developers/apikeys](https://app.speaka
 
 The `@speakai/mcp-server` npm package provides:
 
-- A CLI (`speakai-mcp`) for scripting and pipelines (28 commands).
+- A CLI (`speakai-mcp`) for scripting and pipelines (30 commands).
 - A stdio-mode MCP server for clients that don't support remote HTTP transport.
 - An auto-setup wizard that detects installed MCP clients and configures them.
 
@@ -526,7 +527,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
 </details>
 
 <details>
-<summary>Meeting Assistant (4 tools)</summary>
+<summary>Meeting Assistant (5 tools)</summary>
 
 | Tool | Description |
 |---|---|
@@ -534,6 +535,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
 | `schedule_meeting_event` | Schedule AI assistant to join a meeting |
 | `remove_assistant_from_meeting` | Remove assistant from active meeting |
 | `delete_scheduled_assistant` | Cancel a scheduled meeting assistant |
+| `get_live_meeting_transcript` | Pull only the new sentences added to a live (or just-ended) meeting transcript since your previous call. Works on Zoom / Google Meet / MS Teams while the bot is recording. |
 
 </details>
 
@@ -636,7 +638,7 @@ Parameters: days (optional, default: 7), folder (optional)
 
 **Example:** "Use the meeting-brief prompt with days=14 to cover the last two weeks"
 
-### CLI (28 Commands)
+### CLI (30 Commands)
 
 Install globally and configure once:
 
@@ -701,7 +703,9 @@ npx @speakai/mcp-server config set-key
 |---|---|
 | `stats` | Show workspace media statistics |
 | `languages` | List supported transcription languages |
+| `list-meeting-events` | List scheduled/completed meeting events (`--platform`, `--status`, `--sort`) |
 | `schedule-meeting <url>` | Schedule AI assistant to join a meeting |
+| `live-transcript` | Fetch new sentences from an in-progress meeting (`--event-id` or `--media-id`, `--since-end-in-sec`) |
 | `create-text <name>` | Create a text note (`--text` or pipe via stdin) |
 
 #### CLI options

package/dist/index.js

@@ -1335,7 +1335,7 @@ function register(server, client) {
   registerSpeakTool(
     server,
     "get_transcript",
-    "Retrieve the full transcript for a processed media file with speaker labels and timestamps. The media must be in 'processed' state. Use update_transcript_speakers to rename speaker labels after reviewing. For subtitle-formatted output, use get_captions instead.",
+    "Retrieve the full transcript for a media file with speaker labels and timestamps. Works on processed media and also returns the partial, in-progress transcript while a meeting bot is still recording (LIVE_TRANSCRIPT state). To fetch only the new sentences added since your previous call during a live meeting, use get_live_meeting_transcript instead. Use update_transcript_speakers to rename speaker labels after reviewing. For subtitle-formatted output, use get_captions instead.",
     {
       mediaId: import_zod2.z.string().min(1).describe("Unique identifier of the media file")
     },
@@ -3185,7 +3185,7 @@ function register8(server, client) {
     "list_meeting_events",
     "List scheduled or completed meeting assistant events with filtering and pagination.",
     {
-      platformType: import_zod9.z.string().optional().describe("Filter by platform (e.g. zoom, teams, meet)"),
+      platformType: import_zod9.z.string().optional().describe("Filter by platform. Allowed values: zoom, googleMeet, microsoftTeams, webex. Comma-separate for multiple. Must match these exact strings \u2014 server validates strictly."),
       meetingStatus: import_zod9.z.string().optional().describe("Filter by status (e.g. scheduled, completed, cancelled)"),
       page: import_zod9.z.number().int().min(0).optional().describe("Page number (0-based, default: 0)"),
       pageSize: import_zod9.z.number().int().min(1).max(500).optional().describe("Results per page (default: 20, max: 500)")
@@ -3309,6 +3309,90 @@ function register8(server, client) {
       }
     }
   );
+  registerSpeakTool(
+    server,
+    "get_live_meeting_transcript",
+    "Fetch new sentences from an in-progress or just-ended meeting transcript. Identify the meeting via meetingAssistantEventId (preferred) or mediaId. Pass back the previous response's nextCursor as sinceEndInSec to receive only what's been added since.",
+    {
+      meetingAssistantEventId: import_zod9.z.string().optional().describe("Meeting assistant event id from list_meeting_events. Either this or mediaId is required."),
+      mediaId: import_zod9.z.string().optional().describe("Media id of the live meeting. Either this or meetingAssistantEventId is required."),
+      sinceEndInSec: import_zod9.z.number().min(0).optional().describe("Pass the nextCursor value from your previous response to skip already-seen sentences. Omit on the first call.")
+    },
+    {
+      title: "Get Live Meeting Transcript",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
+    async ({ meetingAssistantEventId, mediaId, sinceEndInSec }) => {
+      if (!meetingAssistantEventId && !mediaId) {
+        return {
+          content: [{ type: "text", text: "Error: provide either meetingAssistantEventId or mediaId." }],
+          isError: true
+        };
+      }
+      try {
+        let resolvedMediaId = mediaId;
+        let meetingStatus = null;
+        let meetingName;
+        if (meetingAssistantEventId) {
+          const eventsRes = await api.get("/v1/meeting-assistant/events", {
+            params: { pageSize: 50, sortBy: "startTime:desc" }
+          });
+          const events = eventsRes.data?.data?.events ?? eventsRes.data?.events ?? [];
+          const event = events.find((e) => e.meetingAssistantEventId === meetingAssistantEventId);
+          if (!event) {
+            return {
+              content: [{ type: "text", text: JSON.stringify({ status: "not_found", meetingAssistantEventId }, null, 2) }],
+              structuredContent: { data: { status: "not_found", meetingAssistantEventId } }
+            };
+          }
+          meetingStatus = event.currentStatus ?? null;
+          meetingName = event.title;
+          const mediaRef = event.mediaId;
+          const linkedMediaId = typeof mediaRef === "string" ? mediaRef : mediaRef?.mediaId;
+          if (!linkedMediaId) {
+            const payload2 = {
+              status: "not_started",
+              meetingAssistantEventId,
+              meetingStatus,
+              message: "Meeting has no linked media yet \u2014 the bot may not have joined or started recording."
+            };
+            return {
+              content: [{ type: "text", text: JSON.stringify(payload2, null, 2) }],
+              structuredContent: { data: payload2 }
+            };
+          }
+          resolvedMediaId = linkedMediaId;
+        }
+        const transcriptRes = await api.get(`/v1/media/transcript/${resolvedMediaId}`, {
+          params: Number.isFinite(sinceEndInSec) ? { sinceEndInSec } : void 0
+        });
+        const data = transcriptRes.data?.data ?? transcriptRes.data ?? {};
+        const sentences = data?.insight?.transcript ?? [];
+        const maxEnd = sentences.reduce((m, s) => Math.max(m, s.instances?.[0]?.endInSec ?? 0), 0);
+        const nextCursor = sentences.length > 0 ? maxEnd : sinceEndInSec ?? 0;
+        const payload = {
+          mediaId: resolvedMediaId,
+          name: data?.name ?? meetingName ?? null,
+          meetingStatus,
+          isLive: meetingStatus === "inCallRecording",
+          newSentences: sentences,
+          nextCursor
+        };
+        return {
+          content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+          structuredContent: { data: payload }
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Error: ${formatAxiosError(err)}` }],
+          isError: true
+        };
+      }
+    }
+  );
 }
 var import_zod9;
 var init_meeting3 = __esm({
@@ -5380,6 +5464,38 @@ function createCli() {
       process.exit(1);
     }
   });
+  program.command("list-meeting-events").description("List scheduled or completed meeting assistant events").option("-P, --platform <type>", "Filter by platform: zoom, googleMeet, microsoftTeams, webex (comma-separate for multiple)").option("-S, --status <status>", "Filter by meeting status (comma-separate for multiple)").option("-p, --page <n>", "Page number (0-based)", "0").option("-s, --page-size <n>", "Results per page", "20").option("--sort <field>", "Sort field", "startTime:desc").option("--json", "Output raw JSON").action(async (opts) => {
+    requireApiKey();
+    const client = await getClient();
+    try {
+      const params = {
+        page: parseInt(opts.page),
+        pageSize: parseInt(opts.pageSize),
+        sortBy: opts.sort
+      };
+      if (opts.platform) params.platformType = opts.platform;
+      if (opts.status) params.meetingStatus = opts.status;
+      const res = await client.get("/v1/meeting-assistant/events", { params });
+      const data = res.data?.data;
+      if (opts.json) {
+        printJson(data);
+        return;
+      }
+      const events = data?.events ?? [];
+      console.log(`Total: ${data?.totalCount ?? events.length}
+`);
+      printTable(events, [
+        { key: "meetingAssistantEventId", label: "Event ID", width: 24 },
+        { key: "title", label: "Title", width: 32 },
+        { key: "platform", label: "Platform", width: 16 },
+        { key: "currentStatus", label: "Status", width: 18 },
+        { key: "startTime", label: "Start", width: 20 }
+      ]);
+    } catch (err) {
+      printError(err.response?.data?.message ?? err.message);
+      process.exit(1);
+    }
+  });
   program.command("schedule-meeting").description("Schedule AI assistant to join a meeting").argument("<url>", "Meeting URL (Zoom, Meet, Teams)").option("-t, --title <title>", "Meeting title").option("-d, --date <datetime>", "Meeting date/time (ISO 8601, omit to join now)").option("-l, --language <lang>", "Meeting language", "en-US").option("--json", "Output raw JSON").action(async (url, opts) => {
     requireApiKey();
     const client = await getClient();
@@ -5406,6 +5522,66 @@ function createCli() {
       process.exit(1);
     }
   });
+  program.command("live-transcript").description("Fetch new sentences from an in-progress or just-ended meeting").option("-e, --event-id <id>", "Meeting assistant event id (use `speakai-mcp list-meeting-events` to find it)").option("-m, --media-id <id>", "Media id (alternative to --event-id)").option("-s, --since-end-in-sec <seconds>", "nextCursor from previous call; omit on first call", parseFloat).option("--json", "Output raw JSON").action(async (opts) => {
+    requireApiKey();
+    const client = await getClient();
+    if (!opts.eventId && !opts.mediaId) {
+      printError("Provide --event-id or --media-id");
+      process.exit(1);
+    }
+    try {
+      let resolvedMediaId = opts.mediaId;
+      let meetingStatus = null;
+      let meetingName;
+      if (opts.eventId) {
+        const eventsRes = await client.get("/v1/meeting-assistant/events", {
+          params: { pageSize: 50, sortBy: "startTime:desc" }
+        });
+        const events = eventsRes.data?.data?.events ?? eventsRes.data?.events ?? [];
+        const event = events.find((e) => e.meetingAssistantEventId === opts.eventId);
+        if (!event) {
+          printError(`Meeting event not found: ${opts.eventId}`);
+          process.exit(1);
+        }
+        meetingStatus = event.currentStatus ?? null;
+        meetingName = event.title;
+        const mediaRef = event.mediaId;
+        resolvedMediaId = typeof mediaRef === "string" ? mediaRef : mediaRef?.mediaId;
+        if (!resolvedMediaId) {
+          printError("Meeting has no linked media yet \u2014 bot has not joined or started recording.");
+          process.exit(1);
+        }
+      }
+      const transcriptRes = await client.get(`/v1/media/transcript/${resolvedMediaId}`, {
+        params: Number.isFinite(opts.sinceEndInSec) ? { sinceEndInSec: opts.sinceEndInSec } : void 0
+      });
+      const data = transcriptRes.data?.data ?? transcriptRes.data ?? {};
+      const sentences = data?.insight?.transcript ?? [];
+      const maxEnd = sentences.reduce((m, s) => Math.max(m, s.instances?.[0]?.endInSec ?? 0), 0);
+      const nextCursor = sentences.length > 0 ? maxEnd : opts.sinceEndInSec ?? 0;
+      const payload = {
+        mediaId: resolvedMediaId,
+        name: data?.name ?? meetingName ?? null,
+        meetingStatus,
+        isLive: meetingStatus === "inCallRecording",
+        newSentences: sentences,
+        nextCursor
+      };
+      if (opts.json) {
+        printJson(payload);
+      } else {
+        console.log(`Meeting: ${payload.name ?? resolvedMediaId}`);
+        console.log(`Status: ${payload.meetingStatus ?? "unknown"} (isLive=${payload.isLive})`);
+        console.log(`New sentences: ${sentences.length} \u2022 nextCursor: ${nextCursor}`);
+        for (const s of sentences) {
+          console.log(`  [${s.speakerId ?? "?"}] ${s.text ?? ""}`);
+        }
+      }
+    } catch (err) {
+      printError(err.response?.data?.message ?? err.message);
+      process.exit(1);
+    }
+  });
   return program;
 }
 var import_commander, import_readline;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speakai/mcp-server",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "mcpName": "io.github.speakai/mcp-server",
   "description": "Official Speak AI MCP Server — capture meetings, search thousands of recordings, run async voice and video surveys, create clips, and automate workflows from your AI assistant.",
   "homepage": "https://mcp.speakai.co",