ConvertAgent

Name: ConvertAgent
Author: vid-factory

@vid-factory

Repository

About ConvertAgent

File conversion built for AI agents. CLI, REST API, and MCP server.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "convertagent": {
      "url": "http://localhost:3001/mcp"
    }
  }
}

Tools

Convert a file from one format to another

List all supported conversion format pairs

Overview

What is ConvertAgent?

ConvertAgent is a self-hosted, open-source file conversion toolkit designed for AI agents. It provides a CLI, REST API, and MCP (Model Context Protocol) server—all sharing one conversion engine—so agents can convert files locally without cloud uploads or per-conversion fees.

How to use ConvertAgent?

Install by cloning the repository, then run npm install and npm run build. Ensure system dependencies (ffmpeg, libreoffice, imagemagick, pandoc) are installed. Use the CLI with convertagent convert <file> --to <format> or start the API server with node dist/api/server.js. For MCP integration, add the server configuration to your MCP client (e.g., Claude Desktop) pointing to http://localhost:3001/mcp or the local script.

Key features of ConvertAgent

CLI, REST API, and MCP server from one unified engine.
20 conversion pairs across documents, images, and audio/video.
Self-hosted: files never leave your infrastructure.
Powered by open-source engines (FFmpeg, LibreOffice, ImageMagick, Pandoc).
No cloud uploads, no API keys, no per-conversion fees.
Real-file test matrix with 20/20 verified passing.

Use cases of ConvertAgent

AI agents convert PDF reports to Word documents for editing.
Extract audio from video files for transcription by an agent.
Batch convert images (e.g., PNG to WebP) for web optimization.
Convert markdown to PDF for document generation pipelines.
Integrate with MCP-compatible clients (e.g., Claude Desktop) for on-the-fly file conversion.

FAQ from ConvertAgent

What dependencies does ConvertAgent require?

ConvertAgent requires Node.js ≥22 and the system engines FFmpeg, LibreOffice, ImageMagick, and Pandoc. On Ubuntu/Debian install them with sudo apt-get install ffmpeg libreoffice imagemagick pandoc.

How do I run ConvertAgent as an MCP server?

After building, start the MCP server by running node dist/mcp/server.js or the API server (which also serves MCP on /mcp). Then configure your MCP client with the appropriate command or URL.