Skip to main content
Glama

create_byo_voice

Create and save a reusable voice clone in the caller's workspace.

    Set clip_reference=true to clone original speech from audio/video with
    ElevenLabs. Optional clip_ranges selects speech-only {start_ms,end_ms}
    ranges, useful for individual speakers. Otherwise Google cloning needs
    consent_path with the speaker's consent recording. Requires explicit
    user confirmation of ownership/permission; never assume it. Inputs are
    local paths (stdio) or public HTTPS URLs (hosted). Returns voice_id for
    preview_voice and synthesize_audio. list_voices includes saved clones.
    

Input Schema

NameRequiredDescriptionDefault
nameNo
clip_rangesNo
consent_pathNo
language_codeNo
clip_referenceNo
reference_pathYes
confirm_ownershipNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations supplied, the description carries the full burden and does well: it discloses the consent-recording prerequisite, mandates explicit user confirmation of ownership ('never assume it'), and distinguishes local filesystem paths (stdio) from public HTTPS URLs (hosted). It does not cover failure modes, whether a clone can be undone, or cost implications, but the safety-critical behavior for a voice-cloning mutation is well surfaced.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core action, then organized by concern (cloning mode, consent, input sources, outputs). Nearly every sentence adds information, though the line-broken layout makes the provider branching slightly harder to scan than a single tight paragraph would.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 7-parameter, unannotated creation tool, this is fairly complete: consent requirements, provider-specific prerequisites, accepted input sources, and next-step tools are all covered. An output schema exists so return values need no explanation, but the missing differentiation from `clone_voice` and the undocumented `name`/`language_code` leave small gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate, and it explains the non-obvious parameters: `clip_reference`, `clip_ranges` as speech-only `{start_ms,end_ms}` ranges for individual speakers, `consent_path` as the consent recording, and `reference_path` as local path or public HTTPS URL. `name` and `language_code` are never mentioned, and `confirm_ownership`'s exact semantics are only implied by the confirmation sentence.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first line gives a specific verb and resource (create/save a reusable voice clone) plus scope (caller's workspace), which is far better than a tautology. However, the sibling tool `clone_voice` appears to overlap heavily and the description never states how `create_byo_voice` differs from it, so the agent must guess between two similar-sounding creation tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit conditional branching: set `clip_reference=true` for ElevenLabs cloning from audio/video, otherwise Google cloning requires `consent_path`. It also names downstream consumers (`preview_voice`, `synthesize_audio`, `list_voices`), which helps the agent place this step in a workflow. It stops short of saying when to prefer `create_byo_voice` over the sibling `clone_voice`, and gives no exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.