# CloudConvert MCP for AI Agents MCP > CloudConvert handles complex file conversions and processing jobs programmatically. Connect this MCP to automate format transformations for over 200 types, including PDF, DOCX, images, and video. You can track job status, manage conversion quotas, and run full workflows directly from your AI client. ## Overview - **Category:** ship-it - **Price:** Free - **Tags:** file-conversion, format-transformation, document-processing, media-processing, automation, api-integration ## Description This connector lets you take full control of file processing without leaving your chat interface. Forget manually uploading files to a web dashboard just to check if they finished converting or optimizing. Instead, you talk to your agent, tell it what files you need transformed—whether it’s turning a PDF into editable text or transcoding a video clip—and the MCP handles the rest. It gives your AI client visibility across the entire conversion process. You can list all recent jobs, check the status of individual tasks, and even retrieve details about your account credits. If you're building an automated system, this integration lets you monitor webhooks for real-time job completion notifications. Because it works with any MCP-compatible client via Vinkius, integrating complex file logistics is simple; just connect once to access all the power. ## Tools ### create_conversion_job Starts a new file conversion or processing job supporting over 200 formats. ### get_conversion_job_details Checks the current status and final results for any specific conversion job ID. ### get_my_cloudconvert_profile Retrieves details about your user account, including how many remaining service credits you have. ### get_conversion_task_details Gets detailed information for a single processing task within a job. ### list_conversion_jobs Lists all conversion jobs that were recently processed or are currently active. ### list_available_conversion_ops Provides a list of common, supported file operations like optimization and website capture. ### list_conversion_tasks Lists all individual tasks that make up the various conversion jobs. ### list_cloudconvert_webhooks Shows which webhooks are configured to send real-time notifications upon job completion. ## Prompt Examples **Prompt:** ``` Can you convert these 15 research papers into editable Word documents and optimize them for viewing? ``` **Response:** ``` **Job Status: In Progress** We've started the batch job. The system is handling format conversion (PDF to DOCX) and applying image optimization. * ✅ **Task 3/15:** Finished. Result available here: [Download Link] * ⏳ **Task 4/15:** Processing... Expected completion in minutes. Please wait a moment, and I'll check the overall job status for you. ``` **Prompt:** ``` How many credits do I have left? And what are my most recent conversion jobs? ``` **Response:** ``` **Account Summary** You currently have 450 credits remaining. This is enough for approximately two days of moderate processing. **Recent Jobs:** * `video-transcode`: Status: Finished (2 hours ago) * `image-optimize`: Status: Finished (Yesterday) * `pdf-to-docx`: Status: Failed (Error code 403 – Check file permissions) ``` **Prompt:** ``` I need to know all the available operations for my images and documents. ``` **Response:** ``` CloudConvert supports a wide variety of advanced operations. Here are some common ones you can add during job creation: * **Optimization:** Resizing, compression, format adjustment. * **Capture:** Turning websites into downloadable files. * **Advanced Processing:** Includes specific tools for PDFs and complex document types. You can run a new job that combines these actions seamlessly. ``` ## Capabilities ### Start a new conversion or processing job Creates a multi-format job for transforming files using over 200 supported formats. ### Get the status of an entire job Retrieves the overall result and current status details for a specific conversion job ID. ### Monitor individual task progress Checks detailed information, including status and results, for any single processing task within a larger job. ### List all recent jobs Gathers a list of your most recently processed conversion jobs for quick auditing. ### Manage user account details and credits Retrieves information about the authenticated user profile, including remaining service credits. ### List available operations Shows which common file optimization or processing actions are supported by the API. ### Monitor configured webhooks Lists your setup for receiving real-time notifications when jobs complete. ## Use Cases ### Bulk optimizing assets for a website launch A content creator needs to take 50 raw PNG files, optimize them, and convert the batch into web-ready JPGs. They ask their agent to run `create_conversion_job` specifying the input types and output formats. The MCP executes the job, saving hours of manual resizing and format changes. ### Auditing a large corporate document migration A developer is migrating old client documents. They run `list_conversion_jobs` to check every conversion attempt for accuracy. If one fails, they use `get_conversion_job_details` to pinpoint the exact failure point and fix it programmatically. ### Managing a video content pipeline A marketing team needs multiple video versions (16:9 for YouTube, 9:16 for Stories). They use `create_conversion_job` to batch transcode the master file into all required aspect ratios simultaneously. The agent tracks progress using task details until every version is ready. ### Verifying webhook delivery for external systems An automation specialist needs confirmation that their third-party system can receive job completion notices. They use `list_cloudconvert_webhooks` to verify the endpoint setup and test if real-time notifications are configured correctly. ## Benefits - Automation of complex workflows: Don't manually handle file types. Use `create_conversion_job` to run jobs that transform hundreds of formats—from PDF to DOCX, or image optimization—in a single prompt. - Real-time job oversight: Need to know if the video transcoding finished? Call `get_conversion_task_details` to check specific task statuses and results instantly, eliminating dashboard waiting time. - Centralized account management: Use `get_my_cloudconvert_profile` to query your remaining credits. You always know how much processing power you've left without logging into another site. - Comprehensive job history: Instead of scrolling through endless tabs, run `list_conversion_jobs` and get a clean summary of all recent file transformations for audit purposes. - Flexible workflow setup: Use the MCP to monitor configured webhooks via `list_cloudconvert_webhooks`, allowing your agent to react instantly when a job finishes processing. - Visibility into operations: Need to know what's possible? Run `list_available_conversion_ops` to see all supported file enhancements and optimization types. ## How It Works The bottom line is that you use this MCP through your AI client to manage complex multi-format conversions without needing to open a separate dashboard. 1. Subscribe to this MCP and provide your CloudConvert API Key in the client's settings. 2. Your AI client sends a natural language request, specifying the file types and desired output formats. 3. The MCP executes the conversion job, providing status updates and final results directly back to your conversation thread. ## Frequently Asked Questions **How do I use the CloudConvert MCP to convert files through my AI agent?** Simply connect this MCP via Vinkius and ask your agent. You tell it the source file types and the desired destination formats, and the agent handles initiating the job for you. **Can the CloudConvert MCP handle large batches of files?** Yes. It's designed for batch processing. You can run jobs that process dozens or even hundreds of files at once, making it ideal for content creators and developers. **What if a conversion job fails? Can the MCP help me debug it?** Absolutely. The MCP allows you to check the detailed status of any specific task or job failure using dedicated tools. It pinpoints exactly where and why the process broke. **Is this only for documents, or can I convert media files too?** It handles much more than just documents. You can optimize images (PNG, JPG) and transcode videos into different formats, making it a comprehensive media processor.