aadilr/changethisfile-mcp

Use ChangeThisFile's **seven file tools** from any MCP client: conversion across 1,000+ supported routes, document translation, table extraction, exact-size compression, natural-language routing, and job status checks.
Powered by ChangeThisFile.com. Discovery and paid-preview jobs are public. General convert_file works without a key for 25 conversions per month per network; after that it needs a free verified developer key (25 conversions/month, shared with the REST API), and paid API plans raise the limit.
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). |
| translate_file | Translate a document with its layout preserved. Returns a free preview and a one-time checkout link for the full output. |
| extract_tables | Extract tables from PDFs or images into Excel. Returns a free preview and a one-time checkout link for the full output. |
| compress_file | Compress a PDF, image, or video to an exact maximum size. Free with a daily limit. |
| do_file_job | Route a plain-language file instruction to conversion, translation, extraction, or compression. |
| check_job | Check a submitted job and retrieve its preview, checkout link, or download URL. |
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. Clients that support custom headers can send Authorization: Bearer ctf_sk_... to use authenticated developer metering.
Claude Code:
Option 2 — Local stdio server (this package)
For clients that only speak stdio, this package bridges stdio ↔ the hosted endpoint:
CTF_API_KEY is optional: without it you get 25 free conversions per month per network; after that convert_file asks for a key. Get a verified free key from the ChangeThisFile dashboard (or POST https://changethisfile.com/v1/keys/free with {"email":"you@example.com"} and click the verification email); its 25 monthly conversions are shared across MCP and REST. Paid plans start at $29/month.
Or clone and run directly:
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):
**Claude Code plugin** (bundles the MCP server + the skill):
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.