@speakai/mcp-server 1.40.3 → 1.41.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -458,6 +458,8 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
458
458
 
459
459
  `ask_ai_chat`, `retry_ai_chat` and `get_analysis_quote` register only with `aiChat: true`. The stdio server includes them; the hosted endpoint does not, because Speak's assistant behind AI Chat can call other tools.
460
460
 
461
+ The automation tools, `build_automation`, `provision_inbound_webhook`, `get_inbound_webhook` and `get_webhook_attempts` register only with `automations: true`, and `get_voice_test_run` and `apply_voice_test_recommendation` only with `voiceTestRunDetails: true`. The stdio server includes them; the hosted endpoint does not, because automation steps can run actions in connected third-party apps. On the hosted endpoint, set up automations in the Speak AI web app.
462
+
461
463
  </details>
462
464
 
463
465
  <details>
package/dist/index.d.ts CHANGED
@@ -8,6 +8,10 @@ export interface RegisterOptions {
8
8
  voiceTestRuns?: boolean;
9
9
  /** Register ask_ai_chat, retry_ai_chat and get_analysis_quote. Speak's assistant behind them can call other tools, so the hosted server leaves this off. */
10
10
  aiChat?: boolean;
11
+ /** Register the automation tools, build_automation and the inbound-webhook tools. Automation steps can run actions in connected third-party apps, so the hosted server leaves this off. */
12
+ automations?: boolean;
13
+ /** Register get_voice_test_run and apply_voice_test_recommendation. The hosted server leaves this off. */
14
+ voiceTestRunDetails?: boolean;
11
15
  }
12
16
 
13
17
  export declare function registerAllTools(
package/dist/index.js CHANGED
@@ -5555,7 +5555,7 @@ function register2(server, client) {
5555
5555
  readOnlyHint: false,
5556
5556
  destructiveHint: false,
5557
5557
  idempotentHint: false,
5558
- openWorldHint: false
5558
+ openWorldHint: true
5559
5559
  },
5560
5560
  async (body) => {
5561
5561
  try {
@@ -6655,14 +6655,14 @@ function register6(server, client) {
6655
6655
  registerSpeakTool(
6656
6656
  server,
6657
6657
  "list_embed_sessions",
6658
- "Owner analytics for an embed: list the visits (sessions) to one embed, newest first by default. Each session has its start and last activity time, whether it is still live, total and active time, media opened, time watched, questions asked, the viewer's email and name when they identified themselves, their country, browser, device and referrer, campaign tags, and whether it was a bot. Returns sessions with totalCount, page and pageSize. Use get_embed_session with a session's _id for its full timeline.",
6658
+ "Viewing analytics for an embed the user owns: list the visits (sessions) to one embed, newest first by default. Each visit shows when it started and was last active, whether it is still live, total and active time, media opened, time watched, questions asked, traffic source and campaign tags, whether it was a bot, and the viewer's identity if they chose to share it. Returns sessions with totalCount, page and pageSize. Use get_embed_session with a session's _id for its full timeline.",
6659
6659
  {
6660
6660
  embedId: embedIdSchema,
6661
6661
  ...embedSessionRangeSchema,
6662
6662
  page: import_zod7.z.number().int().min(0).optional().describe("0-based page index (default 0)"),
6663
6663
  pageSize: import_zod7.z.number().int().min(1).max(EMBED_SESSION_LIMITS.maxListPageSize).optional().describe(`Sessions per page (default ${EMBED_SESSION_LIMITS.listPageSize}, max ${EMBED_SESSION_LIMITS.maxListPageSize})`),
6664
- search: import_zod7.z.string().max(EMBED_SESSION_LIMITS.maxSearchLength).optional().describe("Match a viewer email (any part) or the start of a visitorId"),
6665
- viewer: import_zod7.z.enum(Object.values(EmbedSessionViewerFilter)).optional().describe("identified keeps viewers who gave their email, anonymous keeps the rest (default all)"),
6664
+ search: import_zod7.z.string().max(EMBED_SESSION_LIMITS.maxSearchLength).optional().describe("Match what a viewer shared about themselves (any part) or the start of a visitorId"),
6665
+ viewer: import_zod7.z.enum(Object.values(EmbedSessionViewerFilter)).optional().describe("identified keeps viewers who chose to identify themselves, anonymous keeps the rest (default all)"),
6666
6666
  device: import_zod7.z.enum(Object.values(EmbedSessionDeviceFilter)).optional().describe("Filter by device type (default all)"),
6667
6667
  country: import_zod7.z.string().optional().describe("Exact country name as shown in a session's client.country"),
6668
6668
  includeLegacy: import_zod7.z.boolean().optional().describe("Also include visits recorded before session tracking started (default false)"),
@@ -6727,7 +6727,7 @@ function register6(server, client) {
6727
6727
  registerSpeakTool(
6728
6728
  server,
6729
6729
  "get_embed_session",
6730
- "Owner analytics for an embed: one visit in full. Returns the session with the media it opened (time watched, plays, seeks, furthest position, completed), the questions asked in chat, and a paged list of its events in time order, plus how many sessions the same viewer or browser has had on this embed. Use eventsPage and eventsPageSize to read long timelines.",
6730
+ "Viewing analytics for an embed the user owns: one visit in full. Returns the visit with the media it opened (time watched, plays, seeks, furthest position, completed), the questions asked in chat, and a paged list of its events in time order, plus how many earlier visits the same viewer has made to this embed. Use eventsPage and eventsPageSize to read long timelines.",
6731
6731
  {
6732
6732
  embedId: embedIdSchema,
6733
6733
  id: objectIdSchema.describe("The session's _id (24 hex characters) from list_embed_sessions, not its sessionId"),
@@ -8837,7 +8837,8 @@ async function withInboundWebhookInfo(api, responseData, automationId) {
8837
8837
  return responseData;
8838
8838
  }
8839
8839
  }
8840
- function register12(server, client) {
8840
+ function register12(server, client, options = {}) {
8841
+ if (!options.automations) return;
8841
8842
  const api = client ?? speakClient;
8842
8843
  registerSpeakTool(
8843
8844
  server,
@@ -9524,7 +9525,7 @@ var webhooks_exports = {};
9524
9525
  __export(webhooks_exports, {
9525
9526
  register: () => register13
9526
9527
  });
9527
- function register13(server, client) {
9528
+ function register13(server, client, options = {}) {
9528
9529
  const api = client ?? speakClient;
9529
9530
  registerSpeakTool(
9530
9531
  server,
@@ -9613,7 +9614,7 @@ function register13(server, client) {
9613
9614
  }
9614
9615
  }
9615
9616
  );
9616
- registerSpeakTool(
9617
+ if (options.automations) registerSpeakTool(
9617
9618
  server,
9618
9619
  "provision_inbound_webhook",
9619
9620
  "Provision a standalone inbound webhook and get its public receive URL (inboundUrl) BEFORE creating an automation. Webhook-first flow: provision, send a test payload to the URL (append ?test=1 to only capture a sample without running anything), inspect mappable payload paths with get_inbound_webhook, then pass the webhookId as trigger.webhookId to create_automation.",
@@ -9649,7 +9650,7 @@ function register13(server, client) {
9649
9650
  }
9650
9651
  }
9651
9652
  );
9652
- registerSpeakTool(
9653
+ if (options.automations) registerSpeakTool(
9653
9654
  server,
9654
9655
  "get_inbound_webhook",
9655
9656
  "Get an inbound webhook's public receive URL, captured sample payload, and the ready-to-paste {{trigger.payload.*}} tokens for mapping payload values into automation steps (speak-upload name/sourceUrl, fieldsMap custom-field values, notify/outbound-webhook templates). Pass either the webhookId or the automationId of an inbound-webhook automation. If no sample has been captured yet, send a test payload to the inboundUrl first (append ?test=1 to capture without running the automation).",
@@ -9703,7 +9704,7 @@ function register13(server, client) {
9703
9704
  }
9704
9705
  }
9705
9706
  );
9706
- registerSpeakTool(
9707
+ if (options.automations) registerSpeakTool(
9707
9708
  server,
9708
9709
  "get_webhook_attempts",
9709
9710
  "Get the delivery log for an inbound webhook: each received request with its HTTP acknowledgement status (200 = sample captured, 202 = accepted and run started, 401/403 = rejected) and the automation run it started. Use get_automation_runs for the run outcomes themselves.",
@@ -10050,7 +10051,7 @@ function resolveField(ref, fields) {
10050
10051
  }
10051
10052
  function register16(server, client, options = {}) {
10052
10053
  const api = client ?? speakClient;
10053
- registerSpeakTool(
10054
+ if (options.automations) registerSpeakTool(
10054
10055
  server,
10055
10056
  "build_automation",
10056
10057
  "High-level automation builder: create (or update) a Speak automation from a friendly spec without knowing the wire format. Accepts folder/custom-field NAMES (resolved to ids; missing folders are auto-created), payload.<path> shorthand for webhook tokens, and simple step types (filter, branch, upload, ai_chat, translate, notify, call_webhook). For inbound-webhook automations the result includes the receive URL and mappable payload tokens. create_automation takes the raw wire format instead. Passing automationId replaces that whole automation. The automation is active by default and then runs on its own every time its trigger fires: upload steps fetch a file from any URL, slack notify steps post to the workspace's Slack, and call_webhook steps send HTTP requests to any URL. An inbound_webhook trigger creates a public URL that accepts payloads.",
@@ -12319,7 +12320,7 @@ function register20(server, client, options = {}) {
12319
12320
  }
12320
12321
  }
12321
12322
  );
12322
- registerSpeakTool(
12323
+ if (options.voiceTestRunDetails) registerSpeakTool(
12323
12324
  server,
12324
12325
  "get_voice_test_run",
12325
12326
  "Get a test run's full detail, including scenarioResults and recommendations. Scoped to your company; agentId is not used to filter this lookup, only runId.",
@@ -12337,7 +12338,7 @@ function register20(server, client, options = {}) {
12337
12338
  }
12338
12339
  }
12339
12340
  );
12340
- registerSpeakTool(
12341
+ if (options.voiceTestRunDetails) registerSpeakTool(
12341
12342
  server,
12342
12343
  "apply_voice_test_recommendation",
12343
12344
  "Apply a test run recommendation's quick action to the agent (e.g. patch_instructions appends the suggested fix to the agent's instructions). Requires the OWNER or ADMIN role.",
@@ -14947,7 +14948,7 @@ if (isCliMode) {
14947
14948
  name: "speak-ai",
14948
14949
  version: "1.0.0"
14949
14950
  });
14950
- registerAllTools2(server, void 0, { localFileAccess: true, voiceTestRuns: true, aiChat: true });
14951
+ registerAllTools2(server, void 0, { localFileAccess: true, voiceTestRuns: true, aiChat: true, automations: true, voiceTestRunDetails: true });
14951
14952
  registerResources2(server);
14952
14953
  registerPrompts2(server);
14953
14954
  const transport = new StdioServerTransport();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@speakai/mcp-server",
3
- "version": "1.40.3",
3
+ "version": "1.41.1",
4
4
  "mcpName": "io.github.speakai/mcp-server",
5
5
  "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.",
6
6
  "homepage": "https://docs.speakai.co/mcp",