@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 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 119 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:
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 (119)
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 declare function registerAllTools(server: McpServer, client?: AxiosInstance): void;
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;