ConvertMePls MCP server

Links: npm · GitHub · docs

A standalone Model Context Protocol server that lets AI agents (Claude and any MCP client) convert image, video and audio files through the ConvertMePls API.

It is a thin bridge — all conversion happens server-side, so the MCP has no engine, codecs or native binaries. Just Node.

Run

npx @convert-me-pls/mcp
# or
npm install -g @convert-me-pls/mcp && convertmepls-mcp

Configuration (environment):

| Var | Default | Notes | | --- | --- | --- | | CONVERTMEPLS_API_BASE | https://api.convertmepls.com | Point at your own self-hosted API if desired | | CONVERTMEPLS_API_KEY | — | Your API key (from the dashboard) |

Add to Claude

claude_desktop_config.json (or Claude Code MCP config):

{
  "mcpServers": {
    "convertmepls": {
      "command": "npx",
      "args": ["-y", "@convert-me-pls/mcp"],
      "env": { "CONVERTMEPLS_API_KEY": "gck_live_…" }
    }
  }
}

Tools

| Tool | Input | Description | | --- | --- | --- | | list_formats | — | All supported formats by category + pair count | | list_targets | source | Formats a source can convert to | | convert_file | input_path, target, output_path?, source?, options? | Convert a local file via the API and write the result to disk |

options: quality, width, height, crf, bitrate.

Self-hosting

Clone, build, run — point it at your own ConvertMePls API:

git clone <this-repo> && cd convertmepls-mcp
npm install && npm run build
CONVERTMEPLS_API_BASE=https://api.example.com CONVERTMEPLS_API_KEY=… npm start