Convert.Online
Convert files between 400+ formats — images, video, audio, documents, ebooks, fonts and CAD — from inside a conversation. Connects over OAuth or an API key.
Hosted MCP Server
npx add-mcp 'https://mcp.convert.online'Installs into Claude Code, Codex, Cursor and more
Documentation
Connect Convert.Online to your AI assistant. Once connected, it converts files for you — no copy-pasting, no leaving the chat.
Model Context Protocol (Streamable HTTP), with OAuth or an API key. Verified with Claude; any MCP-compatible client connects the same way.
What your assistant can do
list_formats Discover which formats can convert to which.
list_options The settings a given conversion accepts — quality, size, codecs.
create_upload Send a file from your own device, when it is not on the web.
convert Convert a file and get a download link back.
get_job Check a conversion's status and fetch its result.
Connect your AI assistant
Recommended · one-click (OAuth)
In your assistant, add a custom connector (sometimes called an MCP server) and paste the URL:
https://mcp.convert.online
Click Connect. The assistant sends you here to Convert.Online, you sign in and press Allow, and you're connected — nothing to copy or paste. Conversions then run on your account. You can revoke the connection anytime from your dashboard.
No API key to handle. With OAuth the assistant never sees your password or a key — it receives a token only after you approve it here, and only for the access shown on the approval screen.
Alternative · API key (config-file clients)
Clients set up from a config file can authenticate with an API key from Dashboard → API Keys instead. For example, in Claude Desktop open Settings → Developer → Edit Config and add (replace YOUR_API_KEY):
{
"mcpServers": {
"convert-online": {
"command": "npx",
"args": [
"-y", "mcp-remote", "https://mcp.convert.online",
"--header", "Authorization: Bearer YOUR_API_KEY"
]
}
}
}
Any MCP client works the same way: point it at https://mcp.convert.online and send the header Authorization: Bearer YOUR_API_KEY.
Which assistants can use it. Custom MCP connectors are new, and support differs by client rather than by anything on our side. Claude is verified end to end. ChatGPT offers custom connectors in its developer mode, but at the time of writing its sign-in does not finish — a known issue affecting other MCP servers too, not specific to this one. The consumer Gemini app has no custom-connector option yet, though Gemini Enterprise and the Gemini CLI do. Anything else that speaks MCP over HTTP should work.
Or install it from a directory
The server is published in the official MCP registry under the name online.convert/file-converter, and on Smithery. Clients that read those catalogues can add it from the listing, with no URL to paste.
How authentication works
Either way, the assistant is tied to your account, so every conversion counts toward your plan:
OAuth — you approve access here; the assistant gets a revocable token, never a key. Best for any assistant that connects by URL.
API key — you paste a key into the client config. It is your credential, so treat it like a password and revoke it from the dashboard if it leaks.
Tools reference
| Tool | Arguments | Returns |
|---|---|---|
| list_formats | input_format (optional) | All input formats, or the targets a given input can convert to. |
| list_options | input_format, output_format (required) | The settings that particular conversion accepts, with their exact names. |
| create_upload | filename, input_format (optional) | A place to put a file that is not on the web — the assistant shows you an upload box, or a link to open. Any size. |
| convert | output_format (required); source_url or import_id; input_format, filename, options (optional) | A job id and, when ready, a download link. The source is either a URL our server can fetch, or a file you sent through create_upload. |
| get_job | job_id (required) | The job's status and its download link once finished. |
Building your own integration instead? See the API documentation or the visual Job Builder.