Give Claude Code or Cursor a voice with Speakvora MCP
Connect Speakvora's text-to-speech API to Claude Code or Cursor using the MCP server. Add voice to your AI assistant in minutes.
What is the Speakvora MCP server?
The Speakvora MCP server connects your AI assistant to Speakvora's voice API. It exposes three tools: speak (generate audio from text), list_voices (browse available voices), and search_phrases (find pre-recorded phrases by keyword). MCP is a standard that lets Claude Code, Cursor, and other AI tools call external APIs safely and reliably.
Install the MCP server
Open Claude Code or Cursor and run this command in the terminal:
- Replace YOUR_KEY_HERE with your Speakvora API key (find it in your dashboard).
- The --transport http flag tells Claude to call the MCP server over HTTP.
- The --header flag passes your API key with every request.
Add Speakvora MCP
claude mcp add --transport http speakvora https://speakvora.com/api/mcp --header "x-api-key: YOUR_KEY_HERE"Use the speak tool
Once installed, ask Claude to speak text aloud. For example: "Read this sentence using voice af_heart in English." Claude will call the speak tool, which returns an audio URL. You can play the audio directly or download it.
Example: speak tool response
{
"url": "https://speakvora.com/audio/...",
"voice": "af_heart",
"lang": "en",
"characters": 42,
"format": "m4a",
"live": true
}Browse voices and search phrases
Use list_voices to see all available voices and their languages. Use search_phrases to find pre-recorded phrases by keyword—useful for quick lookups without generating new audio. Both tools work instantly and help you discover what's available before you speak.
- list_voices returns voice IDs, names, tiers, and supported languages.
- search_phrases accepts a keyword and language code (e.g., 'en' for English).
- Search results show exact phrases in the library, ready to play.
Pricing and limits
The speak tool charges $3 per 1 million characters for catalog voices. Your account includes 100,000 free characters once. Text limits are 1 to 500 characters per request.
Troubleshooting
- If the MCP server doesn't connect, check that your API key is correct and has no extra spaces.
- Verify your key is active in the Speakvora dashboard.
- If audio generation is slow, the text may be queued; try again in a few seconds.
- For unsupported languages or voices, check the list_voices tool output.
Frequently asked questions
What is MCP and why do I need it?
MCP is a standard that lets AI assistants safely call external APIs. Speakvora's MCP server lets Claude Code and Cursor use text-to-speech without leaving the editor. It handles authentication and formats responses automatically.
Can I use Speakvora MCP with other AI tools?
MCP is supported by Claude Code, Cursor, and other tools that implement the standard. Check your tool's documentation for MCP support. The Speakvora MCP server runs at https://speakvora.com/api/mcp.
How do I get an API key?
Sign up at https://speakvora.com/dashboard and create an API key in the Keys section. Keep your key private and never commit it to version control.
What voices are available?
Use the list_voices tool to see all available voices and their supported languages. Speakvora offers voices across multiple tiers including Kokoro, Fast, Chatterbox, and Premium.
Related: API documentation, pricing, developer guides and more answers.