Developers
Give your AI assistant a voice.
Polyvox is an MCP server. Meta Muse, Claude Code, Cursor, or any agent that speaks the Model Context Protocol can make clips in your cloned voice, in 75 languages, and hand you a link to share.
Connect in three steps
- 1. Create a key. Sign in, open Settings → API keys, and create one. It is shown once.
- 2. Add the endpoint to your client with the key as a bearer token.
- 3. Ask for a clip. “Say ‘happy birthday, Ana’ in Spanish in my voice and give me the link.”
MCP endpoint
https://api.usepolyvox.com/mcp
Streamable HTTP, stateless. Auth: Authorization: Bearer pvx_…
Meta Muse
Tell Muse: “Connect Polyvox. It’s an MCP server at https://api.usepolyvox.com/mcpand needs a bearer token.” When Muse asks for credentials, paste your key into its secure credential prompt, not into the chat.
Claude Code
claude mcp add --transport http polyvox https://api.usepolyvox.com/mcp \
--header "Authorization: Bearer pvx_YOUR_KEY"Cursor and other JSON-configured clients
{
"mcpServers": {
"polyvox": {
"url": "https://api.usepolyvox.com/mcp",
"headers": { "Authorization": "Bearer pvx_YOUR_KEY" }
}
}
}Claude.ai and ChatGPT connector directories require OAuth sign-in, which is on our roadmap. Until then, use them through a client that supports custom headers.
Tools
| Tool | What it does | Cost |
|---|---|---|
| get_account | Plan, clips left this month, per-clip text limit, languages included. | Free |
| list_voices | Your cloned voices plus the ready-made voice actors, with the languages each can speak. | Free |
| list_languages | All 75 languages with codes and which ones your plan includes. | Free |
| generate_clip | Text in, spoken MP3 out. Translates into the target language first. Returns a share link and a one-hour audio URL. | 1 credit |
| get_clip | Status, share link, fresh audio URL and play count for one clip. | Free |
| list_clips | Your most recent saved clips. | Free |
| suggest_script | Draft a short script from a description, to review before speaking it. | Free |
| clone_voice | Clone the user's voice from a short recording (URL or base64). Requires the user's consent and the language spoken. | 1 voice slot |
| get_clone_link | A one-tap, signed-in link to the clone studio so the user records in the browser. Works once, 15 minutes. | Free |
REST API
The same key works against the REST API that powers the web app. The OpenAPI document is at https://api.usepolyvox.com/openapi.json, so clients that build integrations from an API spec (Muse included) can use it directly.
curl https://api.usepolyvox.com/api/v1/generations \
-H "Authorization: Bearer pvx_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"voice_id":"<from GET /api/v1/voices>","transcript":"Hello!","language":"es"}'Limits, security and privacy
- Every clip spends one credit, the same meter as the web studio. Free accounts: 350 characters per clip and 8 languages. Paid plans: 5,000 characters, up to all 75 languages.
- 120 requests per minute per key. Up to 5 active keys per account.
- A key can only see your own voices, make clips with them, and clone new ones within your plan’s slots (at most 3 clones per day per key, and only with your consent recorded). It cannot change billing or your profile, or manage keys: those need a signed-in browser session.
- Keys are stored hashed. Revoke one at any time from Settings and it stops working immediately.
- Clips made by an agent appear in My Clips like any other. Share links are public to anyone who has the URL, as always.
- See the privacy policy and terms. Questions: contact us.