convertfilefast-mcp

ConvertFileFast MCP server

MCP server for ConvertFileFast. It lets AI agents convert files, run PDF/image operations, create Stripe billing links, and report feedback through the ConvertFileFast REST API.

The same tools are available in both modes:

• Local stdio: the MCP server runs on the user's machine and saves results to a local folder.
• Remote HTTP: ConvertFileFast hosts the MCP server at https://mcp.convertfilefast.com/mcp and returns temporary download links.

Tools

Tool	API endpoint(s)	Result
list_supported_conversions	local matrix	JSON list
convert_file	/v2/convert/{from}-to-{to}	File
images_to_pdf	/v2/convert/images-to-pdf	PDF
merge_pdfs	/v2/pdf/merge	PDF
split_pdf	/v2/pdf/split	ZIP
compress_pdf	/v2/pdf/compress	PDF
rotate_pdf	/v2/pdf/rotate	PDF
protect_pdf	/v2/pdf/protect	PDF
unlock_pdf	/v2/pdf/unlock	PDF
extract_pdf_text	/v2/pdf/extract-text	JSON
resize_image	/v2/image/resize	Image
compress_image	/v2/image/compress	Image
get_billing_status	/v2/billing/status	JSON
create_subscription_checkout	/v2/billing/checkout/subscription	Stripe Checkout URL
create_credit_pack_checkout	/v2/billing/checkout/credits	Stripe Checkout URL
create_billing_portal_link	/v2/billing/portal	Stripe Portal URL
report_feedback	/v2/feedback	JSON

Every file-producing tool accepts a public source_url where possible, or base64 content when the client cannot expose a URL. Billing tools never collect card data; they return Stripe-hosted URLs for the user to open and confirm payment. report_feedback accepts a short summary, category, related tool, and context; it can run without an API key, but forwards one when the client provides it.

Supported conversions

Use the list_supported_conversions tool for the canonical list. Current slugs:

avif-to-jpg, avif-to-pdf, avif-to-png, bmp-to-jpg, bmp-to-pdf, bmp-to-png, csv-to-json, csv-to-pdf, csv-to-xlsx, doc-to-pdf, docx-to-pdf, heic-to-jpg, heic-to-pdf, heic-to-png, html-to-pdf, images-to-pdf, jpg-to-pdf, jpg-to-png, jpg-to-webp, json-to-csv, markdown-to-pdf, odt-to-pdf, pdf-to-csv, pdf-to-docx, pdf-to-jpg, pdf-to-png, pdf-to-txt, pdf-to-xlsx, png-to-jpg, png-to-pdf, png-to-webp, ppt-to-pdf, pptx-to-pdf, rtf-to-pdf, svg-to-jpg, svg-to-pdf, svg-to-png, tiff-to-jpg, tiff-to-pdf, tiff-to-png, txt-to-pdf, url-to-pdf, webp-to-jpg, webp-to-pdf, webp-to-png, xlsx-to-csv, xlsx-to-pdf.

Authentication

Create a ConvertFileFast API key at:

https://www.convertfilefast.com/signup

Local stdio uses:

CONVERTFILEFAST_API_KEY=cff_...

Remote HTTP uses either:

X-API-Key: cff_...

or:

Authorization: Bearer cff_...

The remote MCP server does not store API keys. It forwards the key to api.convertfilefast.com for each tool call.

Remote MCP

Use this when the MCP client supports remote Streamable HTTP servers:

{
  "mcpServers": {
    "convertfilefast": {
      "url": "https://mcp.convertfilefast.com/mcp",
      "headers": {
        "X-API-Key": "cff_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

Remote file results look like:

{
  "status": "success",
  "download_url": "https://mcp.convertfilefast.com/download/...",
  "filename": "converted.pdf",
  "bytes": 12345,
  "expires_in_seconds": 3600
}

Local stdio install

Recommended:

{
  "mcpServers": {
    "convertfilefast": {
      "command": "uvx",
      "args": ["convertfilefast-mcp"],
      "env": {
        "CONVERTFILEFAST_API_KEY": "cff_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

Alternative via npm launcher:

{
  "mcpServers": {
    "convertfilefast": {
      "command": "npx",
      "args": ["-y", "convertfilefast-mcp"],
      "env": {
        "CONVERTFILEFAST_API_KEY": "cff_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

Local file results look like:

{
  "status": "success",
  "output_path": "/Users/me/ConvertFileFast/converted.pdf",
  "filename": "converted.pdf",
  "bytes": 12345
}

Environment variables

Variable	Default	Purpose
CONVERTFILEFAST_API_BASE	https://api.convertfilefast.com	REST API base URL
CONVERTFILEFAST_API_KEY	empty	Local stdio API key
CONVERTFILEFAST_OUTPUT_DIR	~/ConvertFileFast	Local output directory
CONVERTFILEFAST_TIMEOUT	180	Per-request timeout in seconds
CONVERTFILEFAST_MCP_TRANSPORT	stdio	stdio, streamable-http, http, or sse
CONVERTFILEFAST_MCP_HOST	0.0.0.0	HTTP bind host
CONVERTFILEFAST_MCP_PORT	8000	HTTP bind port
CONVERTFILEFAST_MCP_PATH	/mcp	HTTP MCP endpoint
CONVERTFILEFAST_REMOTE_MODE	false	Return temporary download URLs
CONVERTFILEFAST_DOWNLOAD_BASE	https://mcp.convertfilefast.com	Public base URL for downloads
CONVERTFILEFAST_TEMP_DIR	/tmp/convertfilefast-mcp	Remote temporary file store
CONVERTFILEFAST_DOWNLOAD_TTL	3600	Download URL TTL in seconds
CONVERTFILEFAST_MAX_BASE64_MB	60	Max decoded base64 payload size

Local development

cd mcp
uv run --with fastmcp --with httpx --with pydantic python server.py

Run tests:

cd mcp
uv run --with fastmcp --with httpx --with pydantic --with pytest pytest tests -q

Run remote mode locally:

cd mcp
CONVERTFILEFAST_MCP_TRANSPORT=streamable-http \
CONVERTFILEFAST_REMOTE_MODE=true \
CONVERTFILEFAST_DOWNLOAD_BASE=http://127.0.0.1:8000 \
uv run --with fastmcp --with httpx --with pydantic python server.py

Then check:

curl http://127.0.0.1:8000/health

Deployment

See DEPLOYMENT.md.

Production smoke evidence is tracked in PRODUCTION_SMOKE.md.

mcp-name: io.github.MLTCorp/convertfilefast