Create Voice Agent

Provision a new AI voice agent with a specific provider, voice, and system prompt configuration.

frontdesk_create_voice_agent

Create a new voice agent attached to a supported telephony provider. Configure the agent's voice, behavior via a system prompt, available tools, and optional call-transfer routing.

POSTtools/frontdesk_create_voice_agent

Parameter	Type	Description
`name`required	`string`	A human-readable name for the voice agent.
`provider`required	`string`	Telephony provider: retell, vapi, or bland.
`voice_id`required	`string`	The provider-specific voice ID to use for speech synthesis.
`system_prompt`required	`string`	Instructions that define the agent's persona and behavior.
`tools`	`string[]`	Array of tool IDs the agent can invoke during a call.
`transfer_number`	`string`	Phone number to transfer calls to when escalation is needed.
`language`	`string`	Language code for the agent.Default: `en`

Exampletypescript

const result = await mcp.callTool("frontdesk_create_voice_agent", {
  name: "Front Desk Receptionist",
  provider: "retell",
  voice_id: "voice_female_professional_01",
  system_prompt: "You are a friendly medical office receptionist. Greet callers, schedule appointments, and answer basic questions about office hours and insurance.",
  tools: ["frontdesk_book_appointment", "frontdesk_check_availability"],
  transfer_number: "+15550199",
  language: "en"
});

Response

200 OK

{
  "agent": {
    "id": "va_01hxk9m3",
    "name": "Front Desk Receptionist",
    "provider": "retell",
    "voice_id": "voice_female_professional_01",
    "language": "en",
    "tools": ["frontdesk_book_appointment", "frontdesk_check_availability"],
    "transfer_number": "+15550199",
    "active": true,
    "created_at": "2025-06-10T14:30:00Z"
  }
}

Create Voice Agent

frontdesk_create_voice_agent

Search Documentation