# CloudConvert MCP MCP > CloudConvert manages files across 200+ formats. It lets your AI agent build complex, programmatic pipelines to convert anything—PDFs, videos, audio, images, and documents—from a public URL into a specified format. Stop manually uploading; start automating high-fidelity media processing from plain text commands. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** file-conversion, multimedia-processing, pdf-tools, document-automation, format-transcoding, api-integration ## Description Tired of file conversion bottlenecks? This MCP lets your AI agent handle the whole process: taking files from public links and converting them through dozens of formats (like turning an MKV video into an MP3 audio track, or a DOCX spec sheet into a PDF). You can build multi-step jobs—importing data, running conversions, and getting secure download links for the finished assets. If your work involves moving files between different media types, this is what you need. For example, instead of manually checking if an asset conversion succeeded, your agent can use its tools to track job status in real time. This capability helps build automations that span multiple platforms; you could chain this file processing MCP with a CRM MCP and then send the resulting document via a messaging MCP through one AI agent. And when it comes to security, Vinkius handles all of it inside an isolated sandbox, meaning your credentials are used only in transit—they never sit on disk. ## Tools ### cancel_job Stops a conversion job that is currently running or stuck in the queue. ### create_simple_job Starts basic conversions by sending a source URL and defining the required output format. ### get_job Retrieves comprehensive details about a specific job, including its current status and history. ### get_task Gets detailed information for one specific task within a larger conversion pipeline. ### get_task_status Checks the current, real-time status of an individual processing task. ### get_user Retrieves your account details, including profile information and how many conversion credits you have left. ### list_conversion_formats Lists every single input and output file format that the system supports for conversion. ### list_export_operations Shows all available methods or operations used to export final converted files. ### list_import_operations Lists the various ways files can be imported into the conversion system, such as from URLs. ### list_jobs Provides a list of all conversion jobs you've initiated or that are currently pending. ### list_tasks Lists individual tasks associated with your historical and current conversion jobs. ## Prompt Examples **Prompt:** ``` Convert the DOCX file at 'https://example.com/spec.docx' to PDF. ``` **Response:** ``` Conversion job triggered! I've started the process to convert your DOCX specification into a high-fidelity PDF. The job ID is 'job_123'. I'll retrieve the secure download link for you once it's ready. ``` **Prompt:** ``` List my last 5 conversion jobs and their statuses. ``` **Response:** ``` I've retrieved your recent jobs. Highlights include a successful MP4 to MKV conversion (ID: job_402) and two completed PDF exports. Would you like the download links for any of these finalized files? ``` **Prompt:** ``` Check my remaining CloudConvert credits. ``` **Response:** ``` Scanning account... You currently have 1,240 conversion credits remaining in your profile. Your connection is active and healthy. Need help starting a new high-fidelity media conversion? ``` ## Capabilities ### Track Job Status Check the live status and detailed progress of any running conversion job or task. ### Initiate Conversions Start new, simple conversions by providing a source URL and specifying the target output format. ### Manage Conversion Pipelines Create and oversee complex jobs that run multiple tasks in sequence, coordinating high-fidelity processing steps. ### Review Account Details Pull your current user profile details and view remaining conversion credits before starting a job. ### List Available Formats See a full directory of all supported input, output, and export formats to plan the perfect conversion strategy. ## Use Cases ### Need to update a client presentation? A marketing director needs to take a single master Word document and convert it into three different formats: PDF for legal review, JPG for the website, and MP4 video of the slides. The agent uses `list_conversion_formats` first, then triggers multiple conversions using `create_simple_job`, tracking completion via `get_task_status` until all assets are ready. ### Migrating old media archives? An archivist has a folder of old MKV videos and needs them converted into modern, web-friendly MP4 files. They instruct the agent to create a complex job using `list_import_operations` and then monitor progress by calling `get_job` until all assets are successfully exported. ### Building an automated reporting pipeline? The finance team wants to take daily Excel reports (XLSX) from a public URL, convert them into clean PDF summaries, and then trigger another process. The agent uses `create_simple_job` for the conversion, and if it fails, the user can immediately use `get_task` to pinpoint which step broke. ### Debugging a failed batch job? A developer runs a large list of conversions that fail. Instead of guessing, they ask the agent to run `list_jobs` and then focus on specific failures by calling `get_task_status` for the problematic task ID. ## Benefits - Start with simple, one-off tasks using `create_simple_job` and instantly convert a URL's content to any format you specify. No manual uploading needed. - Build complex pipelines by managing multi-stage jobs; use tools like `get_task` and `list_tasks` to coordinate high-fidelity processing flow from import through export. - Never wonder if your files are ready again. Use `get_task_status` to check the real-time status of any conversion, letting your agent know exactly when a job is done. - Understand your limits before you start. Quickly check your remaining credits and profile data using `get_user`, preventing unexpected spending. - Don't get stuck on formats. Use `list_conversion_formats` to see the full directory of supported file types, ensuring your conversion strategy is perfect upfront. ## How It Works The bottom line is you talk to your AI client in natural language; the MCP handles the complex job orchestration behind the scenes. 1. Get your API key from the CloudConvert dashboard and set the 'Use Sandbox' option to true for testing. 2. Connect this MCP to any compatible AI client (like Claude or Cursor) through Vinkius. 3. Tell your agent exactly what you need, like: 'Take this public URL file and convert it to MP3 format.' The agent manages the rest. ## Frequently Asked Questions **How do I start a conversion job with create_simple_job?** You give the agent a public URL and specify both the source file type and the desired output format. The system handles creating the simple job for you. **What is get_task_status used for?** It checks the current, immediate status of one specific task within a larger conversion pipeline. This is useful if you need to know exactly where in a multi-step process things are running. **Can I see all my past jobs using list_jobs?** Yes, `list_jobs` gives you a summary of every conversion job you've ever initiated or that is currently waiting. It’s your historical record of work. **Do I need to use get_user before converting files?** It’s good practice, but not mandatory for the conversion itself. Running `get_user` first lets you check your remaining credits and confirm that your account connection is healthy. **What if I need to stop a job midway? Should I use cancel_job?** Absolutely, yes. If a job stalls or the requirements change mid-process, calling `cancel_job` stops it cleanly so you don't waste credits. **What does get_task give me about a specific task's internal workings?** It provides granular details on a single conversion component. You can pull metadata that goes beyond simple status checks, letting you see the exact input and output parameters used for that specific stage of work. **Before starting a job, how do I check available format options using list_conversion_formats?** You call this tool to pull the complete directory of supported file types. This lets you verify if your input or target formats are compatible before writing a conversion request. **If a job has multiple steps, how does list_tasks help me monitor them individually?** It gives you a comprehensive listing of every individual task associated with your account. This is useful for debugging or monitoring complex pipelines that are broken down into several distinct operations.