Introducing Phonon ・ Our first open, on-device TTS model

Gradium MCP beta

Text-to-Speech and voice selection from your coding agent

3 min read

The 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.

We 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.

Set it up with a coding agent

Paste this prompt into Claude Code or Codex. You need a Gradium account, and no API key.

prompt
Connect the Gradium MCP at https://mcp.gradium.ai/mcp, then find a friendly voice and read this aloud:
"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."

Your 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.

What the Gradium MCP does

Tool What it does Cost
list_voices Browses the Gradium catalog and your organization's custom voices, filtered by language, accent, gender or use case Free
get_voice Shows one voice's details, such as its accent, gender, age and description Free
generate_speech Turns your text into speech with the voice you choose 1 credit per character
get_credits Shows your credit balance and plan Free

For 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."

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.

Add the Gradium MCP manually

If you'd rather run the commands yourself, use these.

Claude Code

bash
claude mcp add --transport http --scope user gradium https://mcp.gradium.ai/mcp

Then 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.

Codex

bash
codex mcp add gradium --url https://mcp.gradium.ai/mcp
codex mcp login gradium

The Gradium skills for Claude Code and Codex

The Gradium plugin adds four skills that help your agent use the MCP:

  • Setup connects to the MCP and explains sign-in errors.
  • Credits checks your balance and which organization to use.
  • Voice selection shortlists voices that match your brief.
  • Speech generation turns your script into audio files in your project.

You'll find the skills, with install steps for Claude Code and Codex, in the gradium-ai/skills repository.

What's coming to the Gradium MCP

The 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.

We're also submitting the Gradium plugin to the Claude Code and Codex plugin directories, so installing it becomes a single step.

Tell us how you use it

Tell us on Discord:

  • what you're using the Gradium MCP for, or plan to use it for
  • which agent you use it with, and how the setup went
  • what worked well, and what got in your way
  • which tool or feature you want next

Get started

The Gradium MCP works with your existing Gradium account and credits, with no API key to manage.

Related posts

Frequently Asked Questions