MCP.so
Sign In

ConvertAgent

@vid-factory

Repository

About ConvertAgent

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

Config

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

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

Tools

2

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.

Does ConvertAgent send my files to the cloud?

No. ConvertAgent is self-hosted and runs entirely on your infrastructure. Files remain local; no cloud uploads are involved.

How many file conversions are supported?

ConvertAgent currently supports 20 conversion pairs covering documents (PDF, DOCX, HTML, MD, XLSX, CSV, PPTX), images (

Frequently asked questions

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.

Does ConvertAgent send my files to the cloud?

No. ConvertAgent is self-hosted and runs entirely on your infrastructure. Files remain local; no cloud uploads are involved.

How many file conversions are supported?

ConvertAgent currently supports 20 conversion pairs covering documents (PDF, DOCX, HTML, MD, XLSX, CSV, PPTX), images (

Comments

Basic information

Category

Developer Tools

License

MIT

Author

vid-factory

More Developer Tools MCP servers

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

discoverGPT

Joe Monastiero

discoverGPT is visualAI's unified MCP gateway for AI commerce, exposing 29 tools across four capabilities on one canonical product catalog: trimodal search (natural-language, precise-color, and image-similarity), AI cata

FastAPI-MCP

tadata-org

Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!

11.9K
E

endoflife.ai

endoflife.ai

Free MCP server for software end-of-life intelligence: EOL dates, support status, and the 0-100 EOL Risk Score across 485 tracked products. Agents can check a single version, pull a product's full lifecycle schedule, or

AptiBuild AI — Career Intelligence

ParklandBuilds

AptiBuild AI MCP Server — career, labor market, and business idea intelligence for AI agents. 11 tools covering real-time FRED labor market signals, BLS wage data (126 occupations), AI-generated app ideas, career paths,