← All integrations

CloudConvert MCP server

17 operations0 webhooks

Create, wait for, inspect, list and delete CloudConvert jobs and tasks; cancel or retry tasks; create GCS/S3 export jobs; discover operations and formats; and view account credits with API-key authentication. Job-level webhook fields are not exposed. See https://cloudconvert.com/docs/api-reference/jobs and https://cloudconvert.com/docs/api-reference/tasks.

Use CloudConvert in Claude, ChatGPT, Cursor or another MCP client

Connect CloudConvert once in Corsair, then add one MCP address to your agent.

Connect CloudConvert
Setup steps for Claude, ChatGPT, Cursor and Claude Code

Building your own app on the Corsair SDK? Get API keys

Try CloudConvert with your agent

Connect CloudConvert, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.

Using Corsair, show me what you can do in CloudConvert on my account, then run one read-only example and show me the result.

Runs once, when you ask

CloudConvert tools and triggers

Tools are what your agent can do in CloudConvert through Corsair's MCP server. Triggers are the CloudConvert events a routine can start from.

Tasks

  • CancelWrite

    Cancel a task that is waiting or processing. Docs: https://cloudconvert.com/docs/api-reference/tasks#cancel-task

    tasks.cancel

  • Create Export Google Cloud StorageDestructive

    Create a Google Cloud Storage export task in a new job; CloudConvert task creation is part of POST /jobs. Docs: https://cloudconvert.com/docs/import-export/export-files#google-cloud-storage and https://cloudconvert.com/docs/api-reference/jobs#create-job

    tasks.createExportGoogleCloudStorage

  • Create Export S3Destructive

    Create an S3 export task in a new job; CloudConvert task creation is part of POST /jobs. Docs: https://cloudconvert.com/docs/import-export/export-files#s3 and https://cloudconvert.com/docs/api-reference/jobs#create-job

    tasks.createExportS3

  • GetRead-only

    Get task status and optionally include retries, dependencies, payload and parent job. Docs: https://cloudconvert.com/docs/api-reference/tasks#show-task

    tasks.get

  • ListRead-only

    List and filter CloudConvert tasks with page-based pagination. Docs: https://cloudconvert.com/docs/api-reference/tasks#list-tasks

    tasks.list

  • RemoveDestructive

    Delete a task, including its data. Docs: https://cloudconvert.com/docs/api-reference/tasks#delete-task

    tasks.remove

  • RetryDestructive

    Create a new task using the payload of an existing task. Docs: https://cloudconvert.com/docs/api-reference/tasks#retry-task

    tasks.retry

  • WaitRead-only

    Wait for task completion on CloudConvert’s synchronous API. Prefer tasks.get for long-running work because clients and network stacks may time out. Docs: https://cloudconvert.com/docs/api-reference/tasks#wait-for-task

    tasks.wait

Formats

  • List SupportedRead-only

    List supported conversion formats, engines, options and engine versions through CloudConvert GET /operations. Docs: https://cloudconvert.com/docs/api-reference/operations#list-operations

    formats.listSupported

Operations

  • ListRead-only

    List available CloudConvert operations, formats, engines and options. Docs: https://cloudconvert.com/docs/api-reference/operations#list-operations

    operations.list

Users

  • ShowRead-only

    Read the authenticated CloudConvert user and remaining credits. Docs: https://cloudconvert.com/docs/api-reference/users#show-user

    users.show

Jobs

  • CreateDestructive

    Create an asynchronous job from a task graph. CloudConvert limits job task names to alphanumeric characters, hyphens and underscores, with at most 2000 tasks. Docs: https://cloudconvert.com/docs/api-reference/jobs#create-job

    jobs.create

Connect CloudConvert to Claude, ChatGPT or Cursor

  1. 1

    Connect CloudConvert in Corsair

    Add your CloudConvert API key once in Corsair. Corsair stores the credential encrypted and makes the CloudConvert API calls for your agent, so it never goes into a prompt or a config file. Connect CloudConvert

    If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs CloudConvert. On a ChatGPT personal plan, connect CloudConvert here first.

  2. 2

    Add Corsair's MCP server to your agent

    Every client uses the same address:

    https://mcp.corsair.dev/mcp
    Open Customize → Connectors → Add custom connector, paste the address, then select Connect.

    Codex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client

  3. 3

    Sign in and choose what needs your approval

    Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, CloudConvert's read and write operations run right away and its 7 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.

FAQ

Install corsair and @corsair-dev/cloudconvert, add the CloudConvert plugin, and connect with an API key. Then call methods like corsair.cloudconvert.api.formats.listSupported() from your app. Corsair keeps each tenant isolated.

Yes. CloudConvert requires an API key from your CloudConvert account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.

Yes. One Corsair client can hit CloudConvert, GitHub, Notion, Stripe, and the rest. Trigger CloudConvert from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.

Teams use Corsair for create, wait for, inspect, list and delete CloudConvert jobs and tasks; cancel or retry tasks; create GCS/S3 export jobs; discover operations and formats; and view account credits with API-key authentication. Job-level webhook fields are not exposed. See https://cloudconvert.com/docs/api-reference/jobs and https://cloudconvert.com/docs/api-reference/tasks. Common builds include sync jobs, admin tooling, and agents that call CloudConvert APIs from your backend.

The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per CloudConvert API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.

We maintain @corsair-dev/cloudconvert in the open repo. When CloudConvert ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.

No. Corsair does not read your CloudConvert data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store CloudConvert data on your behalf.

Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.

Yes. Put CloudConvert on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 7 destructive CloudConvert operations. You can change a link's mode at hub.corsair.dev/me.