# CAMB.AI — how to use (mcp.ai)

Connect your CAMB.AI account and use 8 tools for artificial intelligence straight from your AI agent. Connect with your own API key. CAMB.AI provides hosted APIs for multilingual dubbing, speech synthesis, transcription, translation, voice cloning, and audio generation.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_camb_ai?ms=1787296020000`
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. `camb_ai_dub_media`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/camb_ai`
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/camb_ai/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/camb_ai/dub/media` — Dub media from a URL into one or more target languages, wait for completion, and return the output video, audio, and structured transcript.
  - body: { media_url: string, source_language: string, timeout_seconds?: number, target_languages: string[], transcription_mode?: string }
- `POST https://api.mcp.ai/api/camb_ai/generate/subtitles` — Generate translated subtitles for media in one or more languages, wait for CAMB.AI to finish, and return structured subtitle cues.
  - body: { folder_id?: integer, media_url: string, source_language: string, timeout_seconds?: number, target_languages: string[], formatting_options?: object, transcription_mode?: string }
- `POST https://api.mcp.ai/api/camb_ai/get/run/result` — Fetch the structured JSON result for a successful CAMB.AI translation, transcription, dubbing, or subtitle run when its run ID is known.
  - body: { run_id: integer, workflow: string }
- `POST https://api.mcp.ai/api/camb_ai/get/task/status` — Check one CAMB.AI translation, transcription, dubbing, or subtitle task without waiting. Use this to recover a task after a workflow timeout or when a task ID is already known.
  - body: { task_id: string, workflow: string }
- `POST https://api.mcp.ai/api/camb_ai/list/languages` — List CAMB.AI source and target languages, including locale tags and numeric IDs used by generation tools.
- `POST https://api.mcp.ai/api/camb_ai/list/voices` — Find CAMB.AI voices by name, description, language ID, gender, or publication state before choosing a voice for speech workflows.
  - body: { limit?: integer, gender?: integer, search?: string, language_id?: integer, published_only?: boolean }
- `POST https://api.mcp.ai/api/camb_ai/transcribe/media` — Transcribe an uploaded audio/video file or a media URL, wait for CAMB.AI to finish, and return a structured speaker-and-timing transcript.
  - body: { language: string, media_url?: string, media_file?: object, timeout_seconds?: number, formatting_options?: object, transcription_mode?: string }
- `POST https://api.mcp.ai/api/camb_ai/translate/text` — Translate one or more text segments and wait for CAMB.AI to return all translated segments in input order.
  - body: { age?: integer, texts: string[], gender?: integer, formality?: string, source_language: string, target_language: string, timeout_seconds?: number }

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

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