Convertly MCP

Model Context Protocol server for AI agents that work with Convertly media APIs — from Claude, Cursor, ChatGPT, and other MCP clients.

Docs: MCP agents guide

Install

{
  "mcpServers": {
    "convertly": {
      "command": "npx",
      "args": ["-y", "@convertly-sh/mcp"],
      "env": {
        "CONVERTLY_API_KEY": "cvly_your_api_key",
        "CONVERTLY_MCP_ROOTS": "/Users/you/Downloads:/Users/you/Pictures"
      }
    }
  }
}

On Windows, separate roots with ;.

Source on npm

Browse published files on npm → Code (dist/, bin/, LICENSE). The main Convertly repo is private; this package is MIT-licensed.

Modes

Local (stdio) — filesystem tools + API tools. HTTP/SSE — API tools only (CONVERTLY_MCP_HTTP_PORT=3000).

Tools (summary)

• Docs: list_convertly_docs, search_convertly_docs, get_convertly_doc
• CDN: build_cdn_url — image/video/poster/GIF URLs (trim for logos)
• Filesystem (local): scan_folder, move_files, create_archive, …
• Media: convert_media, compress_media, remove_background, trim_media, video_to_gif, …
• Cloud: list_cloud_files, save_cloud_file, …
• Forma AI: forma_ai_transform, forma_ai_analyze (all plans; Forma AI units)

Full list: MCP agents docs.

CDN note

build_cdn_url for origin-backed URLs requires an origin source in Settings → Image CDN → Sources. See setup guide.

License

MIT © Convertly.

• Full text: npm → Code → LICENSE
• Summary: MIT on Open Source Initiative