Your AI Agent Gets the Whole EasyVoice Platform — One MCP URL

claude.ai — custom connectors

Settings → Connectors → Add custom connector. Paste the server URL, then add a request header (the header option is labeled beta in the connector UI):

URL:    https://easyvoice.ae/api/mcp
Header: Authorization: Bearer ev_your_api_key

Claude Desktop

Uses the same account-level Connectors UI as claude.ai (Settings → Connectors — synced to your account). Honest note: claude_desktop_config.json only takes local stdio servers, not remote URLs — for a remote server use the Connectors UI, or the mcp-remote bridge at the bottom of this list.

{
  "mcpServers": {
    "easyvoice": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://easyvoice.ae/api/mcp",
        "--header",
        "Authorization:Bearer ev_your_api_key"
      ]
    }
  }
}

Claude Code

claude mcp add --transport http easyvoice https://easyvoice.ae/api/mcp --header "Authorization: Bearer ev_your_api_key"

Or the equivalent .mcp.json entry:

{
  "mcpServers": {
    "easyvoice": {
      "type": "http",
      "url": "https://easyvoice.ae/api/mcp",
      "headers": { "Authorization": "Bearer ev_your_api_key" }
    }
  }
}

ChatGPT — developer mode

Available on Plus, Pro, Business, Enterprise, and Edu (web). Enable developer mode in settings, then add a connector. The form supports OAuth or no authentication only — no custom headers — so put the key in the URL and pick No authentication:

https://easyvoice.ae/api/mcp?key=ev_your_api_key

Key-in-URL caveat: the URL sits in your connector config, so treat it like a password — you can revoke and recreate the key anytime at /account/keys. Hedged note: multiple community reports say Plus/Pro may restrict connector tools to read-only (unconfirmed by OpenAI docs) — if text_to_speech refuses to run there, that is the likely cause, not your key.

Cursor

Add to ~/.cursor/mcp.json. Prefer to keep the key out of the file? ${env:EASYVOICE_API_KEY} interpolation also works:

{
  "mcpServers": {
    "easyvoice": {
      "url": "https://easyvoice.ae/api/mcp",
      "headers": { "Authorization": "Bearer ev_your_api_key" }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your workspace.

{
  "servers": {
    "easyvoice": {
      "type": "http",
      "url": "https://easyvoice.ae/api/mcp",
      "headers": {
        "Authorization": "Bearer ev_your_api_key"
      }
    }
  }
}

Anything else — mcp-remote fallback

Bridges any stdio-only MCP client to this server:

npx mcp-remote https://easyvoice.ae/api/mcp --header "Authorization:Bearer ev_your_api_key"

Windows note: some client configs mangle spaces inside args — write the header value with no space after the colon (as above), or use the ?key= URL form instead.

Instant TTS

text_to_speech

Convert text to a hosted MP3/WAV download link — the core tool, and the one free keys can use. Per-call limit: 8,000 characters (4,000 for Arabic ar_* voices).

// tools/call arguments
{ "text": "Hello from my AI agent!", "voice": "af_aoede", "format": "mp3" }

// result (abridged)
{ "audio_url": "https://easyvoice.ae/api/tts/audio/1f6f7c2e-8a41.mp3",
  "voice": "af_aoede", "format": "mp3", "characters": 23 }

The result is a hosted download URL (https://easyvoice.ae/api/tts/audio/<uuid>.mp3). Audio links are not guaranteed to persist — download promptly. Over 8,000 characters on a Kokoro voice? Use generate_long_form (Pro) or the web studio. Over 4,000 characters on an ar_* voice? Use POST /api/v1/audio/speech (Arabic sync cap 12,000) or the web app — never the long-form tool, which is Kokoro-only and rejects Arabic voices. Your ready cloned voice_* ids work here with Pro or an active 7-day pass. Cloned voices speak English; requests over 2,000 characters are queued as background jobs with Pro. Pass holders split text into calls of 2,000 characters or fewer, or use Pro for background jobs. Only the key owner can use a clone.

list_voices

No parameters. Lists all 66 catalog voices with a tier column (free | pro) plus your cloned voices and their status. Free keys can synthesize with the 12 free-tier voices — the rest return a truthful Pro-required error.

// tools/call arguments
{}

// result (abridged)
{ "plan": "free",
  "voices": [ { "id": "af_aoede", "name": "Aoede", "language": "English",
                "tier": "free", "available": true }, "..." ],
  "cloned": [ { "id": "voice_abc123", "name": "My Voice", "status": "ready" } ] }

Async jobs — long-form, podcast, status

Pro gate, stated once up front: these tools reuse the Jobs API, and “The Jobs API requires a Pro subscription — free API keys can use /v1/audio/speech.” is exactly what a free key gets back (as an isError result). Free keys can use instant text_to_speech above. The agent flow for all job tools: create → poll get_job_status → download audio_url. Generated audio is kept for six months and then deleted — on the 1st of each month we remove the month that has passed six months. Download anything you want to keep; your generation history (the text and the settings) stays in your account. The audio_url can be re-fetched any time within that window by calling get_job_status again with the same job id.

generate_long_form

Narrate a full script — up to 500,000 characters in one job. Kokoro narration voices only: ar_* and cloned voice_* ids are rejected by the long-form engine.

// tools/call arguments
{ "input": "Chapter 1. The full 120,000-character script...", "voice": "af_aoede" }

// result — a job id, 202-style
{ "job_id": "1f6f7c2e-...", "status": "queued", "input_chars": 120000 }

// then poll get_job_status with that job_id:
{ "id": "1f6f7c2e-...", "status": "active", "completed": 3, "total": 12 }
{ "id": "1f6f7c2e-...", "status": "completed",
  "audio_url": "https://easyvoice.ae/api/tts/audio/1f6f7c2e.mp3" }

create_podcast

Two-speaker (A/B) episode from dialogue segments. Caps: up to 60 segments and 30,000 combined characters per episode on Pro. Your READY cloned voice_* ids are allowed as either speaker.

// tools/call arguments
{ "segments": [
    { "speaker": "A", "text": "Welcome to the show." },
    { "speaker": "B", "text": "Great to be here." } ],
  "voice_a": "af_aoede", "voice_b": "am_adam" }

// result — then poll get_job_status; the completed job carries the episode
// audio_url plus per-segment audio URLs
{ "job_id": "3a9f1b7c-...", "status": "queued" }

get_job_status

Poll any job owned by your key. Long-form jobs add completed/total part progress; podcast jobs add per-segment audio URLs.

// tools/call arguments
{ "job_id": "1f6f7c2e-..." }

// result (abridged)
{ "id": "1f6f7c2e-...", "status": "completed",
  "audio_url": "https://easyvoice.ae/api/tts/audio/1f6f7c2e.mp3" }

Voice cloning

clone_voice

Enroll a custom cloned voice from an audio sample (async); cloned voices speak English. Honest gating, all enforced server-side: Pro or 7-day pass; consent: true attestation required (recorded); 5 enrollments per day; 3 cloned voices max — a full account returns 409. Sample: 10 MB max, wav/mp3/m4a, a 10–30 second clean single-speaker recording (enrollment rejects shorter or longer clips).

// tools/call arguments
{ "name": "My Narrator", "consent": true,
  "audio_url": "https://example.com/sample.wav" }

// result
{ "voice_id": "voice_9f2c...", "status": "enrolling" }

The tool returns the voice id at once and no job id, so get_job_status does not apply. After enrolling, check list_voices until the clone reports ready, then use it in create_podcast (Pro key), or in text_to_speech with Pro or an active 7-day pass. Synchronous cloned synthesis also works through POST /api/v1/audio/speech with the same key.

Account

get_usage

No parameters — returns your plan, remaining free characters, rate limits, and the daily reset time. Agents should call this to self-handle quota errors instead of retrying blindly.

// tools/call arguments
{}

// result (free key)
{ "plan": "free", "used": 1200, "remaining": 3800, "limit": 5000,
  "rpm_limit": 20, "concurrency_limit": 2, "reset_at": "2026-07-22T00:00:00Z" }