@speakai/mcp-server 1.24.3 → 1.27.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 +89 -3
- package/dist/index.js +2549 -173
- 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>
|
|
@@ -481,7 +481,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
481
481
|
</details>
|
|
482
482
|
|
|
483
483
|
<details>
|
|
484
|
-
<summary>Automations (
|
|
484
|
+
<summary>Automations (20 tools)</summary>
|
|
485
485
|
|
|
486
486
|
| Tool | Description |
|
|
487
487
|
|---|---|
|
|
@@ -490,6 +490,11 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
490
490
|
| `list_automation_names` | List automations as lightweight name + id pairs |
|
|
491
491
|
| `get_automation` | Get automation details (trigger + step graph) |
|
|
492
492
|
| `get_automation_runs` | Get an automation's run history |
|
|
493
|
+
| `get_automation_run` | Get one run in full — every step, plus which way each branch went |
|
|
494
|
+
| `get_automation_run_stats` | Aggregate run outcome counts over a period |
|
|
495
|
+
| `test_automation` | Run an automation once against one media item (real side effects) |
|
|
496
|
+
| `describe_automation_graph` | Show a saved automation's steps as an indented branch tree |
|
|
497
|
+
| `validate_automation_graph` | Check a step graph for problems without saving it |
|
|
493
498
|
| `create_automation` | Create an automation rule (V2 trigger + steps graph) |
|
|
494
499
|
| `update_automation` | Update an automation (replaces trigger + steps) |
|
|
495
500
|
| `toggle_automation_status` | Enable or disable an automation |
|
|
@@ -638,6 +643,87 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
638
643
|
|
|
639
644
|
</details>
|
|
640
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
|
+
|
|
641
727
|
### MCP Resources (5)
|
|
642
728
|
|
|
643
729
|
Resources provide direct data access without tool calls. Clients can read these URIs directly.
|