@speakai/mcp-server 1.40.1 → 1.40.3
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/dist/index.js +45 -46
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -4867,7 +4867,7 @@ function register(server, client) {
|
|
|
4867
4867
|
registerSpeakTool(
|
|
4868
4868
|
server,
|
|
4869
4869
|
"upload_media",
|
|
4870
|
-
`Import an audio or video file into Speak AI from a URL and start transcription. Accepts a direct public file URL, a URL returned by get_signed_upload_url, or a page link from a supported platform, which the server resolves to the underlying media. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES}
|
|
4870
|
+
`Import an audio or video file into Speak AI from a URL and start transcription. Accepts a direct public file URL, a URL returned by get_signed_upload_url, or a page link from a supported platform, which the server resolves to the underlying media. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} Creates a media item. The request fails if the file exceeds the plan's size limit or its duration cannot be read. Returns mediaId and state right away while processing continues in the background. Use get_media_status until state is 'processed', then get_transcript and get_media_insights.`,
|
|
4871
4871
|
{
|
|
4872
4872
|
name: import_zod2.z.string().min(1).describe("Display name for the media file"),
|
|
4873
4873
|
url: import_zod2.z.string().describe("Direct public media file URL, a URL returned by get_signed_upload_url, or a page link from a platform listed in this tool's description. Page links are resolved server-side, so pass the URL the user gave you as-is."),
|
|
@@ -4887,7 +4887,7 @@ function register(server, client) {
|
|
|
4887
4887
|
{
|
|
4888
4888
|
title: "Upload Media from URL",
|
|
4889
4889
|
readOnlyHint: false,
|
|
4890
|
-
destructiveHint:
|
|
4890
|
+
destructiveHint: false,
|
|
4891
4891
|
idempotentHint: false,
|
|
4892
4892
|
openWorldHint: true
|
|
4893
4893
|
},
|
|
@@ -5138,7 +5138,7 @@ function register(server, client) {
|
|
|
5138
5138
|
registerSpeakTool(
|
|
5139
5139
|
server,
|
|
5140
5140
|
"update_media_metadata",
|
|
5141
|
-
"Update metadata fields (name, description, tags, status) for an existing media file.
|
|
5141
|
+
"Update metadata fields (name, description, tags, status) for an existing media file.",
|
|
5142
5142
|
{
|
|
5143
5143
|
mediaId: import_zod2.z.string().min(1).describe("Unique identifier of the media file"),
|
|
5144
5144
|
name: import_zod2.z.string().describe("Display name for the media (required \u2014 the server replaces the metadata)"),
|
|
@@ -5154,7 +5154,7 @@ function register(server, client) {
|
|
|
5154
5154
|
readOnlyHint: false,
|
|
5155
5155
|
destructiveHint: true,
|
|
5156
5156
|
idempotentHint: true,
|
|
5157
|
-
openWorldHint:
|
|
5157
|
+
openWorldHint: false
|
|
5158
5158
|
},
|
|
5159
5159
|
async ({ mediaId, ...body }) => {
|
|
5160
5160
|
try {
|
|
@@ -5175,7 +5175,7 @@ function register(server, client) {
|
|
|
5175
5175
|
registerSpeakTool(
|
|
5176
5176
|
server,
|
|
5177
5177
|
"delete_media",
|
|
5178
|
-
"Permanently delete a media file and all associated transcripts and insights.
|
|
5178
|
+
"Permanently delete a media file and all associated transcripts and insights.",
|
|
5179
5179
|
{
|
|
5180
5180
|
mediaId: import_zod2.z.string().min(1).describe("Unique identifier of the media file to delete")
|
|
5181
5181
|
},
|
|
@@ -5184,7 +5184,7 @@ function register(server, client) {
|
|
|
5184
5184
|
readOnlyHint: false,
|
|
5185
5185
|
destructiveHint: true,
|
|
5186
5186
|
idempotentHint: true,
|
|
5187
|
-
openWorldHint:
|
|
5187
|
+
openWorldHint: false
|
|
5188
5188
|
},
|
|
5189
5189
|
async ({ mediaId }) => {
|
|
5190
5190
|
try {
|
|
@@ -5322,7 +5322,7 @@ function register(server, client) {
|
|
|
5322
5322
|
registerSpeakTool(
|
|
5323
5323
|
server,
|
|
5324
5324
|
"reanalyze_media",
|
|
5325
|
-
"Re-run AI analysis on a media file using the latest models. Choose which parts to re-run via the flags below. Overwrites the existing results for the selected parts.
|
|
5325
|
+
"Re-run AI analysis on a media file using the latest models. Choose which parts to re-run via the flags below. Overwrites the existing results for the selected parts.",
|
|
5326
5326
|
{
|
|
5327
5327
|
mediaId: import_zod2.z.string().min(1).describe("Unique identifier of the media file to re-analyze"),
|
|
5328
5328
|
isInsights: import_zod2.z.boolean().optional().describe("Re-run insights analysis"),
|
|
@@ -5335,7 +5335,7 @@ function register(server, client) {
|
|
|
5335
5335
|
readOnlyHint: false,
|
|
5336
5336
|
destructiveHint: true,
|
|
5337
5337
|
idempotentHint: false,
|
|
5338
|
-
openWorldHint:
|
|
5338
|
+
openWorldHint: false
|
|
5339
5339
|
},
|
|
5340
5340
|
async ({ mediaId, ...params }) => {
|
|
5341
5341
|
try {
|
|
@@ -5407,7 +5407,7 @@ function register(server, client) {
|
|
|
5407
5407
|
registerSpeakTool(
|
|
5408
5408
|
server,
|
|
5409
5409
|
"bulk_move_media",
|
|
5410
|
-
"Move multiple media files to a folder in a single operation. Use this for batch reorganization instead of updating media one by one.
|
|
5410
|
+
"Move multiple media files to a folder in a single operation. Use this for batch reorganization instead of updating media one by one.",
|
|
5411
5411
|
{
|
|
5412
5412
|
folderId: import_zod2.z.string().min(1).describe("Target folder ID to move media into"),
|
|
5413
5413
|
mediaIds: import_zod2.z.array(import_zod2.z.string().min(1)).min(1).describe("Array of media IDs to move")
|
|
@@ -5417,7 +5417,7 @@ function register(server, client) {
|
|
|
5417
5417
|
readOnlyHint: false,
|
|
5418
5418
|
destructiveHint: true,
|
|
5419
5419
|
idempotentHint: false,
|
|
5420
|
-
openWorldHint:
|
|
5420
|
+
openWorldHint: false
|
|
5421
5421
|
},
|
|
5422
5422
|
async (body) => {
|
|
5423
5423
|
try {
|
|
@@ -5535,7 +5535,7 @@ function register2(server, client) {
|
|
|
5535
5535
|
registerSpeakTool(
|
|
5536
5536
|
server,
|
|
5537
5537
|
"create_text_note",
|
|
5538
|
-
"Create a new text note in Speak AI for analysis. The content will be analyzed for insights, topics, and sentiment.
|
|
5538
|
+
"Create a new text note in Speak AI for analysis. The content will be analyzed for insights, topics, and sentiment.",
|
|
5539
5539
|
{
|
|
5540
5540
|
name: import_zod3.z.string().min(1).describe("Title/name for the text note"),
|
|
5541
5541
|
text: import_zod3.z.string().optional().describe("Full text content to analyze"),
|
|
@@ -5553,9 +5553,9 @@ function register2(server, client) {
|
|
|
5553
5553
|
{
|
|
5554
5554
|
title: "Create Text Note",
|
|
5555
5555
|
readOnlyHint: false,
|
|
5556
|
-
destructiveHint:
|
|
5556
|
+
destructiveHint: false,
|
|
5557
5557
|
idempotentHint: false,
|
|
5558
|
-
openWorldHint:
|
|
5558
|
+
openWorldHint: false
|
|
5559
5559
|
},
|
|
5560
5560
|
async (body) => {
|
|
5561
5561
|
try {
|
|
@@ -5607,7 +5607,7 @@ function register2(server, client) {
|
|
|
5607
5607
|
registerSpeakTool(
|
|
5608
5608
|
server,
|
|
5609
5609
|
"reanalyze_text",
|
|
5610
|
-
"Trigger a re-analysis of an existing text note to regenerate insights with the latest AI models. Overwrites the note's current insights and sentiment.
|
|
5610
|
+
"Trigger a re-analysis of an existing text note to regenerate insights with the latest AI models. Overwrites the note's current insights and sentiment.",
|
|
5611
5611
|
{
|
|
5612
5612
|
mediaId: import_zod3.z.string().describe("Unique identifier of the text note to reanalyze")
|
|
5613
5613
|
},
|
|
@@ -5616,7 +5616,7 @@ function register2(server, client) {
|
|
|
5616
5616
|
readOnlyHint: false,
|
|
5617
5617
|
destructiveHint: true,
|
|
5618
5618
|
idempotentHint: false,
|
|
5619
|
-
openWorldHint:
|
|
5619
|
+
openWorldHint: false
|
|
5620
5620
|
},
|
|
5621
5621
|
async ({ mediaId }) => {
|
|
5622
5622
|
try {
|
|
@@ -5639,7 +5639,7 @@ function register2(server, client) {
|
|
|
5639
5639
|
registerSpeakTool(
|
|
5640
5640
|
server,
|
|
5641
5641
|
"update_text_note",
|
|
5642
|
-
"Update an existing text note's name, content, or metadata. New text replaces the existing text. A note that has not been analyzed yet is analyzed after the update; an already analyzed note is not re-analyzed, so call reanalyze_text afterwards if its insights should reflect the new text.
|
|
5642
|
+
"Update an existing text note's name, content, or metadata. New text replaces the existing text. A note that has not been analyzed yet is analyzed after the update; an already analyzed note is not re-analyzed, so call reanalyze_text afterwards if its insights should reflect the new text.",
|
|
5643
5643
|
{
|
|
5644
5644
|
mediaId: import_zod3.z.string().min(1).describe("Unique identifier of the text note"),
|
|
5645
5645
|
name: import_zod3.z.string().optional().describe("New name for the text note"),
|
|
@@ -5652,7 +5652,7 @@ function register2(server, client) {
|
|
|
5652
5652
|
readOnlyHint: false,
|
|
5653
5653
|
destructiveHint: true,
|
|
5654
5654
|
idempotentHint: true,
|
|
5655
|
-
openWorldHint:
|
|
5655
|
+
openWorldHint: false
|
|
5656
5656
|
},
|
|
5657
5657
|
async ({ mediaId, ...body }) => {
|
|
5658
5658
|
try {
|
|
@@ -5871,7 +5871,7 @@ function register4(server, client) {
|
|
|
5871
5871
|
{
|
|
5872
5872
|
title: "Create Folder View",
|
|
5873
5873
|
readOnlyHint: false,
|
|
5874
|
-
destructiveHint:
|
|
5874
|
+
destructiveHint: false,
|
|
5875
5875
|
idempotentHint: false,
|
|
5876
5876
|
openWorldHint: false
|
|
5877
5877
|
},
|
|
@@ -5953,7 +5953,7 @@ function register4(server, client) {
|
|
|
5953
5953
|
{
|
|
5954
5954
|
title: "Clone Folder View",
|
|
5955
5955
|
readOnlyHint: false,
|
|
5956
|
-
destructiveHint:
|
|
5956
|
+
destructiveHint: false,
|
|
5957
5957
|
idempotentHint: false,
|
|
5958
5958
|
openWorldHint: false
|
|
5959
5959
|
},
|
|
@@ -6228,7 +6228,7 @@ function register5(server, client) {
|
|
|
6228
6228
|
{
|
|
6229
6229
|
title: "Create Recorder",
|
|
6230
6230
|
readOnlyHint: false,
|
|
6231
|
-
destructiveHint:
|
|
6231
|
+
destructiveHint: false,
|
|
6232
6232
|
idempotentHint: false,
|
|
6233
6233
|
openWorldHint: true
|
|
6234
6234
|
},
|
|
@@ -6289,7 +6289,7 @@ function register5(server, client) {
|
|
|
6289
6289
|
{
|
|
6290
6290
|
title: "Clone Recorder",
|
|
6291
6291
|
readOnlyHint: false,
|
|
6292
|
-
destructiveHint:
|
|
6292
|
+
destructiveHint: false,
|
|
6293
6293
|
idempotentHint: false,
|
|
6294
6294
|
openWorldHint: true
|
|
6295
6295
|
},
|
|
@@ -6540,7 +6540,7 @@ function register6(server, client) {
|
|
|
6540
6540
|
{
|
|
6541
6541
|
title: "Create Embed Widget",
|
|
6542
6542
|
readOnlyHint: false,
|
|
6543
|
-
destructiveHint:
|
|
6543
|
+
destructiveHint: false,
|
|
6544
6544
|
idempotentHint: false,
|
|
6545
6545
|
openWorldHint: true
|
|
6546
6546
|
},
|
|
@@ -7151,7 +7151,7 @@ function register7(server, client, options = {}) {
|
|
|
7151
7151
|
registerSpeakTool(
|
|
7152
7152
|
server,
|
|
7153
7153
|
"submit_chat_feedback",
|
|
7154
|
-
"Submit feedback on a chat response (thumbs up/down). Replaces any earlier feedback on that message, and the score and reason are
|
|
7154
|
+
"Submit feedback on a chat response (thumbs up/down). Replaces any earlier feedback on that message, and the score and reason are shared with the Speak AI team for review.",
|
|
7155
7155
|
{
|
|
7156
7156
|
promptId: import_zod8.z.string().min(1).describe("ID of the conversation"),
|
|
7157
7157
|
messageId: import_zod8.z.string().min(1).describe("ID of the message to rate"),
|
|
@@ -7163,7 +7163,7 @@ function register7(server, client, options = {}) {
|
|
|
7163
7163
|
readOnlyHint: false,
|
|
7164
7164
|
destructiveHint: true,
|
|
7165
7165
|
idempotentHint: false,
|
|
7166
|
-
openWorldHint:
|
|
7166
|
+
openWorldHint: false
|
|
7167
7167
|
},
|
|
7168
7168
|
async (body) => {
|
|
7169
7169
|
try {
|
|
@@ -7293,7 +7293,7 @@ function register8(server, client) {
|
|
|
7293
7293
|
registerSpeakTool(
|
|
7294
7294
|
server,
|
|
7295
7295
|
"schedule_meeting_event",
|
|
7296
|
-
"Schedule the Speak AI meeting assistant to join and record an online meeting (Zoom, Google Meet, Microsoft Teams, or Webex). The assistant joins as a participant other attendees can see, at meetingDate or right away when meetingDate is omitted.
|
|
7296
|
+
"Schedule the Speak AI meeting assistant to join and record an online meeting (Zoom, Google Meet, Microsoft Teams, or Webex). The assistant joins as a participant other attendees can see, at meetingDate or right away when meetingDate is omitted.",
|
|
7297
7297
|
{
|
|
7298
7298
|
title: import_zod9.z.string().min(1).describe("Display title for the event"),
|
|
7299
7299
|
meetingURL: import_zod9.z.string().min(1).describe("URL of the meeting to join"),
|
|
@@ -7558,7 +7558,7 @@ function register9(server, client) {
|
|
|
7558
7558
|
registerSpeakTool(
|
|
7559
7559
|
server,
|
|
7560
7560
|
"update_multiple_fields",
|
|
7561
|
-
"Set custom field values across media in a single batch operation, overwriting existing values. Scope the update with `mediaIds`, or with `folderId` to update every media in that folder; when both are given only `mediaIds` is used. Empty values are skipped, so this cannot clear a field.
|
|
7561
|
+
"Set custom field values across media in a single batch operation, overwriting existing values. Scope the update with `mediaIds`, or with `folderId` to update every media in that folder; when both are given only `mediaIds` is used. Empty values are skipped, so this cannot clear a field. " + SHARED_DASHBOARD_CACHE_NOTE,
|
|
7562
7562
|
{
|
|
7563
7563
|
folderId: import_zod10.z.string().optional().describe("Apply the field values to all media in this folder"),
|
|
7564
7564
|
mediaIds: import_zod10.z.array(import_zod10.z.string()).optional().describe("Apply the field values to these specific media files"),
|
|
@@ -7574,7 +7574,7 @@ function register9(server, client) {
|
|
|
7574
7574
|
readOnlyHint: false,
|
|
7575
7575
|
destructiveHint: true,
|
|
7576
7576
|
idempotentHint: true,
|
|
7577
|
-
openWorldHint:
|
|
7577
|
+
openWorldHint: false
|
|
7578
7578
|
},
|
|
7579
7579
|
async (body) => {
|
|
7580
7580
|
try {
|
|
@@ -8961,7 +8961,7 @@ function register12(server, client) {
|
|
|
8961
8961
|
registerSpeakTool(
|
|
8962
8962
|
server,
|
|
8963
8963
|
"create_automation",
|
|
8964
|
-
"Create an automation: a trigger plus ordered steps (V2 graph model). The automation is active by default and then runs on its own every time its trigger fires. Depending on its steps, each run can send email to any address, post to the workspace's Slack, send HTTP requests to any webhook URL, fetch a file from a URL into Speak, run actions in connected third-party apps through Composio
|
|
8964
|
+
"Create an automation: a trigger plus ordered steps (V2 graph model). The automation is active by default and then runs on its own every time its trigger fires. Depending on its steps, each run can send email to any address, post to the workspace's Slack, send HTTP requests to any webhook URL, fetch a file from a URL into Speak, run actions in connected third-party apps through Composio. An inbound-webhook trigger creates a public URL that accepts payloads (returned as inboundWebhook.inboundUrl). A Composio app-event trigger subscribes to events on the connected third-party account. Valid trigger and step types come from list_automation_triggers and list_automation_actions. To map inbound-webhook payload fields, send a test payload to the URL with ?test=1, read the tokens with get_inbound_webhook, then call update_automation.",
|
|
8965
8965
|
writeSchema,
|
|
8966
8966
|
{
|
|
8967
8967
|
title: "Create Automation",
|
|
@@ -9127,7 +9127,7 @@ function register12(server, client) {
|
|
|
9127
9127
|
registerSpeakTool(
|
|
9128
9128
|
server,
|
|
9129
9129
|
"run_automations",
|
|
9130
|
-
"Manually run one or more automations against one or more media items now (outside the normal trigger). Only active automations run; inactive or unknown automation ids and unknown media ids are skipped without an error. The runs happen in the background and this returns only an acknowledgement, so check results with get_automation_runs. Every step executes for real: it can send email, post to Slack, call webhook URLs, run actions in connected third-party apps
|
|
9130
|
+
"Manually run one or more automations against one or more media items now (outside the normal trigger). Only active automations run; inactive or unknown automation ids and unknown media ids are skipped without an error. The runs happen in the background and this returns only an acknowledgement, so check results with get_automation_runs. Every step executes for real: it can send email, post to Slack, call webhook URLs, and run actions in connected third-party apps.",
|
|
9131
9131
|
{
|
|
9132
9132
|
mediaIds: import_zod14.z.array(import_zod14.z.string().min(1)).min(1).describe("Media ids to run the automations against"),
|
|
9133
9133
|
automationIds: import_zod14.z.array(import_zod14.z.string().min(1)).min(1).describe("Automation ids to run")
|
|
@@ -9247,7 +9247,7 @@ function register12(server, client) {
|
|
|
9247
9247
|
registerSpeakTool(
|
|
9248
9248
|
server,
|
|
9249
9249
|
"test_automation",
|
|
9250
|
-
"Run one automation once against one media item to see which way it branches. This is a real run, not a dry run, and it works on inactive automations too. Only the run's own status notifications are suppressed and translation steps are skipped. Notify steps still send their email or Slack message, outbound webhooks still fire, Composio actions still run against the connected third-party account
|
|
9250
|
+
"Run one automation once against one media item to see which way it branches. This is a real run, not a dry run, and it works on inactive automations too. Only the run's own status notifications are suppressed and translation steps are skipped. Notify steps still send their email or Slack message, outbound webhooks still fire, and Composio actions still run against the connected third-party account. Confirm with the user before testing an automation that sends anything outside Speak. It needs a mediaId and sends no webhook payload, so on an inbound-webhook automation the payload tokens resolve to empty. Returns a runId; read the result with get_automation_run.",
|
|
9251
9251
|
{
|
|
9252
9252
|
automationId: import_zod14.z.string().min(1).describe("Unique identifier of the automation to test"),
|
|
9253
9253
|
mediaId: import_zod14.z.string().min(1).describe("Media item to run the automation against")
|
|
@@ -9858,8 +9858,7 @@ function register15(server, client) {
|
|
|
9858
9858
|
"Create a highlight clip from one or more media files by specifying time ranges.",
|
|
9859
9859
|
`Clips are processed asynchronously (states: ${Object.values(ClipState).join(", ")}) \u2014 use get_clips to check status.`,
|
|
9860
9860
|
"Maximum total clip duration is 30 minutes.",
|
|
9861
|
-
"Use multiple timeRanges to stitch segments from different media files together."
|
|
9862
|
-
"When the clip finishes processing it fires your clip_created automations, whose steps can send email, post to Slack, call webhook URLs or run connected third-party app actions."
|
|
9861
|
+
"Use multiple timeRanges to stitch segments from different media files together."
|
|
9863
9862
|
].join(" "),
|
|
9864
9863
|
{
|
|
9865
9864
|
title: import_zod17.z.string().min(1).describe("Title for the clip"),
|
|
@@ -9878,9 +9877,9 @@ function register15(server, client) {
|
|
|
9878
9877
|
{
|
|
9879
9878
|
title: "Create Highlight Clip",
|
|
9880
9879
|
readOnlyHint: false,
|
|
9881
|
-
destructiveHint:
|
|
9880
|
+
destructiveHint: false,
|
|
9882
9881
|
idempotentHint: false,
|
|
9883
|
-
openWorldHint:
|
|
9882
|
+
openWorldHint: false
|
|
9884
9883
|
},
|
|
9885
9884
|
async (body) => {
|
|
9886
9885
|
try {
|
|
@@ -10054,7 +10053,7 @@ function register16(server, client, options = {}) {
|
|
|
10054
10053
|
registerSpeakTool(
|
|
10055
10054
|
server,
|
|
10056
10055
|
"build_automation",
|
|
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
|
|
10056
|
+
"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.",
|
|
10058
10057
|
buildAutomationSchema,
|
|
10059
10058
|
{
|
|
10060
10059
|
title: "Build Automation",
|
|
@@ -10383,7 +10382,7 @@ Likely cause: this server rejects filter rules on webhook payload fields (${data
|
|
|
10383
10382
|
registerSpeakTool(
|
|
10384
10383
|
server,
|
|
10385
10384
|
"upload_and_analyze",
|
|
10386
|
-
`Upload and transcribe media from a URL \u2014 a direct/public file URL, OR a shareable social/video page link, which Speak resolves to the underlying media automatically. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} Each accepted upload creates a media item
|
|
10385
|
+
`Upload and transcribe media from a URL \u2014 a direct/public file URL, OR a shareable social/video page link, which Speak resolves to the underlying media automatically. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} Each accepted upload creates a media item. Returns media_id immediately; after this returns, poll get_media_status until state is 'processed' (typically 1-3 min for under 60min audio), then call get_media_insights for AI summaries. This async pattern is required for remote MCP transports \u2014 long blocking calls die at proxy idle timeouts.`,
|
|
10387
10386
|
{
|
|
10388
10387
|
// A plain literal, not a template: the docs generator drops a tool's whole parameter
|
|
10389
10388
|
// table when a description interpolates a value it cannot resolve statically.
|
|
@@ -10397,7 +10396,7 @@ Likely cause: this server rejects filter rules on webhook payload fields (${data
|
|
|
10397
10396
|
{
|
|
10398
10397
|
title: "Upload and Analyze Media",
|
|
10399
10398
|
readOnlyHint: false,
|
|
10400
|
-
destructiveHint:
|
|
10399
|
+
destructiveHint: false,
|
|
10401
10400
|
idempotentHint: false,
|
|
10402
10401
|
openWorldHint: true
|
|
10403
10402
|
},
|
|
@@ -10445,7 +10444,7 @@ ${JSON.stringify(uploadRes.data, null, 2)}` }],
|
|
|
10445
10444
|
registerSpeakTool(
|
|
10446
10445
|
server,
|
|
10447
10446
|
"upload_and_analyze_batch",
|
|
10448
|
-
`Import up to ${MAX_BATCH_URLS} audio or video URLs in one call. Each URL is imported the same way as upload_and_analyze, and transcription starts for each one. At most ${MAX_BATCH_CONCURRENCY} uploads run at once. Each URL may be a direct public file URL or a page link from a supported platform, which the server resolves to the underlying media. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} Each accepted upload creates a media item
|
|
10447
|
+
`Import up to ${MAX_BATCH_URLS} audio or video URLs in one call. Each URL is imported the same way as upload_and_analyze, and transcription starts for each one. At most ${MAX_BATCH_CONCURRENCY} uploads run at once. Each URL may be a direct public file URL or a page link from a supported platform, which the server resolves to the underlying media. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} Each accepted upload creates a media item. A failed URL does not stop the others, and the result lists every URL as uploaded (with its mediaId) or failed (with the reason). Returns once the uploads are accepted. Use get_media_status per mediaId, or list_media on the folder, to follow processing.`,
|
|
10449
10448
|
{
|
|
10450
10449
|
urls: import_zod18.z.array(import_zod18.z.string().min(1)).min(1).max(MAX_BATCH_URLS).describe("The URLs to import, up to 25. Pass each one exactly as the user gave it; page links are resolved server-side. Exact duplicate URLs are sent once."),
|
|
10451
10450
|
mediaType: import_zod18.z.enum([MediaType.AUDIO, MediaType.VIDEO]).optional().describe('Applies to every URL in the batch. Send it only when the user has said which they want for all of them \u2014 "audio" if they asked for audio only, "video" if they called them videos. Otherwise omit it and the server decides per URL. Mixed batches: leave it off, or split into two calls.'),
|
|
@@ -10457,7 +10456,7 @@ ${JSON.stringify(uploadRes.data, null, 2)}` }],
|
|
|
10457
10456
|
{
|
|
10458
10457
|
title: "Upload and Analyze Several URLs",
|
|
10459
10458
|
readOnlyHint: false,
|
|
10460
|
-
destructiveHint:
|
|
10459
|
+
destructiveHint: false,
|
|
10461
10460
|
idempotentHint: false,
|
|
10462
10461
|
openWorldHint: true
|
|
10463
10462
|
},
|
|
@@ -10527,7 +10526,7 @@ ${JSON.stringify(uploadRes.data, null, 2)}` }],
|
|
|
10527
10526
|
"Upload a local file to Speak AI for transcription and analysis.",
|
|
10528
10527
|
"Reads the file from disk, gets a pre-signed S3 URL, uploads the file, then creates the media entry.",
|
|
10529
10528
|
"Works with any audio or video file on the local filesystem.",
|
|
10530
|
-
"Each upload creates a media item
|
|
10529
|
+
"Each upload creates a media item.",
|
|
10531
10530
|
"After upload, use get_media_status to poll for completion, then get_transcript and get_media_insights."
|
|
10532
10531
|
].join(" "),
|
|
10533
10532
|
{
|
|
@@ -10541,7 +10540,7 @@ ${JSON.stringify(uploadRes.data, null, 2)}` }],
|
|
|
10541
10540
|
{
|
|
10542
10541
|
title: "Upload Local File",
|
|
10543
10542
|
readOnlyHint: false,
|
|
10544
|
-
destructiveHint:
|
|
10543
|
+
destructiveHint: false,
|
|
10545
10544
|
idempotentHint: false,
|
|
10546
10545
|
openWorldHint: true
|
|
10547
10546
|
},
|
|
@@ -12087,7 +12086,7 @@ function register19(server, client, options = {}) {
|
|
|
12087
12086
|
"generate_voice_test_suite",
|
|
12088
12087
|
...options.voiceTestRuns === false ? [] : ["start_voice_test_run", "get_active_voice_test_run"]
|
|
12089
12088
|
],
|
|
12090
|
-
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
|
|
12089
|
+
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. Poll get_active_voice_test_run for progress."
|
|
12091
12090
|
},
|
|
12092
12091
|
{
|
|
12093
12092
|
area: "Feedback / self-improvement (Intelligence)",
|
|
@@ -12221,9 +12220,9 @@ function register20(server, client, options = {}) {
|
|
|
12221
12220
|
registerSpeakTool(
|
|
12222
12221
|
server,
|
|
12223
12222
|
"start_voice_test_run",
|
|
12224
|
-
"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.
|
|
12223
|
+
"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. 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, and 409 if the suite has no enabled scenarios or the agent already has a queued, running, or paused run.",
|
|
12225
12224
|
{ agentId: import_zod22.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)") },
|
|
12226
|
-
{ title: "Start Voice Agent Test Run", readOnlyHint: false, destructiveHint:
|
|
12225
|
+
{ title: "Start Voice Agent Test Run", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
|
|
12227
12226
|
async ({ agentId }) => {
|
|
12228
12227
|
try {
|
|
12229
12228
|
const result = await api.post(`/v1/voice/testing/${agentId}/run`);
|
|
@@ -12274,7 +12273,7 @@ function register20(server, client, options = {}) {
|
|
|
12274
12273
|
agentId: import_zod22.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)"),
|
|
12275
12274
|
runId: import_zod22.z.string().min(1).describe("ID of the run (from get_active_voice_test_run or list_voice_test_runs)")
|
|
12276
12275
|
},
|
|
12277
|
-
{ title: "Resume Voice Test Run", readOnlyHint: false, destructiveHint:
|
|
12276
|
+
{ title: "Resume Voice Test Run", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
|
|
12278
12277
|
async ({ agentId, runId }) => {
|
|
12279
12278
|
try {
|
|
12280
12279
|
const result = await api.post(`/v1/voice/testing/${agentId}/run/${runId}/resume`);
|
|
@@ -12287,7 +12286,7 @@ function register20(server, client, options = {}) {
|
|
|
12287
12286
|
registerSpeakTool(
|
|
12288
12287
|
server,
|
|
12289
12288
|
"cancel_voice_test_run",
|
|
12290
|
-
"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
|
|
12289
|
+
"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. Terminal \u2014 a cancelled run can never be resumed.",
|
|
12291
12290
|
{
|
|
12292
12291
|
agentId: import_zod22.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)"),
|
|
12293
12292
|
runId: import_zod22.z.string().min(1).describe("ID of the run (from get_active_voice_test_run or list_voice_test_runs)")
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@speakai/mcp-server",
|
|
3
|
-
"version": "1.40.
|
|
3
|
+
"version": "1.40.3",
|
|
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",
|