Add Kurdish Voice to Claude

Create a free account at kurdishtts.com and open Settings → API. Generate a TTS key (for speech) and an STT key (for transcription) — they are separate keys. The free tier includes 20,000 characters of speech and 120 minutes of transcription per month.

In the configs below, join the two keys with a colon: Bearer YOUR_TTS_KEY:YOUR_STT_KEY. If you only need speech, a single TTS key works too: Bearer YOUR_TTS_KEY.

Claude Code (terminal) — one command:

claude mcp add --transport http kurdish-tts \
  https://www.kurdishtts.com/api/mcp \
  --header "Authorization: Bearer YOUR_TTS_KEY:YOUR_STT_KEY"

Claude Desktop — add this to claude_desktop_config.json (Settings → Developer → Edit Config). Desktop config runs local commands, so the remote server is bridged with mcp-remote:

{
  "mcpServers": {
    "kurdish-tts": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://www.kurdishtts.com/api/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_TTS_KEY:YOUR_STT_KEY"
      }
    }
  }
}

Cursor — add to .cursor/mcp.json (supports remote URLs directly):

{
  "mcpServers": {
    "kurdish-tts": {
      "url": "https://www.kurdishtts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TTS_KEY:YOUR_STT_KEY"
      }
    }
  }
}

Restart your client, then try:

• “Use kurdish-tts to say سڵاو، چۆنی؟ in a Sorani voice.”
• “List the available Kurmanji voices.”
• “Transcribe this Kurdish audio file and translate it to English.”

Claude picks the right tool automatically: synthesize_speech, transcribe_audio, start_streaming_transcription, list_voices or list_dialects.

• Usage is billed to your plan exactly like the website and HTTP API — the free tier is enough to evaluate; paid plans raise the limits.
• On the free tier, use the v3 voices sorani_85, sorani_214, kurmanji_6 or kurmanji_12 — other voices require a paid plan.
• MCP calls are capped at 600 characters per synthesis and 4MB of audio per transcription. For longer jobs use the HTTP API directly.
• The server is listed in the official MCP registry as com.kurdishtts/kurdish-tts-stt.

Next: call the TTS API from Python or JavaScript or transcribe Kurdish audio programmatically.