How to integrate Cloudconvert MCP with Atomic Agent

Connect Atomic Agent to Cloudconvert MCP. Convert a pdf to word document format, export a converted file directly to s3, and more using natural language, with authentication handled for you.

Cloudconvert logoCloudconvert
Api Key

CloudConvert is a powerful file conversion service supporting over 200 file formats. It streamlines converting, compressing, and managing documents, media, and more, all in one place.

9 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Cloudconvert.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Cloudconvert account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Cloudconvert with

How Atomic Agent connects to Cloudconvert

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Cloudconvert to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Cloudconvert. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Cloudconvert account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Cloudconvert MCP server, and what's possible with it?

The Cloudconvert MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your CloudConvert account. It provides structured and secure access to your file conversion workflows, so your agent can perform actions like converting files, exporting results to cloud storage, managing webhooks, and exploring supported formats on your behalf.

  • Seamless file conversion: Ask your agent to convert documents, images, audio, video, spreadsheets, or presentations between hundreds of supported formats automatically.
  • Automated export to cloud storage: Direct your agent to export converted files directly into your Google Cloud Storage or Amazon S3 buckets, streamlining storage and distribution.
  • Format discovery and optimization: Have the agent list all supported conversion formats, engines, and options, so you can choose the best settings for your needs.
  • Webhook management: Let your agent create, list, or delete webhooks to receive real-time notifications about conversion events and automate downstream processes.
  • Task tracking and user info: Retrieve detailed task histories, filter by status or date, and confirm the authenticated user’s account details for secure operations.

Use Cloudconvert from Atomic Agent

With your account connected, ask Atomic Agent to work with Cloudconvert in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Cloudconvert action and event your agent gets out of the box.

Create Export Google Cloud Storage Task

Tool to create a task to export files to a Google Cloud Storage bucket.

Create Export S3 Task

Tool to create a task to export files to an Amazon S3 bucket.

Create Webhook

Creates a new webhook to receive CloudConvert event notifications.

Delete Webhook

Permanently delete a webhook by its ID.

List Operations

Tool to list all possible CloudConvert operations with their available options and engine details.

List Supported Formats

Tool to list all supported conversion formats, engines, and options.

List Tasks

List a page of CloudConvert tasks, with filters including status and job ID.

List Webhooks

List a page of existing webhooks, optionally filtered by URL, for inspection or management.

Show User

Retrieves the current authenticated user's CloudConvert account information.

FAQ

Frequently asked questions

Start with Cloudconvert.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Cloudconvert tool your agent needs.Free to start.

Start building