@speakai/mcp-server 2.0.0 → 2.1.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.
Files changed (3) hide show
  1. package/README.md +67 -17
  2. package/dist/index.js +211 -30
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -39,11 +39,9 @@ The AI does the searching, summarizing, and citing. Your recordings stay in your
39
39
 
40
40
  ## Install (pick your tool)
41
41
 
42
- > **Two paths to install**: pick whichever feels easier. The one-click connect path approves access via a permission popup; the manual path pastes an API key into a header.
42
+ > **Start with the hosted connector.** Every assistant below connects to `https://api.speakai.co/v1/mcp` and signs you in through your browser on Speak AI's own page, where you can sign in or create a free account. There is no API key to copy. An API key setup is still available for local file upload, scripts and machines with no browser; see [Developer reference](#developer-reference-cli-api-advanced-setup).
43
43
 
44
- > **Don't know which one to pick?** Install it in the AI assistant you already use. Every option below connects to the same Speak AI workspace.
45
-
46
- > Speak AI's connector address (paste this into your AI tool's connector settings; it's the same idea as pasting a Zoom link into your calendar): `https://api.speakai.co/v1/mcp`
44
+ > **Don't know which one to pick?** Install it in the AI assistant you already use. Every option below connects to the same Speak AI account.
47
45
 
48
46
  ### Claude.ai (web)
49
47
 
@@ -128,32 +126,61 @@ Still stuck? Email [success@speakai.co](mailto:success@speakai.co).
128
126
 
129
127
  ### Claude Code (terminal)
130
128
 
131
- **Recommended: install from the official Claude Code plugin marketplace:**
129
+ Add the hosted connector, then sign in:
130
+
131
+ ```sh
132
+ claude mcp add --transport http speakai https://api.speakai.co/v1/mcp
133
+ claude mcp login speakai
134
+ ```
135
+
136
+ `claude mcp login` opens Speak AI's sign-in page in your browser. Sign in or create an account, then click **Allow**. You can also type `/mcp` inside Claude Code, pick **speakai** and choose to authenticate. On a machine with no browser (for example over SSH), run `claude mcp login speakai --no-browser`, open the printed link on another device, and paste the address your browser ends on back into the terminal.
137
+
138
+ Add `--scope user` to the first command to use Speak AI in every project instead of only the current one.
139
+
140
+ **Or install the plugin**, which adds the same hosted connector plus Speak AI skills:
132
141
 
133
142
  1. Add the official marketplace (one-time): `/plugin marketplace add claude-plugins-official`
134
143
  2. Install the plugin: `/plugin install speakai@claude-plugins-official`
135
144
  3. Activate it: `/reload-plugins`
136
- 4. Run the `getting-started` skill and paste your Speak AI API key. Generate one at [app.speakai.co/developers/apikeys](https://app.speakai.co/developers/apikeys).
145
+ 4. Type `/mcp`, pick **speakai** and sign in to Speak AI in your browser.
137
146
 
138
147
  If `/plugin install` doesn't find Speak AI, refresh the local catalog with `/plugin marketplace update claude-plugins-official` and retry.
139
148
 
140
149
  <details>
141
- <summary>Developer alternative: manual HTTP transport</summary>
150
+ <summary>Alternative: send an API key instead of signing in</summary>
142
151
 
143
- Skip the plugin and add the connector directly:
152
+ ```sh
153
+ claude mcp add --transport http speakai https://api.speakai.co/v1/mcp \
154
+ --header "Authorization: Bearer $SPEAKAI_KEY"
155
+ ```
156
+
157
+ Set `SPEAKAI_KEY` in your shell first. Generate a key at [app.speakai.co/developers/apikeys](https://app.speakai.co/developers/apikeys).
158
+
159
+ </details>
160
+
161
+ ### Codex (terminal)
144
162
 
145
163
  ```sh
146
- claude mcp add speakai --transport http --url https://api.speakai.co/v1/mcp
164
+ codex mcp add speakai --url https://api.speakai.co/v1/mcp
147
165
  ```
148
166
 
149
- Claude Code will open an OAuth window for sign-in. To bypass OAuth and pass a Bearer token instead:
167
+ Codex detects that Speak AI uses browser sign-in and opens Speak AI's sign-in page right away. Sign in or create an account, then click **Allow**. If the browser did not open, or you closed it before finishing, run:
150
168
 
151
169
  ```sh
152
- claude mcp add speakai --transport http --url https://api.speakai.co/v1/mcp \
153
- --header "Authorization: Bearer $SPEAKAI_KEY"
170
+ codex mcp login speakai
171
+ ```
172
+
173
+ Check the connection with `codex mcp list`; Speak AI shows **OAuth** in the Auth column.
174
+
175
+ <details>
176
+ <summary>Alternative: send an API key instead of signing in</summary>
177
+
178
+ ```sh
179
+ export SPEAKAI_KEY="your-api-key"
180
+ codex mcp add speakai --url https://api.speakai.co/v1/mcp --bearer-token-env-var SPEAKAI_KEY
154
181
  ```
155
182
 
156
- Set `SPEAKAI_KEY` in your shell first, or paste your key inline. Generate a key at [app.speakai.co/developers/apikeys](https://app.speakai.co/developers/apikeys).
183
+ Generate a key at [app.speakai.co/developers/apikeys](https://app.speakai.co/developers/apikeys).
157
184
 
158
185
  </details>
159
186
 
@@ -161,10 +188,22 @@ Set `SPEAKAI_KEY` in your shell first, or paste your key inline. Generate a key
161
188
 
162
189
  [![Add to Cursor](https://img.shields.io/badge/Cursor-Install_Speak_AI-000000?logo=cursor&logoColor=white&style=for-the-badge)](cursor://anysphere.cursor-deeplink/mcp/install?name=speakai&config=eyJ1cmwiOiJodHRwczovL2FwaS5zcGVha2FpLmNvL3YxL21jcCJ9)
163
190
 
164
- Click the button. Cursor registers itself automatically and opens the permission popup. Sign in to Speak AI and click **Allow**.
191
+ Click the button, or add this to `~/.cursor/mcp.json` (every project) or `.cursor/mcp.json` (one project):
192
+
193
+ ```json
194
+ {
195
+ "mcpServers": {
196
+ "speakai": {
197
+ "url": "https://api.speakai.co/v1/mcp"
198
+ }
199
+ }
200
+ }
201
+ ```
202
+
203
+ Then open **Cursor Settings → Tools & MCP**. Speak AI shows that it needs a login; click it to open Speak AI's sign-in page in your browser, sign in or create an account, and click **Allow**.
165
204
 
166
205
  <details>
167
- <summary>Developer alternative: manual setup with an API key</summary>
206
+ <summary>Alternative: local setup with an API key</summary>
168
207
 
169
208
  Use the manual stdio setup in the Developer reference at the bottom of this README.
170
209
 
@@ -241,6 +280,7 @@ For questions about data handling, see [speakai.co/privacy](https://speakai.co/p
241
280
  **You shouldn't need to be technical to install this.** If anything is confusing or doesn't work:
242
281
 
243
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
244
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
245
285
 
246
286
  ---
@@ -275,11 +315,11 @@ Get a Speak AI API key at [app.speakai.co/developers/apikeys](https://app.speaka
275
315
 
276
316
  ### CLI / npm package
277
317
 
278
- The `@speakai/mcp-server` npm package provides:
318
+ The `@speakai/mcp-server` npm package runs on your own machine with a Speak AI API key. Use it when you need to upload local files from your computer, run scripts and pipelines, or connect a client that can't open a browser or doesn't support remote HTTP servers. It provides:
279
319
 
280
320
  - A CLI (`speakai-mcp`) for scripting and pipelines.
281
321
  - A stdio-mode MCP server for clients that don't support remote HTTP transport.
282
- - An auto-setup wizard that detects installed MCP clients and configures them.
322
+ - A setup wizard that shows the hosted connector command for the assistants it finds (Claude Code, Codex, Cursor), then offers to set up an API key for the local server and CLI.
283
323
 
284
324
  ```sh
285
325
  npm install -g @speakai/mcp-server
@@ -750,6 +790,15 @@ A test run sends each enabled scenario's scripted user messages to the agent as
750
790
 
751
791
  </details>
752
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
+
753
802
  ### MCP Resources
754
803
 
755
804
  Resources provide direct data access without tool calls. Clients can read these URIs directly.
@@ -1072,6 +1121,7 @@ If you're an AI assistant helping a Speak AI customer install this connector, pl
1072
1121
  - **Do NOT recommend hiring a Virtual Assistant** to install this. The connect flow takes 60 seconds and requires no Terminal use.
1073
1122
  - **Do NOT tell users to `npm install`** unless they explicitly ask for the developer / stdio path.
1074
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.
1075
1125
 
1076
1126
  ## License
1077
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;
@@ -6369,10 +6369,10 @@ function register(server, client, options = {}) {
6369
6369
  if (modes.length !== 1) {
6370
6370
  return err(new Error("Send exactly one of imageUrl, imageBase64 or atSeconds."));
6371
6371
  }
6372
- const path4 = `/v1/media/${mediaId}/thumbnail`;
6372
+ const path5 = `/v1/media/${mediaId}/thumbnail`;
6373
6373
  try {
6374
6374
  if (imageUrl !== void 0) {
6375
- const result = await api.put(path4, { url: imageUrl });
6375
+ const result = await api.put(path5, { url: imageUrl });
6376
6376
  return ok(result.data);
6377
6377
  }
6378
6378
  if (imageBase64 !== void 0) {
@@ -6389,10 +6389,10 @@ function register(server, client, options = {}) {
6389
6389
  }
6390
6390
  const form = new FormData();
6391
6391
  form.append("image", new Blob([bytes], { type: mimeType }), `thumbnail.${THUMBNAIL_FILE_EXTENSIONS[mimeType]}`);
6392
- const result = await api.put(path4, form, { headers: { "Content-Type": "multipart/form-data" } });
6392
+ const result = await api.put(path5, form, { headers: { "Content-Type": "multipart/form-data" } });
6393
6393
  return ok(result.data);
6394
6394
  }
6395
- await api.put(path4, { seekSec: atSeconds });
6395
+ await api.put(path5, { seekSec: atSeconds });
6396
6396
  const deadline = Date.now() + THUMBNAIL_POLL_TIMEOUT_MS;
6397
6397
  while (Date.now() < deadline) {
6398
6398
  await new Promise((resolve) => setTimeout(resolve, THUMBNAIL_POLL_INTERVAL_MS));
@@ -11182,11 +11182,11 @@ function register16(server, client, options = {}) {
11182
11182
  }
11183
11183
  return step;
11184
11184
  };
11185
- const buildNodes = async (specs, path4) => {
11185
+ const buildNodes = async (specs, path5) => {
11186
11186
  const nodes2 = [];
11187
11187
  const folded = foldLegacyRunWhen(specs);
11188
11188
  for (const [index, spec] of folded.entries()) {
11189
- const where = `${path4}[${index}]`;
11189
+ const where = `${path5}[${index}]`;
11190
11190
  const stepId = nextStepId();
11191
11191
  const body2 = await buildStepBody(stepId, spec, where);
11192
11192
  if (String(spec.do ?? "") !== "branch") {
@@ -11508,8 +11508,8 @@ ${JSON.stringify(signedRes.data, null, 2)}` }],
11508
11508
  };
11509
11509
  }
11510
11510
  const fileBuffer = fs.readFileSync(filePath);
11511
- const axios4 = (await import("axios")).default;
11512
- await axios4.put(uploadUrl, fileBuffer, {
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: import_zod25.z.object(args2) }, callback);
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: import_zod25.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)`),
14477
- name: import_zod25.z.string().optional().describe("Meeting name (optional)")
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: import_zod25.z.string().describe("The topic, theme, or question to research"),
14514
- folder: import_zod25.z.string().optional().describe("Folder ID to scope the research (optional)")
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: import_zod25.z.string().optional().describe("Number of days to look back (default: 7)"),
14549
- folder: import_zod25.z.string().optional().describe("Folder ID to scope to (optional)")
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 import_zod25;
14677
+ var import_zod26, FEEDBACK_OFFER;
14587
14678
  var init_prompts = __esm({
14588
14679
  "src/prompts.ts"() {
14589
14680
  "use strict";
14590
- import_zod25 = require("zod");
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
  });
@@ -14923,6 +15017,73 @@ var init_format = __esm({
14923
15017
  }
14924
15018
  });
14925
15019
 
15020
+ // src/cli/hosted-setup.ts
15021
+ function onPath(command, envPath) {
15022
+ const exts = process.platform === "win32" ? [".cmd", ".exe", ""] : [""];
15023
+ return envPath.split(import_path2.default.delimiter).filter(Boolean).some((dir) => exts.some((ext) => (0, import_fs2.existsSync)(import_path2.default.join(dir, command + ext))));
15024
+ }
15025
+ function detectHostedClients(home = (0, import_os2.homedir)(), envPath = process.env.PATH ?? "") {
15026
+ const found = {
15027
+ "claude-code": onPath("claude", envPath) || (0, import_fs2.existsSync)(import_path2.default.join(home, ".claude")),
15028
+ codex: onPath("codex", envPath) || (0, import_fs2.existsSync)(import_path2.default.join(home, ".codex")),
15029
+ cursor: (0, import_fs2.existsSync)(import_path2.default.join(home, ".cursor"))
15030
+ };
15031
+ return ORDER.filter((c) => found[c]);
15032
+ }
15033
+ function hostedSetupText(detected) {
15034
+ const clients = detected.length > 0 ? detected : ORDER;
15035
+ const lines = [
15036
+ " Recommended: connect through the hosted connector.",
15037
+ " Your browser opens Speak AI's sign-in page, where you can sign in or create",
15038
+ " an account. No API key is needed.",
15039
+ ""
15040
+ ];
15041
+ if (detected.length === 0) {
15042
+ lines.push(" No AI assistant found on this machine. Pick yours:", "");
15043
+ }
15044
+ for (const c of clients) {
15045
+ lines.push(` ${HOSTED_SETUP[c].name}:`);
15046
+ for (const step of HOSTED_SETUP[c].steps) lines.push(` ${step}`);
15047
+ lines.push("");
15048
+ }
15049
+ lines.push(` Any other assistant: add ${HOSTED_MCP_URL} as a remote MCP server.`);
15050
+ return lines.join("\n");
15051
+ }
15052
+ var import_fs2, import_os2, import_path2, HOSTED_MCP_URL, HOSTED_SETUP, ORDER;
15053
+ var init_hosted_setup = __esm({
15054
+ "src/cli/hosted-setup.ts"() {
15055
+ "use strict";
15056
+ import_fs2 = require("fs");
15057
+ import_os2 = require("os");
15058
+ import_path2 = __toESM(require("path"));
15059
+ HOSTED_MCP_URL = "https://api.speakai.co/v1/mcp";
15060
+ HOSTED_SETUP = {
15061
+ "claude-code": {
15062
+ name: "Claude Code",
15063
+ steps: [
15064
+ `claude mcp add --transport http speakai ${HOSTED_MCP_URL}`,
15065
+ "claude mcp login speakai"
15066
+ ]
15067
+ },
15068
+ codex: {
15069
+ name: "Codex",
15070
+ steps: [
15071
+ `codex mcp add speakai --url ${HOSTED_MCP_URL}`,
15072
+ "codex mcp login speakai (only if the browser sign-in did not open or finish)"
15073
+ ]
15074
+ },
15075
+ cursor: {
15076
+ name: "Cursor",
15077
+ steps: [
15078
+ `Add to ~/.cursor/mcp.json: { "mcpServers": { "speakai": { "url": "${HOSTED_MCP_URL}" } } }`,
15079
+ "Open Cursor Settings > Tools & MCP and click the login prompt next to speakai"
15080
+ ]
15081
+ }
15082
+ };
15083
+ ORDER = ["claude-code", "codex", "cursor"];
15084
+ }
15085
+ });
15086
+
14926
15087
  // src/cli/index.ts
14927
15088
  var cli_exports = {};
14928
15089
  __export(cli_exports, {
@@ -14994,9 +15155,9 @@ function createCli() {
14994
15155
  process.exit(1);
14995
15156
  }
14996
15157
  try {
14997
- const axios4 = (await import("axios")).default;
15158
+ const axios5 = (await import("axios")).default;
14998
15159
  const baseUrl = process.env.SPEAK_BASE_URL ?? "https://api.speakai.co";
14999
- const res = await axios4.post(
15160
+ const res = await axios5.post(
15000
15161
  `${baseUrl}/v1/auth/accessToken`,
15001
15162
  {},
15002
15163
  { headers: { "Content-Type": "application/json", "x-speakai-key": key } }
@@ -15018,10 +15179,22 @@ function createCli() {
15018
15179
  saveConfig(cfg);
15019
15180
  printSuccess(`Base URL set to ${url}`);
15020
15181
  });
15021
- program.command("init").description("Interactive setup \u2014 configure API key and auto-detect MCP clients").action(async () => {
15182
+ program.command("init").description(
15183
+ "Interactive setup \u2014 shows the hosted connector command for your AI assistant, then offers API key setup"
15184
+ ).action(async () => {
15022
15185
  const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
15023
15186
  const ask = (q) => new Promise((resolve) => rl.question(q, (a) => resolve(a.trim())));
15024
15187
  console.log("\n Speak AI MCP Server \u2014 Setup\n");
15188
+ console.log(hostedSetupText(detectHostedClients()));
15189
+ console.log(
15190
+ "\n An API key is only needed for the local server and the speakai-mcp CLI:\n uploading files from this computer, scripts, or a machine with no browser.\n"
15191
+ );
15192
+ const wantsKey = await ask(" Set up an API key as well? (y/N) ");
15193
+ if (wantsKey.toLowerCase() !== "y") {
15194
+ rl.close();
15195
+ printSuccess("Run the command above for your assistant to connect.");
15196
+ return;
15197
+ }
15025
15198
  const existingKey = resolveApiKey();
15026
15199
  let key = existingKey;
15027
15200
  if (existingKey) {
@@ -15039,9 +15212,9 @@ function createCli() {
15039
15212
  }
15040
15213
  process.stdout.write(" Validating...");
15041
15214
  try {
15042
- const axios4 = (await import("axios")).default;
15215
+ const axios5 = (await import("axios")).default;
15043
15216
  const baseUrl = process.env.SPEAK_BASE_URL ?? "https://api.speakai.co";
15044
- const res = await axios4.post(
15217
+ const res = await axios5.post(
15045
15218
  `${baseUrl}/v1/auth/accessToken`,
15046
15219
  {},
15047
15220
  { headers: { "Content-Type": "application/json", "x-speakai-key": key } }
@@ -15267,8 +15440,8 @@ function createCli() {
15267
15440
  }
15268
15441
  process.stdout.write("Uploading...");
15269
15442
  const fileBuffer = fs3.readFileSync(source);
15270
- const axios4 = (await import("axios")).default;
15271
- await axios4.put(uploadUrl, fileBuffer, {
15443
+ const axios5 = (await import("axios")).default;
15444
+ await axios5.put(uploadUrl, fileBuffer, {
15272
15445
  headers: { "Content-Type": mimeType },
15273
15446
  maxBodyLength: Infinity,
15274
15447
  maxContentLength: Infinity
@@ -15934,6 +16107,7 @@ var init_cli = __esm({
15934
16107
  import_readline = require("readline");
15935
16108
  init_config();
15936
16109
  init_format();
16110
+ init_hosted_setup();
15937
16111
  init_media_utils();
15938
16112
  init_media3();
15939
16113
  }
@@ -16262,6 +16436,13 @@ var SPEAK_MCP_TOOL_CATEGORIES = [
16262
16436
  tools: [
16263
16437
  "get_billing_status"
16264
16438
  ]
16439
+ },
16440
+ {
16441
+ id: "feedback",
16442
+ name: "Feedback",
16443
+ tools: [
16444
+ "submit_feedback"
16445
+ ]
16265
16446
  }
16266
16447
  ];
16267
16448
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@speakai/mcp-server",
3
- "version": "2.0.0",
3
+ "version": "2.1.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",