@speakai/mcp-server 1.37.0 → 1.38.0

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
@@ -464,7 +464,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
464
464
  | `get_folder_info` | Get folder details and contents |
465
465
  | `create_folder` | Create a new folder |
466
466
  | `clone_folder` | Duplicate a folder and its contents |
467
- | `update_folder` | Rename or update a folder |
467
+ | `update_folder` | Rename or update a folder, or change which users and groups can access it |
468
468
  | `delete_folder` | Delete a folder (media is preserved) |
469
469
  | `get_all_folder_views` | List all saved views across folders |
470
470
  | `get_folder_views` | List views for a specific folder |
@@ -688,18 +688,18 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
688
688
  | `get_voice_test_suite` | Get a voice agent's test suite (its scenarios and run settings) |
689
689
  | `update_voice_test_suite` | Create or update a voice agent's test suite (upserts; replaces scenarios) |
690
690
  | `generate_voice_test_suite` | Auto-generate a default test suite from the agent's name, personality and instructions |
691
- | `start_voice_test_run` | Queue a test run of a voice agent's scripted test suite (creates a queued run record; no calls are placed) |
691
+ | `start_voice_test_run` | Start a test run: sends each enabled scenario's user messages to the agent as text and grades every criterion (no calls are placed; uses credits for the AI cost) |
692
692
  | `get_active_voice_test_run` | Get a voice agent's currently active run (queued, running, or paused) |
693
- | `pause_voice_test_run` | Pause a running or queued test run |
694
- | `resume_voice_test_run` | Resume a paused test run |
695
- | `cancel_voice_test_run` | Cancel a test run; terminal, cannot be resumed |
693
+ | `pause_voice_test_run` | Pause a running or queued test run; takes effect after the current scenario |
694
+ | `resume_voice_test_run` | Resume a paused test run from the next scenario |
695
+ | `cancel_voice_test_run` | Cancel a test run at its next AI call; cost already used is charged; terminal |
696
696
  | `list_voice_test_runs` | List a voice agent's test runs, most recent first |
697
697
  | `get_voice_test_run` | Get a test run's full detail, including scenario results and recommendations |
698
698
  | `apply_voice_test_recommendation` | Apply a test run recommendation's quick action to the agent |
699
699
  | `get_voice_test_baseline` | Get a voice agent's best-scoring completed run, for regression comparison |
700
700
  | `get_voice_test_score_history` | Get completed-run score points for charting |
701
701
 
702
- The ten run tools, from `start_voice_test_run` down, register only with `voiceTestRuns: true`. The stdio server and Speak's in-app assistant include them; the hosted endpoint does not, until the engine that runs the scenarios is live.
702
+ A test run sends each enabled scenario's scripted user messages to the agent as text and grades every criterion. It uses credits for the AI cost, except when the workspace uses its own OpenAI key. The ten run tools, from `start_voice_test_run` down, register by default; pass `voiceTestRuns: false` to `registerAllTools` to leave them off.
703
703
 
704
704
  </details>
705
705
 
package/dist/index.d.ts CHANGED
@@ -4,7 +4,7 @@ import { AxiosInstance } from "axios";
4
4
  export interface RegisterOptions {
5
5
  /** Register tools that read the local disk. Only for servers on the user's own machine (stdio, CLI). */
6
6
  localFileAccess?: boolean;
7
- /** Register the voice test-run tools (start, pause, resume, cancel, results). Their execution engine is not live yet, so the hosted server leaves them off. */
7
+ /** Register the voice test-run tools (start, pause, resume, cancel, results). Defaults to true; pass false to leave them off. */
8
8
  voiceTestRuns?: boolean;
9
9
  }
10
10
 
package/dist/index.js CHANGED
@@ -5658,10 +5658,13 @@ function register4(server, client) {
5658
5658
  registerSpeakTool(
5659
5659
  server,
5660
5660
  "create_folder",
5661
- "Create a new folder in the workspace.",
5661
+ "Create a new folder in the workspace, optionally assigned to users or user groups.",
5662
5662
  {
5663
5663
  name: import_zod5.z.string().min(1).describe("Display name for the new folder"),
5664
- description: import_zod5.z.string().optional().describe("Optional folder description")
5664
+ description: import_zod5.z.string().optional().describe("Optional folder description"),
5665
+ assignTo: import_zod5.z.array(import_zod5.z.string().min(1)).optional().describe(
5666
+ 'Who can access the folder: user IDs, and user group IDs with a " (G)" suffix (e.g. "64b1... (G)"). Get IDs from list_users and list_user_groups.'
5667
+ )
5665
5668
  },
5666
5669
  {
5667
5670
  title: "Create Folder",
@@ -5723,11 +5726,14 @@ function register4(server, client) {
5723
5726
  registerSpeakTool(
5724
5727
  server,
5725
5728
  "update_folder",
5726
- "Update a folder. `name` must always be supplied (the server replaces the folder config).",
5729
+ "Update a folder. `name` must always be supplied (the server replaces the folder config). Pass `assignTo` to replace who can access it; omit it to keep the current assignment.",
5727
5730
  {
5728
5731
  folderId: import_zod5.z.string().min(1).describe("Unique identifier of the folder"),
5729
5732
  name: import_zod5.z.string().describe("Display name for the folder"),
5730
- description: import_zod5.z.string().optional().describe("Optional folder description")
5733
+ description: import_zod5.z.string().optional().describe("Optional folder description"),
5734
+ assignTo: import_zod5.z.array(import_zod5.z.string().min(1)).optional().describe(
5735
+ 'Who can access the folder: user IDs, and user group IDs with a " (G)" suffix (e.g. "64b1... (G)"). Get IDs from list_users and list_user_groups.'
5736
+ )
5731
5737
  },
5732
5738
  {
5733
5739
  title: "Update Folder",
@@ -11552,9 +11558,9 @@ function register19(server, client, options = {}) {
11552
11558
  "get_voice_test_suite",
11553
11559
  "update_voice_test_suite",
11554
11560
  "generate_voice_test_suite",
11555
- ...options.voiceTestRuns ? ["start_voice_test_run"] : []
11561
+ ...options.voiceTestRuns === false ? [] : ["start_voice_test_run", "get_active_voice_test_run"]
11556
11562
  ],
11557
- notes: options.voiceTestRuns ? "Scripted scenarios and a run history. The run lifecycle is live; the engine that drives a simulated conversation is not wired up yet, so a run stays queued." : "Scripted test scenarios for the agent. Running them is not available yet, because the engine that drives a simulated conversation is not live."
11563
+ notes: options.voiceTestRuns === false ? "Scripted test scenarios for the agent. This server does not expose the run tools." : "Scripted scenarios and a run history. A run sends each enabled scenario's user messages to the agent as text and grades every criterion; it uses credits for the AI cost. Poll get_active_voice_test_run for progress."
11558
11564
  },
11559
11565
  {
11560
11566
  area: "Feedback / self-improvement (Intelligence)",
@@ -11574,7 +11580,7 @@ function register19(server, client, options = {}) {
11574
11580
  ],
11575
11581
  commonMistakes: [
11576
11582
  "Calling create_voice_agent with a made-up voiceId instead of one from list_voices -- the create call fails validation.",
11577
- ...options.voiceTestRuns ? ["Expecting start_voice_test_run to return real scores -- the execution engine isn't wired up yet, see the Testing tools' own descriptions."] : [],
11583
+ ...options.voiceTestRuns === false ? [] : ["Reading scores from start_voice_test_run's response -- it returns the run in queued status; poll get_active_voice_test_run until it finishes, then read get_voice_test_run."],
11578
11584
  "Looking for a knowledge-base tool in this group -- collections are managed by the separate Knowledge Base tool group and only attached here."
11579
11585
  ]
11580
11586
  };
@@ -11655,9 +11661,9 @@ function register20(server, client, options = {}) {
11655
11661
  agentId: import_zod22.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)"),
11656
11662
  scenarios: import_zod22.z.array(scenarioSchema).optional(),
11657
11663
  maxCostPerRun: import_zod22.z.number().min(0).optional(),
11658
- autoRunOnKbUpdate: import_zod22.z.boolean().optional(),
11659
- autoRunOnInstructionSave: import_zod22.z.boolean().optional(),
11660
- scheduledCron: import_zod22.z.string().optional().nullable()
11664
+ autoRunOnKbUpdate: import_zod22.z.boolean().optional().describe("Run the suite automatically when the agent's knowledge base changes. Changes are grouped into one run that starts about 2 minutes after the last change, at most once an hour. Each run is charged in credits."),
11665
+ autoRunOnInstructionSave: import_zod22.z.boolean().optional().describe("Run the suite automatically when the agent's instructions, personality or chat settings change. Same grouping, hourly limit and credit charge as autoRunOnKbUpdate."),
11666
+ scheduledCron: import_zod22.z.string().optional().nullable().describe("Run the suite on a schedule: a 5-field cron expression in UTC, e.g. '0 9 * * 1-5' for 09:00 UTC on weekdays. At most once an hour. Send null or an empty string to turn the schedule off. Each run is charged in credits.")
11661
11667
  },
11662
11668
  { title: "Update Voice Test Suite", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
11663
11669
  async ({ agentId, ...body }) => {
@@ -11684,13 +11690,13 @@ function register20(server, client, options = {}) {
11684
11690
  }
11685
11691
  }
11686
11692
  );
11687
- if (!options.voiceTestRuns) return;
11693
+ if (options.voiceTestRuns === false) return;
11688
11694
  registerSpeakTool(
11689
11695
  server,
11690
11696
  "start_voice_test_run",
11691
- "Queue a test run of a voice agent's scripted test suite. Creates a run record in queued status and returns it; it does not place phone calls, start a conversation, or use credits. Requires the OWNER or ADMIN role. Returns 404 if the agent or its test suite does not exist, and 409 if the suite has no enabled scenarios or the agent already has a queued, running, or paused run." + NOT_WIRED_NOTE,
11697
+ "Start a test run of a voice agent's scripted test suite. The run sends each enabled scenario's user messages to the agent as text, in order, and grades every criterion; it does not place phone calls. It uses credits for the AI cost, except when the workspace uses its own OpenAI key. Requires the OWNER or ADMIN role. Returns the run in queued status; poll get_active_voice_test_run for progress and results. Returns 404 if the agent or its test suite does not exist, 409 if the suite has no enabled scenarios or the agent already has a queued, running, or paused run, and 402 if the workspace has no credits.",
11692
11698
  { agentId: import_zod22.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)") },
11693
- { title: "Queue Voice Agent Test Run", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
11699
+ { title: "Start Voice Agent Test Run", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
11694
11700
  async ({ agentId }) => {
11695
11701
  try {
11696
11702
  const result = await api.post(`/v1/voice/testing/${agentId}/run`);
@@ -11718,7 +11724,7 @@ function register20(server, client, options = {}) {
11718
11724
  registerSpeakTool(
11719
11725
  server,
11720
11726
  "pause_voice_test_run",
11721
- "Pause a voice agent's test run. Requires the OWNER or ADMIN role. Valid only from queued or running." + NOT_WIRED_NOTE,
11727
+ "Pause a voice agent's test run. Requires the OWNER or ADMIN role. Valid only from queued or running. Takes effect after the current scenario finishes.",
11722
11728
  {
11723
11729
  agentId: import_zod22.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)"),
11724
11730
  runId: import_zod22.z.string().min(1).describe("ID of the run (from get_active_voice_test_run or list_voice_test_runs)")
@@ -11736,7 +11742,7 @@ function register20(server, client, options = {}) {
11736
11742
  registerSpeakTool(
11737
11743
  server,
11738
11744
  "resume_voice_test_run",
11739
- "Resume a paused voice agent test run, transitioning it back to running. Requires the OWNER or ADMIN role. Valid only from paused. Only the run's status changes. The live execution engine is not wired up yet, so no scenarios execute.",
11745
+ "Resume a paused voice agent test run, transitioning it back to running. Requires the OWNER or ADMIN role. Valid only from paused. The run continues from the next scenario.",
11740
11746
  {
11741
11747
  agentId: import_zod22.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)"),
11742
11748
  runId: import_zod22.z.string().min(1).describe("ID of the run (from get_active_voice_test_run or list_voice_test_runs)")
@@ -11754,7 +11760,7 @@ function register20(server, client, options = {}) {
11754
11760
  registerSpeakTool(
11755
11761
  server,
11756
11762
  "cancel_voice_test_run",
11757
- "Cancel a voice agent test run. Requires the OWNER or ADMIN role. Valid from queued, running, or paused. Terminal \u2014 a cancelled run can never be resumed.",
11763
+ "Cancel a voice agent test run. Requires the OWNER or ADMIN role. Valid from queued, running, or paused. The run stops at its next AI call; the AI cost already used is still charged. Terminal \u2014 a cancelled run can never be resumed.",
11758
11764
  {
11759
11765
  agentId: import_zod22.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)"),
11760
11766
  runId: import_zod22.z.string().min(1).describe("ID of the run (from get_active_voice_test_run or list_voice_test_runs)")
@@ -11858,14 +11864,13 @@ function register20(server, client, options = {}) {
11858
11864
  }
11859
11865
  );
11860
11866
  }
11861
- var import_zod22, NOT_WIRED_NOTE, criterionSchema, scenarioSchema;
11867
+ var import_zod22, criterionSchema, scenarioSchema;
11862
11868
  var init_voice_testing = __esm({
11863
11869
  "src/tools/voice-testing.ts"() {
11864
11870
  "use strict";
11865
11871
  import_zod22 = require("zod");
11866
11872
  init_helpers();
11867
11873
  init_client();
11868
- NOT_WIRED_NOTE = " The live execution engine is not wired up yet: a run created here stays queued, scenarioResults stays empty, and overallScore stays 0.";
11869
11874
  criterionSchema = import_zod22.z.object({
11870
11875
  criterionId: import_zod22.z.string().optional(),
11871
11876
  name: import_zod22.z.string(),
@@ -12344,9 +12349,9 @@ function register22(server, client) {
12344
12349
  "Advisory only \u2014 compares a voice agent's current instructions against anchors/original intent/recent call summaries you supply and suggests up to 3 patches. Requires the OWNER or ADMIN role. Nothing is written; pass a suggestion's suggestedPatch to apply_voice_instruction_gap to actually apply it.",
12345
12350
  {
12346
12351
  agentId: import_zod24.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)"),
12347
- anchors: import_zod24.z.array(import_zod24.z.string()).optional().describe("Specific requirements the instructions must cover. Defaults to empty."),
12348
- originalPrompt: import_zod24.z.string().optional().describe("The original generation prompt, for context."),
12349
- conversationSummaries: import_zod24.z.array(import_zod24.z.string()).optional().describe("Recent call summaries, to ground suggestions in what actually came up. Defaults to empty.")
12352
+ anchors: import_zod24.z.array(import_zod24.z.string().trim().min(1).max(500)).max(20).optional().describe("Specific requirements the instructions must cover, at most 20 of up to 500 characters each. Defaults to empty."),
12353
+ originalPrompt: import_zod24.z.string().optional().describe("The original generation prompt, for context. Only the first 2000 characters are used."),
12354
+ conversationSummaries: import_zod24.z.array(import_zod24.z.string().trim().min(1).max(2e3)).max(20).optional().describe("Recent call summaries, to ground suggestions in what actually came up, at most 20 of up to 2000 characters each. Defaults to empty.")
12350
12355
  },
12351
12356
  { title: "Analyze Voice Instruction Gaps", readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: false },
12352
12357
  async ({ agentId, ...body }) => {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@speakai/mcp-server",
3
- "version": "1.37.0",
3
+ "version": "1.38.0",
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",