Gradium
Gradium provides low-latency speech generation, transcription, voice management, and pronunciation tools for real-time voice applications.
Verdict
Common use cases
- Generate podcast narration from scripts
- Produce training video voiceovers at scale
- Add audio descriptions for accessibility
- Test pronunciation of brand names
- Monitor voice synthesis credit burn rate
Integration
- Vendor
- Gradium
- Category
- other
- Auth
- API_KEY
- Tools
- 9
- Composio slug
gradium
Tools
- Create Pronunciation Dictionary
Create a language-specific pronunciation dictionary with optional rewrite rules.
- Delete Pronunciation Dictionarydestructive
Permanently delete one pronunciation dictionary by UID.
- Get Credits
Get the connected Gradium subscription's current credit balance and billing-period metadata.
- Get Pronunciation Dictionary
Retrieve one pronunciation dictionary and its complete rewrite rule set by UID.
- Get Usage Summary
Retrieve aggregate Gradium session, message, text, audio-duration, and consumed-credit usage totals.
- Get Voice
Retrieve metadata for one Gradium catalog or custom voice by its UID.
- List Pronunciation Dictionaries
List pronunciation dictionaries for the connected organization, optionally filtered by language.
- List Voices
List custom voices and, by default, Gradium's public voice catalog, returning voice IDs and metadata for later selection.
- Update Pronunciation Dictionary
Update pronunciation dictionary metadata and optionally replace its complete rewrite rule set.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations > MCP Servers. 2. Click 'Add MCP Server' and select Gradium from the list. 3. Log into your Gradium account at gradium.ai, navigate to API Settings, and generate a new API key with full access. 4. Paste the API key into Switchy's configuration field and click 'Connect'. 5. Switchy will verify the key and display your current credit balance. 6. Create a new Project or open an existing one, type '@Gradium get voices' in the chat, and confirm the MCP returns your available voice catalog. 7. To test synthesis, try '@Gradium convert this sentence to speech using voice UID [paste-a-voice-id-from-the-list]' and verify audio generation completes. 8. If your team uses specialized terminology, create a pronunciation dictionary first with '@Gradium create pronunciation dictionary for [language]' before running bulk synthesis tasks.
What teammates see: by default, memories from Gradium are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List Available Voices
@Gradium list all available voices with their metadata, including language, gender, and style tags.
Create Pronunciation Dictionary
@Gradium create a pronunciation dictionary for English with rewrite rules for our product names: 'Switchy' should sound like 'switch-ee' and 'Gradium' like 'gray-dee-um'.
Check Credit Balance
@Gradium get my current credit balance and tell me when the billing period resets.
Generate Audio from Text
@Gradium convert the following script to audio using voice UID [paste-voice-id]: 'Welcome to our new training module on workspace collaboration. Today we'll cover three key workflows.'
Review Usage Summary
@Gradium get a usage summary for the current billing period, breaking down total messages, audio duration, and credits consumed.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Gradium list all available voices in English and Spanish, then show me which ones support emotional tone control.
Found 47 English voices and 23 Spanish voices in the Gradium catalog. Of these, 18 English voices (including 'en-US-neural-aria', 'en-GB-neural-sonia') and 9 Spanish voices ('es-ES-neural-elvira', 'es-MX-neural-dalia') support emotional tone parameters like 'cheerful', 'empathetic', and 'calm'. Each voice entry includes sample audio URLs, language codes, and supported style tags. Custom voices for your organization are also listed separately if configured.
This example demonstrates catalog discovery — useful when selecting voices for text-to-speech workflows. The MCP returns metadata only; you'll need separate API calls to generate actual audio. Voice availability depends on your Gradium subscription tier.
@Gradium create a pronunciation dictionary for en-US that rewrites 'SQL' as 'sequel' and 'API' as 'A P I' spelled out.
Created pronunciation dictionary 'en-US-tech-terms' (UID: dict_8x3kp2m) with 2 rewrite rules. The dictionary is now active for all en-US voice synthesis requests tied to your API key. When generating audio, 'SQL' will be pronounced as 'sequel' and 'API' will be spelled letter-by-letter. You can attach this dictionary to synthesis calls by referencing its UID or update rules anytime via the MCP.
This write operation modifies your Gradium account state immediately. Pronunciation dictionaries persist across sessions and affect all future synthesis requests unless explicitly detached. Useful for brand names, acronyms, or domain-specific jargon that default TTS engines mispronounce.
@Gradium check my current credit balance and summarize this month's usage — how many audio minutes have I generated and what's my burn rate?
Your Gradium account has 12,450 credits remaining (out of 25,000 monthly). This billing period (Jan 1–31), you've consumed 12,550 credits across 487 synthesis sessions, generating 3.2 hours of audio. Average burn rate: ~450 credits/day. At this pace, you'll exhaust your balance in ~28 days. Top voice used: 'en-US-neural-aria' (38% of sessions). No overages yet, but you're trending toward your cap before month-end.
This synthesis example pairs Gradium's usage and credit APIs with the AI's math reasoning to forecast spend. Requires API_KEY auth with billing-read scope. Credit costs vary by voice type (neural voices cost more than standard), so burn-rate projections are estimates based on historical mix.
Use-case deep-dives
When Gradium fits voice-heavy support teams under 10 seats
A 6-person support team records customer calls and needs accurate transcripts with custom pronunciation for product names and industry jargon. Gradium's pronunciation dictionaries let you define how "Gradium" or "OAuth" should render in text, then apply those rules across every transcript. The Get Usage Summary tool tracks credit burn per billing period, so you know when you're approaching your plan cap. This works cleanly if your call volume stays under 200 hours per month and you're willing to manage dictionaries manually. Above that threshold, the 9-tool surface area feels thin—you'll want batch-upload APIs and webhook triggers that aren't exposed here. If your team is already in Gradium's ecosystem and needs light customization, the MCP saves you from building your own pronunciation layer.
Gradium MCP handles voice catalog browsing, not editing
A 3-person podcast team uses Gradium to generate intro voiceovers and ad reads in multiple languages. The List Voices tool surfaces the full catalog with metadata filters, so your AI agent can pick the right voice for a Spanish ad spot without opening the web UI. Get Voice pulls detailed metadata for final selection. The limitation: this MCP doesn't expose audio synthesis or editing endpoints—you're browsing and configuring, not rendering. If your workflow is "pick a voice, then hand off to Gradium's web app or a separate API client," the MCP fits. If you want the AI to generate and iterate on audio files inside the same session, you'll hit the boundary fast. Best for teams that treat voice selection as a research step, not a production step.
When pronunciation dictionaries justify the API-key setup cost
A 12-person product team ships onboarding videos in 8 languages and needs consistent pronunciation of the product name, feature labels, and competitor terms across every voiceover. Gradium's Create Pronunciation Dictionary tool lets you define rewrite rules per language, then retrieve and update them programmatically. The Get Credits tool prevents mid-sprint surprises when your video editor burns through the monthly allowance. This setup makes sense if you're producing 20+ videos per quarter and pronunciation errors have caused customer confusion in the past. If you're only localizing 3 videos a year, the overhead of managing API keys and dictionaries outweighs the benefit—just use the web UI. The MCP pays off when pronunciation consistency is a repeatable, high-frequency problem.
Frequently asked
What does the Gradium MCP do in Switchy?
It lets your AI agents generate speech from text using Gradium's voice catalog or your custom voices. Agents can list available voices, create pronunciation dictionaries to fix how words are spoken, and check your credit balance before running large jobs. Useful when you need AI to produce audio output — like narrating reports or generating voiceovers — without leaving the Switchy workspace.
Do I need a paid Gradium account to connect this MCP?
Yes. You need an active Gradium subscription and an API key from your account dashboard. The MCP calls the Get Credits tool to surface your current balance, so if you're on a free trial or prepaid plan, your agents will see how many credits remain before attempting synthesis. No admin role required — just valid API credentials.
Can the Gradium MCP actually synthesize audio files?
No. The nine tools exposed here manage voices, pronunciation dictionaries, and usage metadata — they don't trigger synthesis itself. You'll still call Gradium's synthesis endpoint directly or via another integration if you want agents to produce audio files. Think of this MCP as the control plane: it tells your agent which voices exist and how many credits you have left.
Why use this MCP instead of calling Gradium's API directly?
The MCP wraps Gradium's metadata endpoints so your agents can discover voices and check credit limits in natural language, without you writing API client code. If you already have a working Gradium pipeline, you probably don't need this. If you want agents to autonomously pick voices or warn you when credits run low, the MCP saves you from maintaining that logic yourself.
Who on the team should connect the Gradium MCP?
Whoever owns your Gradium API key and understands your voice inventory. Since pronunciation dictionaries are organization-wide, connecting this MCP gives agents write access to shared resources. If multiple people run synthesis jobs, coordinate who manages dictionaries to avoid accidental deletions. The MCP doesn't consume Switchy seats, but every synthesis call deducts from your Gradium credit pool.