@speakai/mcp-server 1.26.0 → 1.28.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 +84 -3
- package/dist/index.d.ts +10 -1
- package/dist/index.js +1373 -158
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -242,7 +242,7 @@ For questions about data handling, see [speakai.co/privacy](https://speakai.co/p
|
|
|
242
242
|
|
|
243
243
|
## What you can do once installed
|
|
244
244
|
|
|
245
|
-
Speak AI ships
|
|
245
|
+
Speak AI ships 168 tools your AI assistant can call. You don't memorize them — Claude/ChatGPT pick the right ones based on what you ask. Examples by category:
|
|
246
246
|
|
|
247
247
|
| Ask | Tools used (auto) |
|
|
248
248
|
|---|---|
|
|
@@ -394,7 +394,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
394
394
|
| `SPEAK_ACCESS_TOKEN` | No | Auto-managed | JWT access token (auto-fetched and refreshed) |
|
|
395
395
|
| `SPEAK_BASE_URL` | No | `https://api.speakai.co` | API base URL |
|
|
396
396
|
|
|
397
|
-
### MCP Tools (
|
|
397
|
+
### MCP Tools (168)
|
|
398
398
|
|
|
399
399
|
<details>
|
|
400
400
|
<summary>Media (18 tools)</summary>
|
|
@@ -403,7 +403,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
403
403
|
|---|---|
|
|
404
404
|
| `get_signed_upload_url` | Get a pre-signed S3 URL for direct file upload |
|
|
405
405
|
| `upload_media` | Upload media from a URL — a direct/public file URL, a pre-signed S3 URL, or a social/video page link resolved automatically (YouTube, TikTok, Instagram, X/Twitter, Facebook, Reddit, SoundCloud, Twitch, Dailymotion, Streamable, Snapchat, Pinterest, Tumblr, Bilibili, VK, OK.ru, Rutube). Vimeo and Loom page links are not supported. |
|
|
406
|
-
| `upload_local_file` | Upload a local file directly from disk |
|
|
406
|
+
| `upload_local_file` | Upload a local file directly from disk (stdio and CLI only, never on the remote server) |
|
|
407
407
|
| `upload_and_analyze` | Upload media from a URL (direct file, or any social/video page link `upload_media` accepts — resolved automatically) and return its `media_id` immediately. Poll `get_media_status` until `processed`, then call `get_media_insights` for AI summaries. Set `mediaType` when the user has said which they want; leave it off otherwise and the server picks the best available track. |
|
|
408
408
|
| `upload_and_analyze_batch` | Upload up to 25 URLs in one call, 5 at a time. Each URL is reported as uploaded or failed with its reason, so one bad link does not sink the batch. Use this instead of calling `upload_and_analyze` in a loop. |
|
|
409
409
|
| `list_media` | List and search media files with filters, pagination, and optional inline data (transcripts, speakers, keywords) via `include` param |
|
|
@@ -643,6 +643,87 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
643
643
|
|
|
644
644
|
</details>
|
|
645
645
|
|
|
646
|
+
<details>
|
|
647
|
+
<summary>Voice agents (12 tools)</summary>
|
|
648
|
+
|
|
649
|
+
| Tool | Description |
|
|
650
|
+
|---|---|
|
|
651
|
+
| `list_voice_agents` | List the company's voice agents (newest first) with their config |
|
|
652
|
+
| `get_voice_agent` | Get a single voice agent by agentId |
|
|
653
|
+
| `create_voice_agent` | Create a voice agent (name, personality, instructions, and voice are required) |
|
|
654
|
+
| `update_voice_agent` | Update a voice agent; send only the fields you want to change |
|
|
655
|
+
| `delete_voice_agent` | Permanently delete a voice agent and its questions, test suite, and share link |
|
|
656
|
+
| `create_voice_agent_from_prompt` | Create a new agent from a plain-English description instead of filling in fields |
|
|
657
|
+
| `generate_voice_agent_config` | Run the same prompt-to-config generation against an existing agent |
|
|
658
|
+
| `get_voice_agent_setup_guide` | Discovery helper: the build order, which tool covers each piece, common mistakes |
|
|
659
|
+
| `list_voice_avatars` | List the video avatars available to attach to a voice agent |
|
|
660
|
+
| `list_voices` | List the text-to-speech voices available to a voice agent |
|
|
661
|
+
| `list_voice_conversations` | List conversations handled by voice agents (filter by agentId) |
|
|
662
|
+
| `get_voice_conversation` | Get a single conversation by conversationId |
|
|
663
|
+
|
|
664
|
+
</details>
|
|
665
|
+
|
|
666
|
+
<details>
|
|
667
|
+
<summary>Voice agent questions (8 tools)</summary>
|
|
668
|
+
|
|
669
|
+
| Tool | Description |
|
|
670
|
+
|---|---|
|
|
671
|
+
| `list_voice_questions` | List the questions configured on a voice agent, in ask order |
|
|
672
|
+
| `get_voice_question` | Get a single question by fieldId |
|
|
673
|
+
| `create_voice_question` | Attach a question template to a voice agent |
|
|
674
|
+
| `update_voice_question` | Partially update a voice agent question |
|
|
675
|
+
| `delete_voice_question` | Remove a question from a voice agent |
|
|
676
|
+
| `reorder_voice_questions` | Set the order a voice agent asks its questions in |
|
|
677
|
+
| `list_voice_question_templates` | List the shared and company-owned question template library |
|
|
678
|
+
| `create_voice_question_template` | Create a company-scoped custom question template |
|
|
679
|
+
|
|
680
|
+
</details>
|
|
681
|
+
|
|
682
|
+
<details>
|
|
683
|
+
<summary>Voice agent intelligence (16 tools)</summary>
|
|
684
|
+
|
|
685
|
+
| Tool | Description |
|
|
686
|
+
|---|---|
|
|
687
|
+
| `list_voice_kb_gaps` | List a voice agent's pending knowledge-base gaps from real calls |
|
|
688
|
+
| `analyze_voice_kb_gaps` | Trigger knowledge-base gap analysis over an agent's recent calls |
|
|
689
|
+
| `add_voice_kb_gap` | Write a gap's answer into the agent's knowledge base |
|
|
690
|
+
| `dismiss_voice_kb_gap` | Dismiss a gap without writing anything |
|
|
691
|
+
| `list_voice_faq_suggestions` | List a voice agent's pending FAQ suggestions clustered from real calls |
|
|
692
|
+
| `generate_voice_faq_suggestions` | Trigger FAQ clustering over an agent's recent calls |
|
|
693
|
+
| `add_voice_faq_suggestion` | Write an FAQ suggestion into the agent's knowledge base |
|
|
694
|
+
| `update_voice_faq_suggestion` | Edit a pending FAQ suggestion's question and/or answer |
|
|
695
|
+
| `dismiss_voice_faq_suggestion` | Dismiss an FAQ suggestion without writing anything |
|
|
696
|
+
| `list_voice_agent_resources` | List the documents/links a voice agent searches during calls |
|
|
697
|
+
| `create_voice_agent_resource` | Add one document/link to a voice agent's knowledge base |
|
|
698
|
+
| `bulk_create_voice_agent_resources` | Add up to 100 documents/links in one call |
|
|
699
|
+
| `update_voice_agent_resource` | Partially update a voice agent resource |
|
|
700
|
+
| `delete_voice_agent_resource` | Soft-delete a voice agent resource |
|
|
701
|
+
| `analyze_voice_instruction_gaps` | Advisory-only patch suggestions for an agent's own instructions |
|
|
702
|
+
| `apply_voice_instruction_gap` | Insert a suggested patch into an agent's instructions |
|
|
703
|
+
|
|
704
|
+
</details>
|
|
705
|
+
|
|
706
|
+
<details>
|
|
707
|
+
<summary>Voice agent testing (13 tools)</summary>
|
|
708
|
+
|
|
709
|
+
| Tool | Description |
|
|
710
|
+
|---|---|
|
|
711
|
+
| `get_voice_test_suite` | Get a voice agent's test suite (its scenarios and run settings) |
|
|
712
|
+
| `update_voice_test_suite` | Create or update a voice agent's test suite (upserts; replaces scenarios) |
|
|
713
|
+
| `generate_voice_test_suite` | Auto-generate a default test suite from the agent's instructions and knowledge base |
|
|
714
|
+
| `start_voice_test_run` | Start a test run against a voice agent's suite |
|
|
715
|
+
| `get_active_voice_test_run` | Get a voice agent's currently active run (queued, running, or paused) |
|
|
716
|
+
| `pause_voice_test_run` | Pause a running or queued test run |
|
|
717
|
+
| `resume_voice_test_run` | Resume a paused test run |
|
|
718
|
+
| `cancel_voice_test_run` | Cancel a test run; terminal, cannot be resumed |
|
|
719
|
+
| `list_voice_test_runs` | List a voice agent's test runs, most recent first |
|
|
720
|
+
| `get_voice_test_run` | Get a test run's full detail, including scenario results and recommendations |
|
|
721
|
+
| `apply_voice_test_recommendation` | Apply a test run recommendation's quick action to the agent |
|
|
722
|
+
| `get_voice_test_baseline` | Get a voice agent's best-scoring completed run, for regression comparison |
|
|
723
|
+
| `get_voice_test_score_history` | Get completed-run score points for charting |
|
|
724
|
+
|
|
725
|
+
</details>
|
|
726
|
+
|
|
646
727
|
### MCP Resources (5)
|
|
647
728
|
|
|
648
729
|
Resources provide direct data access without tool calls. Clients can read these URIs directly.
|
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,16 @@
|
|
|
1
1
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
2
|
import { AxiosInstance } from "axios";
|
|
3
3
|
|
|
4
|
-
export
|
|
4
|
+
export interface RegisterOptions {
|
|
5
|
+
/** Register tools that read the local disk. Only for servers on the user's own machine (stdio, CLI). */
|
|
6
|
+
localFileAccess?: boolean;
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
export declare function registerAllTools(
|
|
10
|
+
server: McpServer,
|
|
11
|
+
client?: AxiosInstance,
|
|
12
|
+
options?: RegisterOptions
|
|
13
|
+
): void;
|
|
5
14
|
|
|
6
15
|
export declare function createSpeakClient(options: {
|
|
7
16
|
baseUrl: string;
|