@speakai/mcp-server 1.37.1 → 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 +6 -6
- package/dist/index.d.ts +1 -1
- package/dist/index.js +23 -18
- package/package.json +1 -1
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` |
|
|
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;
|
|
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
|
-
|
|
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).
|
|
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 ? [
|
|
11561
|
+
...options.voiceTestRuns === false ? [] : ["start_voice_test_run", "get_active_voice_test_run"]
|
|
11556
11562
|
],
|
|
11557
|
-
notes: options.voiceTestRuns ? "Scripted scenarios
|
|
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 ? ["
|
|
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 (
|
|
11693
|
+
if (options.voiceTestRuns === false) return;
|
|
11688
11694
|
registerSpeakTool(
|
|
11689
11695
|
server,
|
|
11690
11696
|
"start_voice_test_run",
|
|
11691
|
-
"
|
|
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: "
|
|
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.
|
|
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.
|
|
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,
|
|
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(),
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@speakai/mcp-server",
|
|
3
|
-
"version": "1.
|
|
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",
|