# CloudConvert — how to use (mcp.ai)

Connect your CloudConvert account and use 9 tools for file management and storage straight from your AI agent. Connect with your own API key. CloudConvert is a file conversion service supporting over 200 formats, including audio, video, document, ebook, archive, image, spreadsheet, and presentation formats.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_cloudconvert?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `cloudconvert_create_export_google_cloud_storage_task`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/cloudconvert`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/cloudconvert/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/cloudconvert/create/export/google/cloud/storage/task` — Tool to create a task to export files to a Google Cloud Storage bucket. Use after conversion when you need to store results directly into GCS. Ensure service account credentials have the proper permis
  - body: { file?: string, input: string|string[], bucket: string, project_id: string, file_prefix?: string, private_key: string, client_email: string }
- `POST https://api.mcp.ai/api/cloudconvert/create/export/s3/task` — Tool to create a task to export files to an Amazon S3 bucket. Use after conversion when you need to store results directly into S3. Ensure AWS credentials have s3:PutObject (and PutObjectAcl if using 
  - body: { acl?: string, key?: string, input: string|string[], bucket: string, region: string, tagging?: object, endpoint?: string, metadata?: object, key_prefix?: string, content_type?: string, access_key_id: string, cache_control?: string, session_token?: string, secret_access_key: string, content_disposition?: string, server_side_encryption?: string }
- `POST https://api.mcp.ai/api/cloudconvert/create/webhook` — Creates a new webhook to receive CloudConvert event notifications. Use this when you need to be notified about job status changes (created, finished, or failed) via HTTP POST requests to your server.
  - body: { url: string, event: string, payload?: object, signing_secret?: string }
- `POST https://api.mcp.ai/api/cloudconvert/delete/webhook` — Permanently delete a webhook by its ID. Use this when you no longer need to receive event notifications for a specific webhook. The webhook ID can be obtained from the create_webhook or list_webhooks 
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/cloudconvert/list/operations` — Tool to list all possible CloudConvert operations with their available options and engine details. Use when you need to discover what operations are available, check operation requirements, or filter 
  - body: { include?: string, filter_input_format?: string, filter_output_format?: string }
- `POST https://api.mcp.ai/api/cloudconvert/list/supported/formats` — Tool to list all supported conversion formats, engines, and options. Use when you need to discover available conversions before creating tasks.
  - body: { include?: string[], alternatives?: boolean, filter_engine?: string, filter_input_format?: string, filter_output_format?: string, filter_engine_version?: string }
- `POST https://api.mcp.ai/api/cloudconvert/list/tasks` — List all CloudConvert tasks with their status, payload and results. Use this tool to: - Monitor conversion task progress and status - Find tasks by status (waiting, processing, finished, error) - Filt
  - body: { page?: integer, job_id?: string, status?: string, include?: string, order_by?: string, per_page?: integer, operation?: string, created_at?: string, completed_at?: string }
- `POST https://api.mcp.ai/api/cloudconvert/list/webhooks` — Tool to list all webhooks. Use when you need to retrieve existing webhooks before managing or inspecting them.
  - body: { page?: integer, per_page?: integer, filter_url?: string }
- `POST https://api.mcp.ai/api/cloudconvert/show/user` — Retrieves the current authenticated user's CloudConvert account information. Returns the user's ID, username, email, remaining conversion credits, and account creation date. Requires the 'user.read' s

## Example prompts
- "What can I do in CloudConvert?"
- "Show me a summary of my CloudConvert account"

## More
- Page: https://mcp.ai/cloudconvert
- Agent spec (llms.txt): https://mcp.ai/cloudconvert/llms.txt
- Postman collection: https://mcp.ai/cloudconvert/postman.json