@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 +2 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +15 -14
- package/package.json +1 -1
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:
|
|
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
|
-
"
|
|
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
|
|
6665
|
-
viewer: import_zod7.z.enum(Object.values(EmbedSessionViewerFilter)).optional().describe("identified keeps viewers who
|
|
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
|
-
"
|
|
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.
|
|
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",
|