# Gradium — how to use (mcp.ai)

Connect your Gradium account and use 9 tools for artificial intelligence straight from your AI agent. Connect with your own API key. Gradium provides low-latency speech generation, transcription, voice management, and pronunciation tools for real-time voice applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_gradium?ms=1787291520000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `gradium_create_pronunciation_dictionary`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/gradium`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/gradium/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/gradium/create/pronunciation/dictionary` — Create a language-specific pronunciation dictionary with optional rewrite rules.
  - body: { name: string, rules?: object[], language: string, description?: string }
- `POST https://api.mcp.ai/api/gradium/delete/pronunciation/dictionary` — Permanently delete one pronunciation dictionary by UID.
  - body: { uid: string }
- `POST https://api.mcp.ai/api/gradium/get/credits` — Get the connected Gradium subscription's current credit balance and billing-period metadata.
- `POST https://api.mcp.ai/api/gradium/get/pronunciation/dictionary` — Retrieve one pronunciation dictionary and its complete rewrite rule set by UID.
  - body: { uid: string }
- `POST https://api.mcp.ai/api/gradium/get/usage/summary` — Retrieve aggregate Gradium session, message, text, audio-duration, and consumed-credit usage totals.
- `POST https://api.mcp.ai/api/gradium/get/voice` — Retrieve metadata for one Gradium catalog or custom voice by its UID.
  - body: { voice_uid: string }
- `POST https://api.mcp.ai/api/gradium/list/pronunciation/dictionaries` — List pronunciation dictionaries for the connected organization, optionally filtered by language.
  - body: { language?: string, page_size?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/gradium/list/voices` — List custom voices and, by default, Gradium's public voice catalog, returning voice IDs and metadata for later selection.
  - body: { page_size?: integer, next_cursor?: string, include_catalog?: boolean }
- `POST https://api.mcp.ai/api/gradium/update/pronunciation/dictionary` — Update pronunciation dictionary metadata and optionally replace its complete rewrite rule set.
  - body: { uid: string, name?: string, rules?: object[], language?: string, description?: string }

## Example prompts
- "What can I do in Gradium?"
- "Show me a summary of my Gradium account"

## More
- Page: https://mcp.ai/gradium
- Agent spec (llms.txt): https://mcp.ai/gradium/llms.txt
- Postman collection: https://mcp.ai/gradium/postman.json