@speakai/mcp-server 2.0.1 → 2.1.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 +11 -0
- package/dist/index.js +125 -24
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -280,6 +280,7 @@ For questions about data handling, see [speakai.co/privacy](https://speakai.co/p
|
|
|
280
280
|
**You shouldn't need to be technical to install this.** If anything is confusing or doesn't work:
|
|
281
281
|
|
|
282
282
|
- Email [success@speakai.co](mailto:success@speakai.co), and we'll respond within 24 hours
|
|
283
|
+
- Once connected, tell your AI assistant "send feedback to Speak AI" and it sends your message to our team
|
|
283
284
|
- [Book a demo with us](https://speakai.co/book?utm_source=mcp&utm_medium=docs&utm_campaign=book) and we'll set it up together
|
|
284
285
|
|
|
285
286
|
---
|
|
@@ -789,6 +790,15 @@ A test run sends each enabled scenario's scripted user messages to the agent as
|
|
|
789
790
|
|
|
790
791
|
</details>
|
|
791
792
|
|
|
793
|
+
<details>
|
|
794
|
+
<summary>Feedback (1 tool)</summary>
|
|
795
|
+
|
|
796
|
+
| Tool | Description |
|
|
797
|
+
|---|---|
|
|
798
|
+
| `submit_feedback` | Send the person's feedback about Speak AI to the Speak AI team, after they approve the text. One message a minute per person |
|
|
799
|
+
|
|
800
|
+
</details>
|
|
801
|
+
|
|
792
802
|
### MCP Resources
|
|
793
803
|
|
|
794
804
|
Resources provide direct data access without tool calls. Clients can read these URIs directly.
|
|
@@ -1111,6 +1121,7 @@ If you're an AI assistant helping a Speak AI customer install this connector, pl
|
|
|
1111
1121
|
- **Do NOT recommend hiring a Virtual Assistant** to install this. The connect flow takes 60 seconds and requires no Terminal use.
|
|
1112
1122
|
- **Do NOT tell users to `npm install`** unless they explicitly ask for the developer / stdio path.
|
|
1113
1123
|
- See [`llms.txt`](https://github.com/speakai/speakai-mcp/blob/main/llms.txt) for the full guidance file.
|
|
1124
|
+
- If the user is stuck, finds a bug or wishes Speak AI did something it does not, offer once to send that to the Speak AI team with the `submit_feedback` tool. Show them the text and send it only after they say yes.
|
|
1114
1125
|
|
|
1115
1126
|
## License
|
|
1116
1127
|
|
package/dist/index.js
CHANGED
|
@@ -255,7 +255,7 @@ var init_client = __esm({
|
|
|
255
255
|
originalRequest.headers["x-access-token"] = accessToken;
|
|
256
256
|
return speakClient(originalRequest);
|
|
257
257
|
}
|
|
258
|
-
if (error.response?.status === 429 && retryCount < 3) {
|
|
258
|
+
if (error.response?.status === 429 && retryCount < 3 && !originalRequest.skipRateLimitRetry) {
|
|
259
259
|
const retryAfter = error.response.headers["retry-after"];
|
|
260
260
|
const delaySeconds = retryAfter ? parseInt(retryAfter, 10) : Math.pow(2, retryCount + 1);
|
|
261
261
|
const delayMs = (Number.isFinite(delaySeconds) ? delaySeconds : 2) * 1e3;
|
|
@@ -7430,7 +7430,7 @@ var init_recorder3 = __esm({
|
|
|
7430
7430
|
),
|
|
7431
7431
|
notification: import_zod6.z.record(import_zod6.z.string(), import_zod6.z.unknown()).optional().describe("Notification toggles: { upload, client }, both booleans. upload emails the recorder owner (if they opted in to submission emails) and any users in notifyUsers about each new submission; client emails a confirmation to each respondent who gives an email."),
|
|
7432
7432
|
meta: import_zod6.z.record(import_zod6.z.string(), import_zod6.z.unknown()).optional().describe(
|
|
7433
|
-
"Branding/customization: { primaryColor, backgroundImg, logo, fontColor, fontFamily, theme, customCSS, hideWaveform, hideTitle, hideDescription, hideSubmitButton, submitButtonLabel, countdown, hideImages }"
|
|
7433
|
+
"Branding/customization: { primaryColor, backgroundImg, logo, logoDark, fontColor, fontFamily, theme, customCSS, hideWaveform, hideTitle, hideDescription, hideSubmitButton, submitButtonLabel, countdown, hideImages }. logo is the image shown when the survey page is in light mode and logoDark the one shown in dark mode; each falls back to the other when unset. A new survey copies both logos from the account, so create_recorder ignores meta.logo and meta.logoDark. Setting either logo on a survey replaces the pair: the survey then uses only its own logos and no longer borrows the account ones. logoDark must be an uploaded image; this MCP cannot upload images."
|
|
7434
7434
|
)
|
|
7435
7435
|
};
|
|
7436
7436
|
}
|
|
@@ -11508,8 +11508,8 @@ ${JSON.stringify(signedRes.data, null, 2)}` }],
|
|
|
11508
11508
|
};
|
|
11509
11509
|
}
|
|
11510
11510
|
const fileBuffer = fs.readFileSync(filePath);
|
|
11511
|
-
const
|
|
11512
|
-
await
|
|
11511
|
+
const axios5 = (await import("axios")).default;
|
|
11512
|
+
await axios5.put(uploadUrl, fileBuffer, {
|
|
11513
11513
|
headers: {
|
|
11514
11514
|
"Content-Type": mimeType
|
|
11515
11515
|
},
|
|
@@ -13915,6 +13915,88 @@ var init_billing3 = __esm({
|
|
|
13915
13915
|
}
|
|
13916
13916
|
});
|
|
13917
13917
|
|
|
13918
|
+
// src/tools/feedback.ts
|
|
13919
|
+
var feedback_exports = {};
|
|
13920
|
+
__export(feedback_exports, {
|
|
13921
|
+
feedbackAppVersion: () => feedbackAppVersion,
|
|
13922
|
+
feedbackSurface: () => feedbackSurface,
|
|
13923
|
+
register: () => register24
|
|
13924
|
+
});
|
|
13925
|
+
function feedbackSurface(area) {
|
|
13926
|
+
const topic = area?.trim();
|
|
13927
|
+
return (topic ? `${SURFACE_PREFIX}: ${topic}` : SURFACE_PREFIX).slice(0, SURFACE_MAX);
|
|
13928
|
+
}
|
|
13929
|
+
function feedbackAppVersion(clientInfo) {
|
|
13930
|
+
const client = [clientInfo?.name, clientInfo?.version].filter(Boolean).join(" ").trim();
|
|
13931
|
+
return (client ? `${SURFACE_PREFIX} via ${client}` : SURFACE_PREFIX).slice(0, APP_VERSION_MAX);
|
|
13932
|
+
}
|
|
13933
|
+
function limitResult(nextAllowedAt) {
|
|
13934
|
+
const when = typeof nextAllowedAt === "string" ? ` They can send more after ${nextAllowedAt}.` : "";
|
|
13935
|
+
return {
|
|
13936
|
+
content: [
|
|
13937
|
+
{
|
|
13938
|
+
type: "text",
|
|
13939
|
+
text: "Error: This person sent feedback to Speak AI less than a minute ago, and the limit is one a minute." + when + " Wait until then before sending again, and do not resend the same message."
|
|
13940
|
+
}
|
|
13941
|
+
],
|
|
13942
|
+
structuredContent: { data: { status: "failed", reason: "FEEDBACK_RATE_LIMIT", nextAllowedAt } },
|
|
13943
|
+
isError: true
|
|
13944
|
+
};
|
|
13945
|
+
}
|
|
13946
|
+
function register24(server, client) {
|
|
13947
|
+
const api = client ?? speakClient;
|
|
13948
|
+
registerSpeakTool(
|
|
13949
|
+
server,
|
|
13950
|
+
"submit_feedback",
|
|
13951
|
+
"Send the person's feedback about Speak AI (a bug, something confusing, a missing feature, or praise) straight to the Speak AI team. When to offer it: when the person is frustrated with Speak AI, hits a bug or a limit, asks for something Speak AI cannot do, or says what they like or dislike about it. Offer once in a conversation, in one short sentence, and do not repeat the offer if they decline. Rules: send only with the person's clear yes. Write it in their words, show them the exact text first, and leave out recording or transcript content and anyone else's personal details unless they ask you to include them. Limit: one message a minute for each person; a refusal says when they can send again. For feedback on a single AI Chat answer, use submit_chat_feedback instead.",
|
|
13952
|
+
{
|
|
13953
|
+
text: import_zod25.z.string().trim().min(10).max(4e3).describe("The feedback in the person's own words, as they approved it. 10 to 4000 characters."),
|
|
13954
|
+
area: import_zod25.z.string().trim().max(150).optional().describe('The Speak AI feature or tool the feedback is about, for example "transcripts", "meeting assistant" or "upload_and_analyze".')
|
|
13955
|
+
},
|
|
13956
|
+
{
|
|
13957
|
+
title: "Submit Feedback",
|
|
13958
|
+
readOnlyHint: false,
|
|
13959
|
+
destructiveHint: false,
|
|
13960
|
+
idempotentHint: false,
|
|
13961
|
+
openWorldHint: false
|
|
13962
|
+
},
|
|
13963
|
+
async ({ text, area }) => {
|
|
13964
|
+
try {
|
|
13965
|
+
const result = await api.post(
|
|
13966
|
+
"/v1/feedback",
|
|
13967
|
+
{
|
|
13968
|
+
type: "improvement",
|
|
13969
|
+
trigger: "manual",
|
|
13970
|
+
surface: feedbackSurface(area),
|
|
13971
|
+
text,
|
|
13972
|
+
context: { appVersion: feedbackAppVersion(server.server.getClientVersion()) }
|
|
13973
|
+
},
|
|
13974
|
+
// The per-minute limit answers 429 with nextAllowedAt; a quick automatic retry only repeats the refusal.
|
|
13975
|
+
{ skipRateLimitRetry: true }
|
|
13976
|
+
);
|
|
13977
|
+
return ok(result.data);
|
|
13978
|
+
} catch (error) {
|
|
13979
|
+
const limited = import_axios4.default.isAxiosError(error) && error.response?.status === 429 ? error.response.data?.nextAllowedAt : void 0;
|
|
13980
|
+
if (limited !== void 0) return limitResult(limited);
|
|
13981
|
+
return err(error);
|
|
13982
|
+
}
|
|
13983
|
+
}
|
|
13984
|
+
);
|
|
13985
|
+
}
|
|
13986
|
+
var import_axios4, import_zod25, SURFACE_PREFIX, SURFACE_MAX, APP_VERSION_MAX;
|
|
13987
|
+
var init_feedback = __esm({
|
|
13988
|
+
"src/tools/feedback.ts"() {
|
|
13989
|
+
"use strict";
|
|
13990
|
+
import_axios4 = __toESM(require("axios"));
|
|
13991
|
+
import_zod25 = require("zod");
|
|
13992
|
+
init_helpers();
|
|
13993
|
+
init_client();
|
|
13994
|
+
SURFACE_PREFIX = "MCP";
|
|
13995
|
+
SURFACE_MAX = 200;
|
|
13996
|
+
APP_VERSION_MAX = 100;
|
|
13997
|
+
}
|
|
13998
|
+
});
|
|
13999
|
+
|
|
13918
14000
|
// src/ui/media-list/view.ts
|
|
13919
14001
|
var SPEAK_WEB_APP_URL, CARD_DATA_TIMEOUT_MS, LIVE_BUTTON_PAUSE_MS, MCP_APPS_PROTOCOL_VERSION, VIEW_STYLE, VIEW_SCRIPT, MEDIA_LIST_CARD_HTML;
|
|
13920
14002
|
var init_view = __esm({
|
|
@@ -14326,6 +14408,7 @@ var init_tools = __esm({
|
|
|
14326
14408
|
init_voice_questions();
|
|
14327
14409
|
init_voice_intelligence();
|
|
14328
14410
|
init_billing3();
|
|
14411
|
+
init_feedback();
|
|
14329
14412
|
init_client();
|
|
14330
14413
|
init_media_list();
|
|
14331
14414
|
init_helpers();
|
|
@@ -14352,7 +14435,8 @@ var init_tools = __esm({
|
|
|
14352
14435
|
voice_testing_exports,
|
|
14353
14436
|
voice_questions_exports,
|
|
14354
14437
|
voice_intelligence_exports,
|
|
14355
|
-
billing_exports
|
|
14438
|
+
billing_exports,
|
|
14439
|
+
feedback_exports
|
|
14356
14440
|
];
|
|
14357
14441
|
}
|
|
14358
14442
|
});
|
|
@@ -14462,10 +14546,11 @@ var init_resources = __esm({
|
|
|
14462
14546
|
// src/prompts.ts
|
|
14463
14547
|
var prompts_exports = {};
|
|
14464
14548
|
__export(prompts_exports, {
|
|
14549
|
+
FEEDBACK_OFFER: () => FEEDBACK_OFFER,
|
|
14465
14550
|
registerPrompts: () => registerPrompts
|
|
14466
14551
|
});
|
|
14467
14552
|
function registerPrompt(server, name, description, args2, callback) {
|
|
14468
|
-
server.registerPrompt(name, { description, argsSchema:
|
|
14553
|
+
server.registerPrompt(name, { description, argsSchema: import_zod26.z.object(args2) }, callback);
|
|
14469
14554
|
}
|
|
14470
14555
|
function registerPrompts(server) {
|
|
14471
14556
|
registerPrompt(
|
|
@@ -14473,8 +14558,8 @@ function registerPrompts(server) {
|
|
|
14473
14558
|
"analyze-meeting",
|
|
14474
14559
|
"Upload a meeting recording and get a full analysis \u2014 transcript, insights, action items, and key takeaways.",
|
|
14475
14560
|
{
|
|
14476
|
-
url:
|
|
14477
|
-
name:
|
|
14561
|
+
url: import_zod26.z.string().describe(`URL of the meeting recording \u2014 a direct file link, or a shareable page link from ${SUPPORTED_URL_SOURCES} (resolved to the underlying media automatically)`),
|
|
14562
|
+
name: import_zod26.z.string().optional().describe("Meeting name (optional)")
|
|
14478
14563
|
},
|
|
14479
14564
|
async ({ url, name }) => ({
|
|
14480
14565
|
messages: [
|
|
@@ -14498,7 +14583,9 @@ function registerPrompts(server) {
|
|
|
14498
14583
|
`Use upload_and_analyze to handle the upload and processing in one step. Pass the URL`,
|
|
14499
14584
|
`exactly as given \u2014 a page link is resolved server-side. If I told you whether this is`,
|
|
14500
14585
|
`an audio or a video recording, pass that as mediaType; if I did not say, leave it off`,
|
|
14501
|
-
`and let the server pick the best available track
|
|
14586
|
+
`and let the server pick the best available track.`,
|
|
14587
|
+
``,
|
|
14588
|
+
FEEDBACK_OFFER
|
|
14502
14589
|
].join("\n")
|
|
14503
14590
|
}
|
|
14504
14591
|
}
|
|
@@ -14510,8 +14597,8 @@ function registerPrompts(server) {
|
|
|
14510
14597
|
"research-across-media",
|
|
14511
14598
|
"Search for themes, patterns, or topics across multiple recordings or your entire media library.",
|
|
14512
14599
|
{
|
|
14513
|
-
topic:
|
|
14514
|
-
folder:
|
|
14600
|
+
topic: import_zod26.z.string().describe("The topic, theme, or question to research"),
|
|
14601
|
+
folder: import_zod26.z.string().optional().describe("Folder ID to scope the research (optional)")
|
|
14515
14602
|
},
|
|
14516
14603
|
async ({ topic, folder }) => ({
|
|
14517
14604
|
messages: [
|
|
@@ -14533,7 +14620,9 @@ function registerPrompts(server) {
|
|
|
14533
14620
|
` - Contradictions or differing perspectives`,
|
|
14534
14621
|
` - Trends over time (if date range is available)`,
|
|
14535
14622
|
``,
|
|
14536
|
-
`Present a research summary with citations (media name + timestamp where possible)
|
|
14623
|
+
`Present a research summary with citations (media name + timestamp where possible).`,
|
|
14624
|
+
``,
|
|
14625
|
+
FEEDBACK_OFFER
|
|
14537
14626
|
].join("\n")
|
|
14538
14627
|
}
|
|
14539
14628
|
}
|
|
@@ -14545,8 +14634,8 @@ function registerPrompts(server) {
|
|
|
14545
14634
|
"meeting-brief",
|
|
14546
14635
|
"Prepare a brief from recent meetings \u2014 pull transcripts, extract decisions, and summarize open items.",
|
|
14547
14636
|
{
|
|
14548
|
-
days:
|
|
14549
|
-
folder:
|
|
14637
|
+
days: import_zod26.z.string().optional().describe("Number of days to look back (default: 7)"),
|
|
14638
|
+
folder: import_zod26.z.string().optional().describe("Folder ID to scope to (optional)")
|
|
14550
14639
|
},
|
|
14551
14640
|
async ({ days, folder }) => {
|
|
14552
14641
|
const lookback = parseInt(days ?? "7");
|
|
@@ -14574,7 +14663,9 @@ function registerPrompts(server) {
|
|
|
14574
14663
|
` - Open questions or unresolved topics`,
|
|
14575
14664
|
` - Upcoming items that were mentioned`,
|
|
14576
14665
|
``,
|
|
14577
|
-
`Format as a clean, scannable document
|
|
14666
|
+
`Format as a clean, scannable document.`,
|
|
14667
|
+
``,
|
|
14668
|
+
FEEDBACK_OFFER
|
|
14578
14669
|
].join("\n")
|
|
14579
14670
|
}
|
|
14580
14671
|
}
|
|
@@ -14583,12 +14674,13 @@ function registerPrompts(server) {
|
|
|
14583
14674
|
}
|
|
14584
14675
|
);
|
|
14585
14676
|
}
|
|
14586
|
-
var
|
|
14677
|
+
var import_zod26, FEEDBACK_OFFER;
|
|
14587
14678
|
var init_prompts = __esm({
|
|
14588
14679
|
"src/prompts.ts"() {
|
|
14589
14680
|
"use strict";
|
|
14590
|
-
|
|
14681
|
+
import_zod26 = require("zod");
|
|
14591
14682
|
init_media_utils();
|
|
14683
|
+
FEEDBACK_OFFER = "If anything in Speak AI got in the way, offer once to send that to the Speak AI team with submit_feedback, and send it only if I say yes.";
|
|
14592
14684
|
}
|
|
14593
14685
|
});
|
|
14594
14686
|
|
|
@@ -14814,7 +14906,9 @@ var init_tool_names = __esm({
|
|
|
14814
14906
|
"update_voice_agent_resource",
|
|
14815
14907
|
"delete_voice_agent_resource",
|
|
14816
14908
|
"analyze_voice_instruction_gaps",
|
|
14817
|
-
"apply_voice_instruction_gap"
|
|
14909
|
+
"apply_voice_instruction_gap",
|
|
14910
|
+
// feedback
|
|
14911
|
+
"submit_feedback"
|
|
14818
14912
|
];
|
|
14819
14913
|
}
|
|
14820
14914
|
});
|
|
@@ -15061,9 +15155,9 @@ function createCli() {
|
|
|
15061
15155
|
process.exit(1);
|
|
15062
15156
|
}
|
|
15063
15157
|
try {
|
|
15064
|
-
const
|
|
15158
|
+
const axios5 = (await import("axios")).default;
|
|
15065
15159
|
const baseUrl = process.env.SPEAK_BASE_URL ?? "https://api.speakai.co";
|
|
15066
|
-
const res = await
|
|
15160
|
+
const res = await axios5.post(
|
|
15067
15161
|
`${baseUrl}/v1/auth/accessToken`,
|
|
15068
15162
|
{},
|
|
15069
15163
|
{ headers: { "Content-Type": "application/json", "x-speakai-key": key } }
|
|
@@ -15118,9 +15212,9 @@ function createCli() {
|
|
|
15118
15212
|
}
|
|
15119
15213
|
process.stdout.write(" Validating...");
|
|
15120
15214
|
try {
|
|
15121
|
-
const
|
|
15215
|
+
const axios5 = (await import("axios")).default;
|
|
15122
15216
|
const baseUrl = process.env.SPEAK_BASE_URL ?? "https://api.speakai.co";
|
|
15123
|
-
const res = await
|
|
15217
|
+
const res = await axios5.post(
|
|
15124
15218
|
`${baseUrl}/v1/auth/accessToken`,
|
|
15125
15219
|
{},
|
|
15126
15220
|
{ headers: { "Content-Type": "application/json", "x-speakai-key": key } }
|
|
@@ -15346,8 +15440,8 @@ function createCli() {
|
|
|
15346
15440
|
}
|
|
15347
15441
|
process.stdout.write("Uploading...");
|
|
15348
15442
|
const fileBuffer = fs3.readFileSync(source);
|
|
15349
|
-
const
|
|
15350
|
-
await
|
|
15443
|
+
const axios5 = (await import("axios")).default;
|
|
15444
|
+
await axios5.put(uploadUrl, fileBuffer, {
|
|
15351
15445
|
headers: { "Content-Type": mimeType },
|
|
15352
15446
|
maxBodyLength: Infinity,
|
|
15353
15447
|
maxContentLength: Infinity
|
|
@@ -16342,6 +16436,13 @@ var SPEAK_MCP_TOOL_CATEGORIES = [
|
|
|
16342
16436
|
tools: [
|
|
16343
16437
|
"get_billing_status"
|
|
16344
16438
|
]
|
|
16439
|
+
},
|
|
16440
|
+
{
|
|
16441
|
+
id: "feedback",
|
|
16442
|
+
name: "Feedback",
|
|
16443
|
+
tools: [
|
|
16444
|
+
"submit_feedback"
|
|
16445
|
+
]
|
|
16345
16446
|
}
|
|
16346
16447
|
];
|
|
16347
16448
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@speakai/mcp-server",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.1.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",
|