---
title: "Voice agents tools in the Speak AI MCP"
description: "Create and configure voice agents, the questions they ask callers and their test suites, and review their conversations. All 33 Voice agents tools, with parameters and behaviour hints."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice agents tools in the Speak AI MCP

The Voice agents category groups 33 of the Speak AI MCP server's tools. Create and
configure voice agents, the questions they ask callers and their test suites, and
review their conversations.

## Which Voice agents tools does the Speak AI MCP server have?

The Speak AI MCP server has 33 Voice agents tools. Each one has its own page with a
plain-language summary, its parameters, and its behaviour hints.

- [`list_voice_agents`](/mcp/tools/voice-agents/list_voice_agents/): List the voice
  agents in the company (newest first).
- [`get_voice_agent`](/mcp/tools/voice-agents/get_voice_agent/): Fetch a single
  voice agent by its agentId.
- [`create_voice_agent`](/mcp/tools/voice-agents/create_voice_agent/): Create a
  voice agent.
- [`update_voice_agent`](/mcp/tools/voice-agents/update_voice_agent/): Update a
  voice agent.
- [`delete_voice_agent`](/mcp/tools/voice-agents/delete_voice_agent/): Delete a
  voice agent.
- [`create_voice_agent_from_prompt`](/mcp/tools/voice-agents/create_voice_agent_from_prompt/):
  Create a new voice agent from a plain-English description, via an LLM call.
- [`generate_voice_agent_config`](/mcp/tools/voice-agents/generate_voice_agent_config/):
  Run the same prompt-to-config generation as `create_voice_agent_from_prompt`, but
  against an existing agent instead of creating a new one.
- [`get_voice_agent_setup_guide`](/mcp/tools/voice-agents/get_voice_agent_setup_guide/):
  Discovery + how-to helper for building and operating a Speak AI voice agent end to
  end.
- [`list_voice_avatars`](/mcp/tools/voice-agents/list_voice_avatars/): List the
  video avatars available to attach to a voice agent (your company's own uploads
  plus the shared system catalog).
- [`list_voices`](/mcp/tools/voice-agents/list_voices/): List the text-to-speech
  voices available to a voice agent.
- [`list_voice_conversations`](/mcp/tools/voice-agents/list_voice_conversations/):
  List the company's voice conversations (newest first).
- [`get_voice_conversation`](/mcp/tools/voice-agents/get_voice_conversation/): Fetch
  a single voice conversation by its conversationId, including transcript, usage,
  costs, and analysis.
- [`list_voice_questions`](/mcp/tools/voice-agents/list_voice_questions/): List the
  questions configured on a voice agent, in the order it asks them.
- [`get_voice_question`](/mcp/tools/voice-agents/get_voice_question/): Fetch a
  single voice agent question by its fieldId, scoped to your company.
- [`create_voice_question`](/mcp/tools/voice-agents/create_voice_question/): Attach
  a question template to a voice agent.
- [`update_voice_question`](/mcp/tools/voice-agents/update_voice_question/):
  Partially update a voice agent question: only the fields you send are changed.
- [`delete_voice_question`](/mcp/tools/voice-agents/delete_voice_question/):
  Permanently remove a question from a voice agent and decrement the underlying
  template's usageCount.
- [`reorder_voice_questions`](/mcp/tools/voice-agents/reorder_voice_questions/): Set
  the order a voice agent asks its questions in.
- [`list_voice_question_templates`](/mcp/tools/voice-agents/list_voice_question_templates/):
  List the question templates visible to your company: Speak's shared system
  templates, plus your own company's templates.
- [`create_voice_question_template`](/mcp/tools/voice-agents/create_voice_question_template/):
  Create a company-scoped question template: the "custom question" a user names
  themselves rather than picking from Speak's shared library.
- [`get_voice_test_suite`](/mcp/tools/voice-agents/get_voice_test_suite/): Get a
  voice agent's test suite (its scenarios and run settings).
- [`update_voice_test_suite`](/mcp/tools/voice-agents/update_voice_test_suite/):
  Create or update a voice agent's test suite.
- [`generate_voice_test_suite`](/mcp/tools/voice-agents/generate_voice_test_suite/):
  Auto-generate a default test suite for a voice agent from its configuration (name,
  personality, instructions, welcome message, topics to avoid), via an LLM call.
- [`start_voice_test_run`](/mcp/tools/voice-agents/start_voice_test_run/): Queue a
  test run of a voice agent's scripted test suite.
- [`get_active_voice_test_run`](/mcp/tools/voice-agents/get_active_voice_test_run/):
  Get a voice agent's currently active test run (queued, running, or paused).
- [`pause_voice_test_run`](/mcp/tools/voice-agents/pause_voice_test_run/): Pause a
  voice agent's test run.
- [`resume_voice_test_run`](/mcp/tools/voice-agents/resume_voice_test_run/): Resume
  a paused voice agent test run, transitioning it back to running.
- [`cancel_voice_test_run`](/mcp/tools/voice-agents/cancel_voice_test_run/): Cancel
  a voice agent test run.
- [`list_voice_test_runs`](/mcp/tools/voice-agents/list_voice_test_runs/): List a
  voice agent's test runs, most recent first.
- [`get_voice_test_run`](/mcp/tools/voice-agents/get_voice_test_run/): Get a test
  run's full detail, including scenarioResults and recommendations.
- [`apply_voice_test_recommendation`](/mcp/tools/voice-agents/apply_voice_test_recommendation/):
  Apply a test run recommendation's quick action to the agent (e.g.
  patch_instructions appends the suggested fix to the agent's instructions).
- [`get_voice_test_baseline`](/mcp/tools/voice-agents/get_voice_test_baseline/): Get
  a voice agent's best-scoring completed test run, used to detect regressions on
  later runs.
- [`get_voice_test_score_history`](/mcp/tools/voice-agents/get_voice_test_score_history/):
  Get completed-run score points for a voice agent, most recent first, for charting.

## Related

- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool across every
  category.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/voice-agents/index.mdx
