MCP Server Documentation

Convert files directly from your AI coding assistant using the Model Context Protocol (MCP). Connect Claude Code, Cursor, Gemini CLI, or any MCP-compatible tool to access 140+ file conversions.

Quick Start

Get your first conversion running in 30 seconds. Add the MCP server to Claude Code and convert a file:

1. Add the MCP server

claude mcp add --transport http conversiontools https://mcp.conversiontools.io/mcp

2. Ask Claude to convert a file

Convert report.xlsx to PDF

Claude will handle authentication on the first run (a browser window opens for you to log in) and then perform the conversion automatically.

Installation Methods

Claude Code Plugin (recommended)

The plugin includes the MCP server connection and built-in AI instructions for optimal conversion results.

claude plugin marketplace add conversiontools/agent-skills
claude plugin install conversiontools

See the Claude Code Plugin docs for more details.

Claude Code (manual MCP setup)

Add the MCP server directly with a single command:

claude mcp add --transport http conversiontools https://mcp.conversiontools.io/mcp

Cursor

Add to your Cursor MCP configuration:

{
  "mcpServers": {
    "conversiontools": {
      "url": "https://mcp.conversiontools.io/mcp"
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/conversiontools/gemini-extension

Other MCP-Compatible Tools

Any tool that supports the Model Context Protocol can connect to:

https://mcp.conversiontools.io/mcp

Authentication

Choose the authentication method that works best for your setup:

Option A: OAuth (recommended)

Default

No configuration required. On first use, a browser window opens for you to log in to your Conversion Tools account. Your credentials are securely stored for future sessions and automatically refreshed when they expire.

Run a conversion or call auth_login
Browser opens to conversiontools.io
Log in and authorize the connection
You are authenticated -- credentials are saved locally

Option B: API Token

For CI/CD pipelines, server environments, or when browser login is not available. Get your API token from your profile page.

Set as environment variable:

export CT_API_TOKEN=your_api_token_here

Or pass it in the MCP server URL:

claude mcp add --transport http conversiontools https://mcp.conversiontools.io/mcp --header "Authorization: Bearer your_api_token_here"

Available Tools

The MCP server provides 8 tools for your AI assistant. Click on each tool to see its parameters and examples.

Convert a file from one format to another. Supports 140+ conversion types.

Get a signed URL for uploading large files (larger than 5 MB). Upload the file, then use the returned file_id with convert_file.

List available file converters. Use this to discover what conversions are supported.

Find the best converter for converting between two specific formats.

Get detailed information about a specific converter, including supported options.

Check current authentication status and account information.

Logout and clear stored credentials.

Usage Examples

Once connected, just ask your AI assistant naturally. Here are common workflows:

Convert Excel to PDF

Convert report.xlsx to PDF

Your AI assistant will use convert_file to transform the spreadsheet into a PDF document.

Convert JSON to CSV

Transform data.json into a CSV file

Works with nested JSON arrays -- the converter flattens the structure into rows and columns.

Extract text from an image (OCR)

Extract the text from receipt.jpg

Uses OCR to recognize and extract text from images and scanned documents.

Batch convert files

Convert all the PNG files in the screenshots/ folder to WebP

Your AI assistant will iterate through each file and convert them one by one.

Find available converters

What formats can I convert a PDF to?

Uses list_converters to show all available output formats for PDFs.

AI-powered data extraction

Extract the invoice data from invoice.pdf as a JSON file

AI-powered converters can extract structured data from complex documents like invoices, receipts, and reports.

Supported Formats

Convert between 140+ file formats across 11 categories:

Documents

Word, PowerPoint, Excel, Markdown to PDF, HTML, Text

DOCX, DOC, PPTX, PPT, XLSX, XLS, MD

Data Formats

Convert between structured data formats

JSON, CSV, XML, YAML, Excel

Images

Convert between image formats, including modern formats

PNG, JPG, WebP, AVIF, HEIC, SVG

PDF Processing

Extract content from PDFs to editable formats

PDF to Word, Excel, CSV, Text, JPG, PNG, EPUB

Audio

Convert between audio formats

MP3, WAV, FLAC

Video

Convert video formats, extract audio from video

MP4, MOV, MKV, AVI

E-books

Convert between e-book formats

EPUB, MOBI, PDF, Markdown

OCR

Extract text from images and scanned PDFs

PNG, JPG, PDF to Text, searchable PDF

AI-Powered

Smart extraction from complex documents

PDF, Images to JSON, CSV, Excel, Markdown

Subtitles

Convert and export subtitle files

SRT, VTT, CSV, Text

Web

Capture websites and render HTML

URL/HTML to PDF, JPG, PNG, CSV

View full converter list for detailed information about each converter and its options. You can also use the list_converters or find_converter tools to discover available conversions directly from your AI assistant.

Pricing

MCP uses the same conversion limits as your Conversion Tools account:

Free tier: 100 conversions per month (max 10 per day)
Paid plans: Higher limits and priority processing

View pricing plans or API pricing for details.

Troubleshooting

Common issues and how to resolve them:

Need Help?

Check our API Documentation for detailed information about converters and options.

Looking for the Claude Code Plugin? View plugin documentation for automatic setup with built-in conversion instructions.

Having issues? Contact us and we will help you get set up.

Ready to Get Started?

Add the MCP server to your AI assistant and start converting files without leaving your workflow.

claude mcp add --transport http conversiontools https://mcp.conversiontools.io/mcp

Claude Code Plugin API Documentation