# Ebby MCP MCP > Ebby connects your AI agent to a full audio and video transcription platform. You can list, check status, and retrieve transcribed text from any media file. This MCP lets you manage all aspects of speech-to-text data—from auditing account usage to getting structured captions (SRT) or simple plain text. It turns raw sound into actionable content. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** transcription, subtitling, speech-to-text, audio-processing, video-editing, natural-language ## Description Ebby handles the heavy lifting for transcribing audio and video files automatically. Instead of dealing with clunky web dashboards, you manage your entire media library right through conversation. You can list all existing transcription projects to see what's ready or still processing. Need to know how much time is left on your account? Ask, and it gives you the metadata instantly. Once a file is done, you don't have to download anything; your agent pulls the transcribed text directly into your chat window in whatever format you need—plain text, SRT captions, or even identifying which speaker said what. This makes content analysis simple. By connecting this MCP via Vinkius, you get all of Ebby’s power integrated with any compatible AI client, letting your agent perform deep dives into the media data without ever leaving your workspace. ## Tools ### get_ebby_account_metadata Retrieves general usage limits and key details for your Ebby account. ### get_transcription_text Pulls the plain text content from a specific transcript for immediate use. ### quick_transcription_volume_audit Provides a quick summary of your overall transcription activity and processing rates. ### get_transcription_details Gets the specific settings, file type, and current status of one transcription job. ### list_successfully_processed_audio Finds transcriptions that are done and ready for you to export or use. ### list_in_progress_transcriptions Identifies which transcriptions are currently being processed and what their current status is. ### list_latest_transcriptions Shows a list of the most recently created or updated transcription projects. ### list_transcription_speakers Lists all the speakers identified in a specific transcription, noting who said what. ### list_audio_transcriptions Shows a list of every transcription project you have started in Ebby. ### search_transcriptions_by_name Searches for specific transcriptions using keywords from the file title or name. ## Prompt Examples **Prompt:** ``` List all completed transcriptions. ``` **Response:** ``` I've found 8 completed transcriptions, including 'Interview_John_Doe.mp3' and 'Q2_Board_Meeting.mp4'. Both are ready for export. Would you like to retrieve the text for the Interview? ``` **Prompt:** ``` Show me the transcribed text for 'Interview_John_Doe.mp3' in SRT format. ``` **Response:** ``` I've retrieved the SRT captions for 'Interview_John_Doe.mp3'. The file includes timestamps and identified speakers. Would you like the full JSON output or just a preview of the first few lines? ``` **Prompt:** ``` Check how many minutes are remaining in my Ebby account. ``` **Response:** ``` Your Ebby account has 150 transcription minutes remaining. Your current plan is 'Pro Monthly' and your next renewal is on April 15th. Should I list the most recent files currently in progress? ``` ## Capabilities ### Check and list all transcriptions See a complete record of every audio or video project you've created. ### Monitor processing status Track whether a file is currently being transcribed, how long it will take, and check its language settings. ### Extract text content by file name Get the full written transcript for a specific media file directly into your chat. ### Identify speakers in transcripts List which person spoke what, giving you speaker labels for better context. ### Audit account usage and limits Retrieve high-level metrics about your Ebby account, like remaining minutes or total activity. ## Use Cases ### Analyzing long-form interviews A journalist has 12 hours of interview footage. Instead of reviewing it in chunks, they ask their agent to `list_audio_transcriptions` to find everything done, then use `get_transcription_text` on the finished files. This gets them all the raw copy-paste text needed for a feature article in minutes. ### Tracking project volume An operations manager needs to know if they have budget left. They ask the agent to `quick_transcription_volume_audit` and immediately see their remaining account balance without navigating multiple billing pages. ### Extracting key quotes from meetings A researcher wants to find all comments made by a specific person in a large recorded meeting. They use `list_transcription_speakers` and then ask the agent to filter for that speaker's dialogue. ### Finding status updates on multiple files A video team needs to know which of their 20 new videos are done. They run `list_in_progress_transcriptions` and get a clean, actionable list telling them exactly what's still waiting in the queue. ## Benefits - Never manually copy-paste transcripts again. You can use `get_transcription_text` to pull clean, formatted text directly from the file and send it right to your chat window. - Keep track of every media file's lifecycle. By calling `list_audio_transcriptions`, you get a single view of everything—from files waiting for processing to those ready for export. - Need context? The ability to call `list_transcription_speakers` means your agent knows who said what, which is essential when analyzing interviews or panel discussions. - Audit your usage without logging into the main platform. Use `quick_transcription_volume_audit` and `get_ebby_account_metadata` to check remaining minutes instantly. - Find files fast. Instead of scrolling through hundreds of records, use `search_transcriptions_by_name` to narrow down your list using just a keyword or part of the title. ## How It Works The bottom line is that your AI client uses this MCP as an API wrapper to execute complex content operations without needing manual logins or file transfers. 1. First, connect the Ebby MCP to your AI client and provide your API key. 2. Next, ask your agent what you want to do—for example, 'List all completed transcriptions' or 'Get the text for X file.' 3. The agent sends a request through this MCP, retrieves the required data (text, status, metadata), and presents it back to you in plain conversation. ## Frequently Asked Questions **How do I check if my audio file is ready using get_transcription_details?** Use `get_transcription_details` to fetch the specific status of a transcription. This tool gives you detailed settings, confirming if the job is 'completed' or still 'in progress,' so you know when it’s safe to ask for the text. **What should I use to see all my project files?** You need `list_audio_transcriptions`. This tool gives a comprehensive record of every single media file you've run through Ebby, making it easy to track your entire history. **Can I get speaker labels from the transcripts?** Yes. Use `list_transcription_speakers` on the finished transcript. This tells you exactly which person was speaking at any point in the recording, making it useful for analyzing group discussions. **How do I find my account usage limits?** Call `get_ebby_account_metadata`. This tool quickly retrieves your overall usage limits and important data points about your Ebby plan without needing to log into the billing section. **What information do I need to use when calling the `get_ebby_account_metadata` tool?** You must provide your Ebby API Key and associated account credentials. The agent uses these secure tokens to authorize access, allowing you to retrieve high-level summaries of usage and organizational settings. **When I use `get_transcription_text`, what file formats can the transcribed content be delivered in?** The tool supports retrieving text in multiple standard formats. You can request plain TXT, time-coded SRT captions, or VTT files depending on your project's needs and required output type. **How do I check for transcriptions that aren't finished yet using `list_in_progress_transcriptions`?** This tool identifies every file currently waiting in the queue or actively being processed. It provides real-time status updates, including job duration and language settings, helping you monitor progress until completion. **If I only know the title, how can I find a transcription using the `search_transcriptions_by_name` tool?** You simply provide the keyword or filename to your agent. This searches Ebby's records directly and lets you pinpoint specific projects without having to list out every single file in your account. **How do I get an Ebby API Key?** Log in to your Ebby account, navigate to **Settings > API**, and you can generate or retrieve your unique API Key from there. Ensure you have available minutes in your balance. **What export formats are supported?** Ebby supports exporting transcriptions in various formats including Plain Text (txt), Subtitles (srt, vtt), and Microsoft Word (docx). You can specify the format using the get_transcription_text tool. **Can the agent upload new audio files?** This integration currently focuses on listing, auditing, and retrieving text for existing transcriptions. Uploading and starting new transcription jobs should be managed via the Ebby web interface.