# CloudConvert MCP for AI Agents AI Agent Connect > CloudConvert MCP lets you manage file conversions, track job statuses, and monitor account credits directly through your AI agent. It handles hundreds of formats like PDF, DOCX, and images without you needing to switch tabs or manual upload every time. ## Overview - **Category:** image-video - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_dWgNYBc1fB1isTktLb43Fnfa0ablMt2NwxHdVRwh/ai-agent-connect - **Tags:** file-conversion, multimedia-processing, pdf-tools, document-automation, format-transcoding, api-integration ## Description This Connector lets you run CloudConvert tasks directly through your AI client. You can tell your agent to turn a bunch of Word docs into optimized PDFs or convert video files into different formats while you keep working. It handles the heavy lifting of checking if a job finished, listing your recent history, or seeing if you're running low on credits. If you're building an automated pipeline, you can even have your agent watch for webhooks so you know exactly when a file is ready. It's one of the best ways to bridge the gap between your conversation and actual file processing, making the Vinkius catalog a powerhouse for media-heavy workflows. ## Tools ### list_tasks List all tasks ### cancel_job Cancel a conversion job ### create_simple_job Create a simple conversion job (URL to Output format) ### get_job Get details of a specific job ### get_task Get details of a specific task ### get_task_status Check the status of a specific task ### get_user Get current user profile and credits ### list_conversion_formats List supported conversion formats ### list_export_operations List supported export operations ### list_import_operations List supported import operations ### list_jobs List all conversion jobs ## Prompt Examples **Prompt:** ``` Check my CloudConvert credits. ``` **Response:** ``` Checking your account balance... | Account Info | | :--- | | **Remaining Credits:** 450 | | **Estimated Time:** ~450 minutes | You have plenty of credits left for your current projects. ``` **Prompt:** ``` Did my last job finish? ``` **Response:** ``` Checking the status of your last conversion... **Status:** ✅ Finished **Result:** Your file has been successfully converted. **Download Link:** [https://cloudconvert.com/download/example-file.pdf] ``` **Prompt:** ``` List my recent conversions. ``` **Response:** ``` Here are your 3 most recent conversion jobs: * **invoice-pdf** (Finished) * **profile-image-optimize** (Finished) * **video-transcode** (In Progress) ``` ## Capabilities ### Create conversion jobs Start a new file conversion or processing task for over 200 different formats. ### Check job status See if a conversion is finished, still running, or failed in real time. ### View account credits Check your current account info and see how many conversion minutes you have left. ### List recent history View a list of your latest file conversion jobs to find previous results. ### Monitor webhooks Track configured webhooks for notifications when jobs complete. ### List supported operations See which specific operations like optimization are supported by the API. ## Use Cases ### Batch Image Optimization A content creator has 50 images and needs them web-ready. They ask their agent to convert them all using `create_conversion_job`. ### Video Transcoding Audit A developer needs to know if a large video transcode finished. They ask the agent to check the status using `get_conversion_job_details`. ### Document Format Swapping An office worker wants to turn a DOCX into a compressed PDF. They tell the agent to do it, and it handles the conversion via the Connector. ### Quota Monitoring An automation specialist wants to know if they have enough credits for a big batch. They ask the agent to check `get_my_cloudconvert_profile`. ## Benefits - Handle over 200 formats by using `create_conversion_job` to turn files into whatever you need. - Stop refreshing your browser by using `get_conversion_job_details` to get instant status updates. - Keep track of your spending with `get_my_cloudconvert_profile` to see your remaining credit balance. - Automate your notifications by using `list_cloudconvert_webhooks` to monitor job completions. - Find previous files quickly by using `list_conversion_jobs` to see your recent history. ## How It Works The bottom line is you get a direct line to 200+ file formats without leaving your chat window. 1. Subscribe to the CloudConvert MCP on Vinkius. 2. Enter your CloudConvert API Key from your dashboard. 3. Ask your agent to convert files, check statuses, or monitor your credits. ## Frequently Asked Questions **Can I convert PDFs with CloudConvert MCP?** Yes, you can convert PDFs to many other formats like DOCX, TXT, or even images directly through your agent. **How many file types does CloudConvert MCP support?** It supports over 200 different file formats, covering images, documents, videos, and more. **Does CloudConvert MCP show my credit balance?** Yes, your agent can check your account profile to see exactly how many credits you have remaining. **How do I use CloudConvert MCP for webhooks?** You can have your agent monitor configured webhooks to get real-time notifications as soon as your file conversions are complete. **Can I check the status of a specific file conversion with CloudConvert MCP?** Absolutely. Your agent can pull the specific status and result of any job so you don't have to check the dashboard. **Is CloudConvert MCP good for batch processing?** It's excellent for batch work because you can create multiple jobs and have your agent track their progress for you. **Can I convert a document to PDF through the agent?** Yes! Use the `create_conversion_job` tool. You can define an import task for your file and a convert task with `output_format: 'pdf'`. The agent will handle the submission to CloudConvert. **How do I know when my conversion task is finished?** Use the `get_conversion_task_details` tool with your task ID. Your agent will return the current status, and once it shows 'finished', it will provide the download URL. **Where do I find my CloudConvert API Key?** Log in to your CloudConvert dashboard and navigate to **API v2 > API Keys**. You can generate and copy your personal API key from there. **How do I find my CloudConvert API Key?** Log in to your account, navigate to the **Dashboard**, click on **API** in the sidebar, and generate or copy your secret key. **Which formats are supported for conversion?** CloudConvert supports over 200 formats including PDF, DOCX, XLSX, MP4, MKV, MP3, JPG, PNG, and many more. **What is the 'Sandbox' mode?** The Sandbox is a testing environment that allows you to run conversion jobs for free. Note that files processed in Sandbox are not actual conversions.