ConvertAPI

AModel Context Protocol (MCP)server that provides AI assistants with powerful file format conversion capabilities through theConvertAPIservice. Convert documents, images, spreadsheets, presentations, and more between 200+ file formats with OpenAPI-driven parameter validation.

- .NET 9.0 SDK or later
- A ConvertAPI account and API Token (Get one free)

git clonehttps://github.com/ConvertAPI/convertapi-mcpcd ConvertAPI-MCP
- Set your ConvertAPI API Token as an environment variable:

Windows (PowerShell):$env:CONVERTAPI_TOKEN = "your_api_token_here" $env:CONVERTAPI_BASE_URI = "https://v2.convertapi.com"

Linux/macOS:export CONVERTAPI_TOKEN="your_api_token_here" export CONVERTAPI_BASE_URI="https://v2.convertapi.com"

{ "mcpServers": { "convertapi": { "command": "dotnet", "args": [ "run", "--project", "C:\\Path\\To\\CA.MCP.Local\\CA.MCP.Local.csproj", "--no-build" ], "env": { "CONVERTAPI_TOKEN": "your_api_token_here", "CONVERTAPI_BASE_URI": "https://v2.convertapi.com" } } } }

{ "convertapi": { "command": "dotnet", "args": [ "run", "--project", "/path/to/CA.MCP.Local", "--no-build" ], "env": { "CONVERTAPI_TOKEN": "your_api_token_here", "CONVERTAPI_BASE_URI": "https://v2.convertapi.com" } } }

Prefer a Hosted MCP? (No Setup Required)

If you do not want to install .NET or run your own server, you can use thehosted ConvertAPI MCPinstead.

Just configure your MCP client to use the hosted endpoint and provide your ConvertAPI API Token.

{ "mcpServers": { "convertapi": { "url": "https://mcp.convertapi.io", "env": { "CONVERTAPI_TOKEN": "your_api_token_here" } } } }

That’s it. Your AI agent can immediately start converting documents across 200+ formats using structured MCP tool calls.

If you need full control, private networking, or custom deployment, continue with the self-hosted setup.

Dynamically converts files between formats with OpenAPI-driven parameter validation.

- fromFormat(required) - Source format (e.g., "docx", "xlsx", "jpg")
- toFormat(required) - Target format (e.g., "pdf", "png", "html")
- parameters(optional) - Conversion parameters as key-value pairs
- fileParameters(optional) - Files to convert with parameter names
- outputDirectory(optional) - Directory to save converted files (Local mode only)

Convert this Word document to PDF: • From: docx • To: pdf • File: C:\Documents\report.docx • Parameters: PageSize=A4, PageOrientation=portrait

Provides information about ConvertAPI capabilities, supported formats, and usage guidelines.

ConvertAPI supports 200+ file formats across multiple categories:

- Documents: PDF, DOCX, DOC, RTF, TXT, ODT, PAGES
- Spreadsheets: XLSX, XLS, CSV, ODS, NUMBERS
- Presentations: PPTX, PPT, ODP, KEY
- Images: JPG, PNG, GIF, BMP, TIFF, SVG, WEBP, ICO
- Web: HTML, MHTML, MHT
- eBooks: EPUB, MOBI, AZW3
- Archives: ZIP, RAR, 7Z
- And many more...

Depending on the conversion type, you can use parameters such as:

- PDF Options:PageSize,PageOrientation,MarginTop,MarginBottom,MarginLeft,MarginRight
- Image Options:Quality,ImageWidth,ImageHeight,ScaleImage,ScaleProportions
- General:StoreFile,FileName,Timeout

The server automatically validates parameters against ConvertAPI's OpenAPI specification before conversion.

In addition to a self-hosted MCP server, this repository provides a Claude Code plugin that connects Claude to ConvertAPI via MCP.

- Convert files between different formats directly from Claude
- Automate document and image processing, extraxction, and transformations

- "Convert this PDF to DOCX"
- "Merge these PDF files and apply a [Draft] watermark"
- "Redact sensitive financial information on this PDF"
- "Make this PDF print-ready with bleed and cropmarks"

- Install plugin in Claude Code
- Authenticate via OAuth

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the MIT License - see the LICENSE file for details.

- ConvertAPI Documentation
- Model Context Protocol Specification
- ConvertAPI .NET SDK

- Built with theModelContextProtocol.NETlibrary
- Powered byConvertAPI

- ConvertAPI support:support@convertapi.com
- GitHub Issues:Report an issue

MCP server for AI-assisted STEP CAD inspection, geometry queries, PMI hints, and revision comparison