{"slug": "gradium-mcp-beta", "title": "Gradium MCP beta", "summary": "Gradium released a beta Model Context Protocol server at https://mcp.gradium.ai/mcp that lets coding agents in Claude Code and Codex browse Gradium's voice catalog and generate text-to-speech without leaving the session. The server exposes four tools: list_voices and get_voice are free, get_credits shows balance and plan, and generate_speech costs 1 credit per character at the same rate as Gradium's API, with sign-in through an existing Gradium account and no API key. Gradium also published four Claude Code and Codex skills in the gradium-ai/skills GitHub repository and said speech-to-text and voice design are the next candidates for the beta.", "body_md": "# Gradium MCP beta\n\nText-to-Speech and voice selection from your coding agent\n\nThe Gradium MCP is available today in beta at `https://mcp.gradium.ai/mcp`. Ask your coding agent to turn a short PDF into an audiobook or add a voiceover to your video, without leaving your coding session.\n\nWe built the Gradium MCP to make exploring Gradium voices easier. You can sign in to your Gradium account from your agent, with no detour to Studio. The agent can then browse the catalog and recommend voices for you.\n\n## Set it up with a coding agent\n\nPaste this prompt into Claude Code or Codex. You need a Gradium account, and no API key.\n\n```\nConnect the Gradium MCP at https://mcp.gradium.ai/mcp, then find a friendly voice and read this aloud:\n\"I’ve got a parcel for Mr. Sherlock Holmes at 221B Baker Street. Could you look it up? The tracking code is RF24, and the surname is spelled H-O-L-M-E-S.\"\n```\n\nYour agent adds the server and asks you to sign in. If the Gradium tools don't show up after you sign in, start a new session and paste the prompt again.\n\n## What the Gradium MCP does\n\n| Tool | What it does | Cost | \n|---|---|---|\n| `list_voices` | Browses the Gradium catalog and your organization's custom voices, filtered by language, accent, gender or use case | Free | \n| `get_voice` | Shows one voice's details, such as its accent, gender, age and description | Free | \n| `generate_speech` | Turns your text into speech with the voice you choose | 1 credit per character | \n| `get_credits` | Shows your credit balance and plan | Free | \n\nFor example, `get_voice` describes Everly as a middle-aged, female, American English (`en-us`) voice with a \"rounded, soft-edged tone with gentle lift at the end of phrases.\"\n\n`list_voices` lists the best-ranked voices first, starting with the flagship voices our team picked by hand. Your agent browses voices for free, and only uses credits when it generates audio, at the same rate as the API.\n\n## Add the Gradium MCP manually\n\nIf you'd rather run the commands yourself, use these.\n\n### Claude Code\n\n```\nclaude mcp add --transport http --scope user gradium https://mcp.gradium.ai/mcp\n```\n\nThen run `/mcp` in a session, select `gradium` and choose Authenticate. If you install the Gradium plugin, skip this command. The plugin already includes the server, and Claude Code connects each URL only once.\n\n### Codex\n\n```\ncodex mcp add gradium --url https://mcp.gradium.ai/mcp\ncodex mcp login gradium\n```\n\n## The Gradium skills for Claude Code and Codex\n\nThe Gradium plugin adds four skills that help your agent use the MCP:\n\n- Setup connects to the MCP and explains sign-in errors.\n- Credits checks your balance and which organization to use.\n- Voice selection shortlists voices that match your brief.\n- Speech generation turns your script into audio files in your project.\n\nYou'll find the skills, with install steps for Claude Code and Codex, in the [gradium-ai/skills](https://github.com/gradium-ai/skills) repository.\n\n## What's coming to the Gradium MCP\n\nThe beta covers Text-to-Speech and choosing voices. Speech-to-Text and voice design are the next candidates, and your feedback decides which ships first.\n\nWe're also submitting the Gradium plugin to the Claude Code and Codex plugin directories, so installing it becomes a single step.\n\n## Tell us how you use it\n\nTell us on [Discord](https://discord.gg/T85yt8kD33):\n\n- what you're using the Gradium MCP for, or plan to use it for\n- which agent you use it with, and how the setup went\n- what worked well, and what got in your way\n- which tool or feature you want next\n\n## Get started\n\nThe Gradium MCP works with your existing Gradium account and credits, with no API key to manage.\n\n- Gradium MCP guide: [docs.gradium.ai/integrations/mcp](https://docs.gradium.ai/integrations/mcp)\n- Gradium skills: [github.com/gradium-ai/skills](https://github.com/gradium-ai/skills)\n- Create a Gradium account: [studio.gradium.ai](https://studio.gradium.ai/sign-in)\n- Feedback and feature requests: [Discord](https://discord.gg/T85yt8kD33)\n- Questions or volume pricing: [talk to us](https://gradium.ai/contact?subject=Sales)\n\n## Related posts\n\n[Jul 30, 2026ResearchDiscover](https://gradium.ai/blog/gradium-tts-public-beta)\n\nGradium TTS public beta: open for your hardest cases\n\nA new Gradium TTS model is available today in public beta. It keeps improving on the current production model, handling the complex cases natively, phone numbers, email addresses, IBAN numbers, time expressions and more, with no pre-processing or text normalization on your side. Anyone can test it through the API, and everyone who sends us feedback during the beta receives 1M Gradium credits.\n\n[Feb 11, 2026EngineeringDiscover](https://gradium.ai/blog/optimizing-quality-vs-latency)\n\nOptimizing Quality vs. Latency in Real-Time Text-to-Speech AI Models\n\nExplore strategies for balancing quality and latency in real-time TTS AI models. Learn how Gradium achieves low-latency, high-quality speech synthesis for voice applications.\n\n## Frequently Asked Questions\n\nYes. The beta covers Text-to-Speech and choosing voices, and we're adding more tools soon. Tell us on Discord what you'd use it for.\n\nNo. You sign in with your Gradium Studio account over OAuth when your client connects. The server never asks for an API key.\n\nWe've tested the Gradium MCP in Claude Code and Codex. In both, the Gradium plugin adds four skills on top of the MCP server.\n\nBrowsing voices, reading voice details and checking credits are free. generate_speech uses 1 credit per character of text, the same rate as the Text-to-Speech API. Auditioning a voice means generating audio with it, so auditions use credits too.\n\nThe catalog includes voices in English, French, German, Spanish and Portuguese, each led by a flagship voice. Your organization's custom voices work too.\n\ngenerate_speech accepts up to 9,000 characters per call and returns at most about 2 minutes and 55 seconds of audio, roughly 2,000 characters. In Claude Code, the speech generation skill splits longer scripts into parts and can join them into one file.\n\nThey're the next candidates for the MCP. Today you can use Speech-to-Text, voice design and voice cloning through the API and in Studio.\n\nThe docs MCP searches the Gradium documentation. The Gradium MCP generates speech and browses voices in your account.", "url": "https://wpnews.pro/news/gradium-mcp-beta", "canonical_source": "https://gradium.ai/blog/gradium-mcp-beta", "published_at": "2026-11-19 00:00:00+00:00", "updated_at": "2026-11-19 18:44:21.614573+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "ai-tools", "developer-tools", "generative-ai"], "entities": ["Gradium", "Gradium MCP", "Claude Code", "Codex", "gradium-ai/skills", "Everly"], "also_reported_by": [], "takeaway": "Gradium's MCP server at https://mcp.gradium.ai/mcp exposes list_voices, get_voice, generate_speech and get_credits to Claude Code and Codex, with voice browsing free and speech billed at 1 credit per character, matching the API rate.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/gradium-mcp-beta", "markdown": "https://wpnews.pro/news/gradium-mcp-beta.md", "text": "https://wpnews.pro/news/gradium-mcp-beta.txt", "jsonld": "https://wpnews.pro/news/gradium-mcp-beta.jsonld"}}