ChangeThisFile MCP Server

Convert files across 1,000+ routes from any MCP client — image, video, audio, document, data, spreadsheet, font, ebook, and archive — plus instruction-driven file jobs (translate with layout preserved, extract tables to Excel, compress to an exact size). 25 free conversions per month per network with no signup; after that a free verified API key (25/month, shared with the REST API).

Powered by ChangeThisFile.com. Conversions run on real engines (FFmpeg, LibreOffice, Calibre, 7-Zip, sharp, Ghostscript, fonttools, and more) and return a temporary signed download URL. Uploaded files are auto-deleted within 24 hours.

Tools

Tool	Description
`convert_file`	Convert a file. Pass a publicly accessible `source_url` or `base64_content` (max ~5MB), plus a `target_format` (e.g. `pdf`, `mp3`, `json`). Source format is auto-detected from the URL/filename, or pass `source_format` explicitly. Returns a download URL valid for 1 hour.
`list_conversions`	List all supported conversion routes, optionally filtered by `source_format` (e.g. `docx` → see every format you can convert DOCX into).

Option 1 — Remote endpoint (recommended, no install)

The server is hosted at https://changethisfile.com/mcp using streamable HTTP transport (MCP spec 2025-03-26). If your client supports remote MCP servers, point it straight at the endpoint:

config.json

{
  "mcpServers": {
    "changethisfile": {
      "type": "streamable-http",
      "url": "https://changethisfile.com/mcp"
    }
  }
}

Claude Code:

Terminal

claude mcp add --transport http changethisfile https://changethisfile.com/mcp

Option 2 — Local stdio server (this package)

For clients that only speak stdio, this package bridges stdio ↔ the hosted endpoint:

config.json

{
  "mcpServers": {
    "changethisfile": {
      "command": "npx",
      "args": ["-y", "github:aadilr/changethisfile-mcp"]
    }
  }
}

Or clone and run directly:

bash

git clone https://github.com/aadilr/changethisfile-mcp.git
cd changethisfile-mcp
npm install
node index.js

Option 3 — Agent Skill / Claude Code plugin

This repo doubles as an Agent Skill and Claude Code plugin.

Any skills-capable agent (Claude Code, Codex CLI, Cursor, Gemini CLI, Copilot, and more):

Terminal

npx skills add aadilr/changethisfile-mcp

Claude Code plugin (bundles the MCP server + the skill):

Code

/plugin marketplace add aadilr/changethisfile-mcp
/plugin install changethisfile@changethisfile

The file-conversion skill prefers the MCP tools when connected and otherwise falls back to a bundled script (skills/file-conversion/scripts/convert.sh) that talks to the hosted endpoint over plain HTTPS — no MCP client required.

Option 4 — Docker

Terminal

docker build -t changethisfile-mcp .
docker run -i --rm changethisfile-mcp

Quick test

Terminal

curl -X POST https://changethisfile.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Supported formats

Category	Examples
Image	JPG, PNG, WebP, GIF, BMP, AVIF, ICO, SVG, TIFF, HEIC, PSD, RAW
Video	MP4, WebM, MKV, AVI, MOV, 3GP, FLV, WMV
Audio	MP3, WAV, FLAC, AAC, OGG, M4A, OPUS
Document	PDF, DOCX, DOC, ODT, RTF, TXT, HTML, MD, PPT, PPTX
Data	JSON, CSV, TSV, YAML, XML, TOML, XLSX, XLS
Font	TTF, OTF, WOFF, WOFF2
Ebook	EPUB, MOBI, AZW3, FB2, CBR, CBZ
Archive	ZIP, RAR, 7Z, TAR, TAR.GZ, TAR.BZ2, TAR.XZ

Use list_conversions for the full route table.

Environment variables

Variable	Default	Purpose
`CHANGETHISFILE_MCP_URL`	`https://changethisfile.com/mcp`	Override the upstream endpoint

Privacy & limits

No account needed for the first 25 conversions each month (per network). After that convert_file asks for a free verified API key — get one with POST https://changethisfile.com/v1/keys/free ({"email":"you@example.com"}), click the verification email, copy the key from https://changethisfile.com/dashboard, and set it as CTF_API_KEY (stdio bridge) or Authorization: Bearer ctf_sk_… (direct HTTP). Paid API plans start at $29/month: https://changethisfile.com/pricing
Files are processed server-side and auto-deleted within 24 hours; download URLs expire after 1 hour.
Per-IP rate limiting applies. For higher volume, see the authenticated API.

License

MIT