otherapi_key

Gradium

Gradium provides low-latency speech generation, transcription, voice management, and pronunciation tools for real-time voice applications.

Verdict

Gradium converts text into natural-sounding speech inside Switchy Projects. @mention it to generate audio from written content, manage custom pronunciation dictionaries for brand terms or technical jargon, and track credit usage across your team's voice synthesis sessions. Teams that produce audio content—podcasts, training videos, accessibility features—get the most value. You'll need a Gradium API key and active subscription; credit consumption depends on text length and voice selection, so monitor usage regularly to avoid mid-project interruptions.

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 Dictionary
    destructive

    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

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

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

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.

Prompt

@Gradium list all available voices in English and Spanish, then show me which ones support emotional tone control.

Output

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.

Notes

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.

Prompt

@Gradium create a pronunciation dictionary for en-US that rewrites 'SQL' as 'sequel' and 'API' as 'A P I' spelled out.

Output

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.

Notes

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.

Prompt

@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?

Output

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.

Notes

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

Customer support call transcription review

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.

Podcast post-production workflow

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.

SaaS onboarding video localization

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.

More other MCPs

See all other MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.