# Gladia — how to use (mcp.ai)

Connect your Gladia account and use 10 tools for transcription straight from your AI agent. Connect with your own API key. Gladia provides state-of-the-art audio transcription and intelligence services through a simple API, enabling real-time and asynchronous transcription, translation, and audio analysis.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/gladia/delete/live/session` — Tool to delete a live transcription session and all its associated data (audio file, transcription). Use when permanently removing a live session from Gladia.
  - body: { id: string }
- `POST https://api.mcp.ai/api/gladia/delete/pre/recorded/job` — Tool to delete a pre-recorded transcription job and all its associated data (audio file, transcription). Use when permanently removing a transcription job from Gladia.
  - body: { id: string }
- `POST https://api.mcp.ai/api/gladia/get/live/transcription/result` — Tool to retrieve metadata and results of a live transcription job. Use when you need detailed status or results for a specific live transcription session.
  - body: { id: string }
- `POST https://api.mcp.ai/api/gladia/get/pre/recorded/job` — Tool to retrieve a pre-recorded transcription job's metadata, status, and results by ID. Use when checking the status or retrieving results of a specific pre-recorded job.
  - body: { id: string }
- `POST https://api.mcp.ai/api/gladia/get/transcription/audio/file/deprecated` — DEPRECATED - use GET /v2/pre-recorded/{id}/file instead. Download the audio file used for a transcription job. Use when you need to retrieve the original audio file associated with a specific transcri
  - body: { id: string }
- `POST https://api.mcp.ai/api/gladia/initiate/live/session` — Initiates a live (real-time) transcription session with Gladia's API. Returns a WebSocket URL that you can connect to for streaming audio data in real-time. The WebSocket URL includes an embedded auth
  - body: { model?: string, region?: string, callback?: boolean, channels?: integer, encoding?: string, bit_depth?: integer, endpointing?: number, sample_rate?: integer, pre_processing?: object, callback_config?: object, custom_metadata?: object, language_config?: object, messages_config?: object, post_processing?: object, realtime_processing?: object, maximum_duration_without_endpointing?: number }
- `POST https://api.mcp.ai/api/gladia/initiate/pre/recorded/transcription` — Tool to initiate a pre-recorded transcription job. Use when you have an audio URL and need asynchronous transcription results.
  - body: { model?: string, callback?: boolean, audio_url: string, sentences?: boolean, subtitles?: boolean, diarization?: boolean, translation?: boolean, summarization?: boolean, callback_config?: object, custom_metadata?: object, language_config?: object, subtitles_config?: object, diarization_config?: object, translation_config?: object, punctuation_enhanced?: boolean, summarization_config?: object }
- `POST https://api.mcp.ai/api/gladia/list/live/transcriptions` — Tool to list live transcription jobs. Use when you need an overview of live transcription sessions with optional filtering and pagination. Use after setting up live transcription.
  - body: { date?: string, limit?: integer, offset?: integer, status?: string[], after_date?: string, before_date?: string, custom_metadata?: object }
- `POST https://api.mcp.ai/api/gladia/list/pre/recorded/jobs` — Tool to list all pre-recorded transcription jobs matching the query parameters. Use when you need to retrieve a paginated list of transcription jobs with optional filtering by date, status, or custom 
  - body: { date?: string, limit?: integer, offset?: integer, status?: string[], after_date?: string, before_date?: string, custom_metadata?: object }
- `POST https://api.mcp.ai/api/gladia/upload/audio/video/file` — Upload an audio or video file to Gladia for speech-to-text transcription. Returns a URL that can be used with the pre-recorded transcription endpoint. Supports common audio formats (WAV, MP3, FLAC, OG
  - body: { file: object }

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

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