This record as markdown: /tools/aiwerk-mcp-server-elevenlabs/get-user-voices-v2.md
What get_user_voices_v2 does on Elevenlabs
AI agents call get_user_voices_v2 to retrieve information from Elevenlabs without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
age | string | null | — | Age used for filtering, based on the voice's 'age' label. |
sort | string | null | — | Which field to sort by, one of 'created_at_unix' or 'name'. 'created_at_unix' may not be available for older voices. |
accent | string | null | — | Accent used for filtering, based on the voice's 'accent' label. |
gender | string | null | — | Gender used for filtering, based on the voice's 'gender' label. |
search | string | null | — | Search term to filter voices by. Searches in name, description, labels, category. |
category | string | null | — | Category of the voice to filter by. One of 'premade', 'cloned', 'generated', 'professional' |
language | object | — | Languages used for filtering, based on the voice's 'language' label. Voices matching any of the given languages are returned. |
page_size | number | — | How many voices to return at maximum. Can not exceed 100, defaults to 10. Page 0 may include more voices due to default voices being included. |
use_cases | object | — | Use cases used for filtering, based on the voice's 'use_case' label. Voices matching any of the given use cases are returned. |
voice_ids | object | — | Voice IDs to lookup by. Maximum 100 voice IDs. |
voice_type | string | null | — | Type of the voice to filter by. One of 'personal', 'community', 'default', 'workspace', 'non-default', 'non-community', 'saved'. 'non-default' is equal to all b |
high_quality | boolean | null | — | When true, only return studio-quality voices (those whose category is 'high_quality'). |
Parameters from the server's own tool schema.
Why get_user_voices_v2 is rated Low
Even though get_user_voices_v2 only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.
Risk signalsHigh parameter count (20 properties)
Attacks that exploit this kind of access
The rule that runs get_user_voices_v2 safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Elevenlabs, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For get_user_voices_v2, this is the rule to start with:
get_user_voices_v2 is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Elevenlabs, apply this rule, and every get_user_voices_v2 call is checked against it from then on.
Questions about get_user_voices_v2
Get Voices V2. It is categorised as a Read tool in the Elevenlabs MCP Server, which means it retrieves data without modifying state.
get_user_voices_v2 accepts 12 parameters: age, sort, accent, gender, search, category, language, page_size, use_cases, voice_ids, voice_type, high_quality. The full parameter table on this page comes from the server's own tool schema.
Register the Elevenlabs MCP server in PolicyLayer and add a rule for get_user_voices_v2: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Elevenlabs. Nothing to install.
get_user_voices_v2 is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the get_user_voices_v2 rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for get_user_voices_v2. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
get_user_voices_v2 is provided by the Elevenlabs MCP server (@aiwerk/mcp-server-elevenlabs). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Elevenlabs, and thousands of servers like it.
This server
Across the catalogue