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

Connect your Rev AI account and use 11 tools for artificial intelligence straight from your AI agent. Connect with your own API key. Rev AI provides advanced machine learning and speech recognition services for converting audio and video to text.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/rev_ai/delete/custom/vocabulary` — Tool to delete a completed custom vocabulary and its data. Use when you need to remove an unused vocabulary after confirming it's no longer needed.
  - body: { id: string }
- `POST https://api.mcp.ai/api/rev_ai/delete/job/by/id` — Tool to delete a completed transcription job and its data. Use when you need to permanently remove a finished job after confirming it's no longer needed.
  - body: { id: string }
- `POST https://api.mcp.ai/api/rev_ai/get/account` — Tool to retrieve developer account details. Use after authenticating with Rev AI.
- `POST https://api.mcp.ai/api/rev_ai/get/captions` — Tool to retrieve captions (SRT or VTT) for a completed Rev.ai transcription job. Use after confirming the job status is 'completed'.
  - body: { accept?: string, job_id: string, channel_id?: integer }
- `POST https://api.mcp.ai/api/rev_ai/get/custom/vocabulary/details` — Tool to retrieve custom vocabulary processing details. Use when needing to fetch the status and submitted phrases for a specific custom vocabulary after creation.
  - body: { id: string }
- `POST https://api.mcp.ai/api/rev_ai/get/job/by/id` — Tool to fetch details of a transcription job by its ID. Use when confirming job status and metadata are accurate.
  - body: { id: string }
- `POST https://api.mcp.ai/api/rev_ai/get/list/of/jobs` — Tool to get list of transcription jobs from the past 30 days. Use when you need to retrieve and paginate through recent transcription tasks.
  - body: { limit?: integer, ending_before?: string, starting_after?: string }
- `POST https://api.mcp.ai/api/rev_ai/get/transcript/by/id` — Tool to retrieve the transcript of a completed Rev.ai job. Use after confirming job is complete. Supports JSON format (with timestamps and speaker info) or plain text format.
  - body: { id: string, accept?: string }
- `POST https://api.mcp.ai/api/rev_ai/start/stream/transcription` — Tool to start a WebSocket transcription stream. Use when you need real-time speech-to-text streaming via Rev.ai.
  - body: { language?: string, metadata?: string, priority?: string, start_ts?: number, transcriber?: string, content_type: string, filter_profanity?: boolean, detailed_partials?: boolean, remove_disfluencies?: boolean, skip_postprocessing?: boolean, custom_vocabulary_id?: string, delete_after_seconds?: integer, enable_speaker_switch?: boolean, max_connection_wait_seconds?: integer, max_segment_duration_seconds?: integer }
- `POST https://api.mcp.ai/api/rev_ai/submit/custom/vocabulary` — Tool to submit a custom vocabulary for improved speech recognition. Use when you want to process domain-specific terms asynchronously.
  - body: { phrases: string[], metadata?: string, custom_vocabulary_id?: string }
- `POST https://api.mcp.ai/api/rev_ai/submit/transcription/job` — Tool to submit a new transcription job. Use when you have a media URL or file bytes ready for async processing.
  - body: { file?: string, language?: string, metadata?: string, media_url?: string, callback_url?: string, filter_profanity?: boolean, skip_diarization?: boolean, skip_punctuation?: boolean, custom_vocabularies?: object[], delete_after_seconds?: integer, transcription_config?: object, speaker_channel_count?: integer }

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

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