# Rev.com MCP > Rev.com MCP Server manages your entire professional transcription and captioning pipeline. Connect your AI client to read order metadata, list attached files, pull invoice details, and even create new jobs in natural conversation. Stop switching apps; manage media assets and billing directly through chat. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** transcription, captioning, speech-to-text, media-services, translation, accessibility ## Description **Rev.com MCP Server: Your Command Center for Media Workflows** Your AI client gives you full command over your entire professional transcription and captioning pipeline. You stop hopping between tabs; everything runs right here in the chat. This server lets your agent act like a dedicated media operations manager, handling everything from starting new jobs to getting final payment details. **Managing Order Lifecycle** You can start by using `list_orders` to pull up all transcription and captioning orders associated with your account in one go. If you need specific details on any single job, run `get_order` for the full metadata dump based on an order ID. You'll find that you can use `create_order` to submit a brand new request—whether it’s for transcription or captioning services—and kick off the whole workflow right from your prompt. If something goes sideways and you need to stop a job before it starts, run `cancel_order` on that specific order ID. **Tracking Progress & Status** You don't have to guess where things are at. You can use `get_order_progress` to check the real-time status of any active job and get an estimate of when you’ll see it done. When you need a deep dive into everything related to one order, run `get_order` again; this pulls all specific data points and metadata for that particular ID. **Monitoring Media Assets** When the files are attached, your AI client handles them. First, use `list_attachments` with an order ID to see every file associated with that job. If you need technical details about any of those media files—like its original format or size—you run `get_attachment_metadata`. Once the work is finished and the file is ready for review, you can pull the final text content directly using `get_attachment_content` from a completed transcript or caption file. **Accessing Financial Records & Profiles** Keeping tabs on billing is simple. You run `list_invoices` to get a list of all invoice numbers and basic summaries across your account history. To pull the full, detailed breakdown for one specific bill, use `get_invoice` with that number. For general operational checks, you can grab basic information about your connected Rev.com account user profile by using `get_user_profile`. This server groups these functions so you don't have to switch apps or copy/paste IDs everywhere. Your agent handles the whole orchestration in one conversation thread. ## Tools ### cancel_order Stops a specific transcription or captioning job that hasn't started yet. ### create_order Submits a new request for either transcription or captioning services, starting the workflow. ### get_attachment_content Pulls the final text content from a finished transcript or caption file for immediate review. ### get_attachment_metadata Retrieves technical details about an attached file, such as its original format or size. ### get_invoice Fetches all billing details for a single, specified invoice number. ### get_order Pulls all specific data points and metadata for one particular order ID. ### get_order_progress Checks the current status of a job, telling you how far along in the process it is. ### get_user_profile Retrieves basic information about your connected Rev.com account user profile. ### list_attachments Lists all files associated with a specific order ID, showing what's available. ### list_invoices Retrieves a list of invoice numbers and basic billing summaries for your account. ### list_orders Lists all transcription and captioning orders associated with your account in bulk. ## Prompt Examples **Prompt:** ``` List my last 5 orders in Rev.com. ``` **Response:** ``` I've retrieved your orders. Your last 5 include 'ORD-9912' (Complete), 'ORD-9913' (In Progress), and three others. Would you like to see the attachments for the in-progress order? ``` **Prompt:** ``` Show me all active transcription and captioning orders with their progress and delivery estimates. ``` **Response:** ``` 7 active orders. "Board Meeting Recording" (1:42:00): Transcription 78% complete, delivery: today 5 PM. "Product Demo Video" (0:23:00): Captioning in progress, 45% complete, delivery: tomorrow 10 AM. "Podcast Episode 47" (0:58:00): Translation to Spanish, 30% complete, delivery: Wednesday. "Training Series" (3 videos, total 2:15:00): Queued, starts processing in 2 hours. 3 additional caption orders at various stages. Total spend this month: $1,234. ``` **Prompt:** ``` Submit a new transcription order for a 45-minute investor call recording with timestamps. ``` **Response:** ``` Transcription order created: #ORD-8923. File: investor_call_may13.mp3 (45:12 duration). Service: Human transcription (99%+ accuracy). Options: Timestamps every 30 seconds, speaker identification (2 speakers detected), verbatim transcription. Turnaround: 24 hours (rush available for +50%). Estimated cost: $56.40 ($1.25/min). Output formats: DOCX, TXT, SRT. Order status: Processing. You'll receive an email when the transcript is ready for review. ``` ## Capabilities ### Manage Order Lifecycle List all managed orders and create new transcription or captioning requests using a single conversation prompt. ### Access Financial Records Retrieve detailed information about specific invoices or list your account's entire history of billing records. ### Monitor Media Assets List files attached to an order and pull the technical metadata for those media files, ensuring output quality checks. ### Track Progress & Status Check the real-time progress of any active transcription or captioning job, including estimated delivery times. ### Get User Info Retrieve your current account profile details for basic operational checks. ## Use Cases ### Audit last month’s expenses. The compliance team needs to reconcile Q2 spending. They prompt their agent: 'List my invoices from April.' The agent uses `list_invoices` and provides a clean list of invoice numbers and totals, eliminating the need to download and manually check multiple billing statements. ### Check if an order was canceled. A project manager realizes a recording is outdated. They ask their agent: 'Cancel job ORD-1234.' The agent uses `cancel_order`, confirms the status change, and alerts them to any associated cleanup steps. ### Prepare for an article deadline. A journalist needs the final transcript content immediately. They tell their agent: 'Give me the text for ORD-9912.' The agent uses `get_attachment_content` and pastes the entire, ready-to-use text into the chat. ### Review a pending job's files. The editor needs to verify what assets are available for an order. They prompt: 'What attachments exist for ORD-500?' The agent uses `list_attachments` and details every file ready for review, guiding the user on next steps. ## Benefits - Saves time by letting you list all orders with `list_orders`, eliminating the need to check job status in a separate dashboard. You get an instant overview of your entire content pipeline. - Controls your budget using `get_invoice` and `list_invoices`. Instead of hunting through PDF archives, your AI client pulls specific cost details right into the chat window. - Quickly verifies output quality by running `get_attachment_metadata`. You check technical file specs—like duration or format—without needing to download and open anything. - Streamlines content creation with `create_order`. Need a new job? Tell your agent, and it submits the request for you. No manual form filling required. - Keeps everything synchronized by using `get_order` and `get_order_progress`. You get the full history of an order's journey—from submission to completion—in one place. ## How It Works The bottom line is: Your AI acts as the single pane of glass for your entire professional media service account. 1. Subscribe to the server and provide your Rev.com Client Key and User Key in the configuration. 2. Ask your AI client a direct question (e.g., 'List my last 5 orders'). 3. The agent executes the correct tool call, receives structured data from Rev.com, and presents you with a natural language summary. ## Frequently Asked Questions **How do I list all my orders using the list_orders tool?** Use `list_orders` to get an initial list of all available job IDs. This gives you a quick overview and helps you identify which specific order ID you need more details on next. **What is the best way to check if a transcript is ready?** First, run `get_order_progress` using the job ID. If it shows 'Complete,' then proceed by calling `list_attachments` and finally `get_attachment_content`. **Can I get invoice details without knowing the full invoice number?** The `list_invoices` tool will give you a list of numbers and dates. Once you pick an ID from that list, you can then use `get_invoice` to pull all the detailed financial records. **How do I create a new job programmatically?** Use the `create_order` tool. You'll need to specify the media file details and whether you want transcription or captioning services, and it handles the submission for you. **How do I verify that my API keys are working correctly using the get_user_profile tool?** Run `get_user_profile` to confirm your account details. This action validates that both your Client Key and User Key are properly configured in your AI agent's environment, ensuring immediate connectivity. **Which tool should I use if I only need the file metadata, not the transcript content itself?** Use `get_attachment_metadata`. This function retrieves technical details about an attachment—like format, size, and creation date—without requiring a download of the full caption or transcript file. **What should I do if I try to use cancel_order on an order that is already finished?** The system will return an error detailing why cancellation isn't possible. Before calling `cancel_order`, you must check the specific status of the job using `get_order_progress` first. **If I have a specific Order ID, how do I get all its associated details in one place?** Use the `get_order(order_id)` tool. This retrieves comprehensive data for a single job—including service type, file duration, and current status—in one direct call. **Can my AI automatically find the status and attachments for a specific Rev order?** Yes! Use the `get_order` and `list_attachments` tools. Your agent will respond with complete metadata, including processing status and links to retrieved files in seconds. **How do I find my Rev.com Client Key and User Key?** Log in to your Rev.com account, navigate to the **Settings** or **API** section, and you will find your unique Client Key and User Key there.