{
  "markdown": "# ConvertAPI MCP Server\n\n> Our hosted MCP server is available at https://mcp.convertapi.io - read more about it in the [Hosted MCP section below](#prefer-a-hosted-mcp-no-setup-required).\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that provides AI assistants with powerful file format conversion capabilities through the [ConvertAPI](https://www.convertapi.com/) service. Convert documents, images, spreadsheets, presentations, and more between 200+ file formats with OpenAPI-driven parameter validation.\n\n## Features\n\n- 🔄 **Universal File Conversion** - Convert between 200+ file formats (PDF, DOCX, XLSX, JPG, PNG, HTML, and more)\n- ✅ **OpenAPI-Driven Validation** - Dynamic parameter validation against ConvertAPI's live OpenAPI specification\n- 🎯 **Comprehensive Parameters** - Supports all ConvertAPI parameters including PageSize, PageOrientation, Quality, StoreFile, etc.\n- 🤖 **AI-Ready** - Seamlessly integrates with Claude Desktop, Cline, and other MCP-compatible AI assistants\n- 📦 **Local** - Supports local file operations\n\n## Installation\n\n### Prerequisites\n\n- .NET 9.0 SDK or later\n- A ConvertAPI account and API Token ([Get one free](https://www.convertapi.com/a/authentication))\n\n### Configuration\n\n1. Clone the repository:\n\ngit clone https://github.com/ConvertAPI/convertapi-mcp cd ConvertAPI-MCP\n\n2. Set your ConvertAPI API Token as an environment variable:\n\n**Windows (PowerShell):**\n$env:CONVERTAPI_TOKEN = \"your_api_token_here\"\n$env:CONVERTAPI_BASE_URI = \"https://v2.convertapi.com\"\n\n**Linux/macOS:**\nexport CONVERTAPI_TOKEN=\"your_api_token_here\"\nexport CONVERTAPI_BASE_URI=\"https://v2.convertapi.com\"\n\n\n3. Build the project:\ndotnet build\n\n## Usage\n\n**Configuration:**\n\nSet the following in your application configuration:\n\n**Local Mode (with file download):**\ndotnet run --project \"CA.MCP.Local\"\n\n\n## Integration with AI Assistants\n\n### Claude Desktop Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"convertapi\": {\n      \"command\": \"dotnet\",\n      \"args\": [\n        \"run\",\n        \"--project\",\n        \"C:\\\\Path\\\\To\\\\CA.MCP.Local\\\\CA.MCP.Local.csproj\",\n        \"--no-build\"\n      ],\n      \"env\": {\n        \"CONVERTAPI_TOKEN\": \"your_api_token_here\",\n        \"CONVERTAPI_BASE_URI\": \"https://v2.convertapi.com\"\n      }\n    }\n  }\n}\n```\n\n\n### Cline (VSCode Extension)\n\nAdd to your MCP settings in Cline:\n\n```json\n{\n  \"convertapi\": {\n    \"command\": \"dotnet\",\n    \"args\": [\n      \"run\",\n      \"--project\",\n      \"/path/to/CA.MCP.Local\",\n      \"--no-build\"\n    ],\n    \"env\": {\n      \"CONVERTAPI_TOKEN\": \"your_api_token_here\",\n      \"CONVERTAPI_BASE_URI\": \"https://v2.convertapi.com\"\n    }\n  }\n}\n```\n\n## Prefer a Hosted MCP? (No Setup Required)\n\nIf you do not want to install .NET or run your own server, you can use the **hosted ConvertAPI MCP** instead.\n\n**Hosted endpoint:**\n\nhttps://mcp.convertapi.io\n\nJust configure your MCP client to use the hosted endpoint and provide your ConvertAPI API Token.\n\n### Example (Claude Desktop)\n\n```json\n{\n  \"mcpServers\": {\n    \"convertapi\": {\n      \"url\": \"https://mcp.convertapi.io\",\n      \"env\": {\n        \"CONVERTAPI_TOKEN\": \"your_api_token_here\"\n      }\n    }\n  }\n}\n```\n\nThat’s it. Your AI agent can immediately start converting documents across 200+ formats using structured MCP tool calls.\n\nIf you need full control, private networking, or custom deployment, continue with the self-hosted setup.\n\n## Available Tools\n\n### `Convert`\n\nDynamically converts files between formats with OpenAPI-driven parameter validation.\n\n**Parameters:**\n- `fromFormat` (required) - Source format (e.g., \"docx\", \"xlsx\", \"jpg\")\n- `toFormat` (required) - Target format (e.g., \"pdf\", \"png\", \"html\")\n- `parameters` (optional) - Conversion parameters as key-value pairs\n- `fileParameters` (optional) - Files to convert with parameter names\n- `outputDirectory` (optional) - Directory to save converted files (Local mode only)\n\n**Example Usage in AI Assistant:**\n\nConvert this Word document to PDF:\n•\tFrom: docx\n•\tTo: pdf\n•\tFile: C:\\Documents\\report.docx\n•\tParameters: PageSize=A4, PageOrientation=portrait\n\n\n### `Information`\n\nProvides information about ConvertAPI capabilities, supported formats, and usage guidelines.\n\n## Supported Conversions\n\nConvertAPI supports 200+ file formats across multiple categories:\n\n- **Documents**: PDF, DOCX, DOC, RTF, TXT, ODT, PAGES\n- **Spreadsheets**: XLSX, XLS, CSV, ODS, NUMBERS\n- **Presentations**: PPTX, PPT, ODP, KEY\n- **Images**: JPG, PNG, GIF, BMP, TIFF, SVG, WEBP, ICO\n- **Web**: HTML, MHTML, MHT\n- **eBooks**: EPUB, MOBI, AZW3\n- **Archives**: ZIP, RAR, 7Z\n- And many more...\n\n## Common Conversion Parameters\n\nDepending on the conversion type, you can use parameters such as:\n\n- **PDF Options**: `PageSize`, `PageOrientation`, `MarginTop`, `MarginBottom`, `MarginLeft`, `MarginRight`\n- **Image Options**: `Quality`, `ImageWidth`, `ImageHeight`, `ScaleImage`, `ScaleProportions`\n- **General**: `StoreFile`, `FileName`, `Timeout`\n\nThe server automatically validates parameters against ConvertAPI's OpenAPI specification before conversion.\n\n## Claude Code Plugin\n\nIn addition to a self-hosted MCP server, this repository provides a Claude Code plugin that connects Claude to ConvertAPI via MCP.\n\n### What it enables\n- Convert files between different formats directly from Claude\n- Automate document and image processing, extraxction, and transformations\n\n### Example usage\n- \"Convert this PDF to DOCX\"\n- \"Merge these PDF files and apply a [Draft] watermark\"\n- \"Redact sensitive financial information on this PDF\"\n- \"Make this PDF print-ready with bleed and cropmarks\"\n\n### Setup\n- Install plugin in Claude Code\n- Authenticate via OAuth\n\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Resources\n\n- [ConvertAPI Documentation](https://www.convertapi.com/doc)\n- [Model Context Protocol Specification](https://modelcontextprotocol.io)\n- [ConvertAPI .NET SDK](https://github.com/ConvertAPI/convertapi-dotnet)\n\n## Acknowledgments\n\n- Built with the [ModelContextProtocol.NET](https://github.com/modelcontextprotocol/servers) library\n- Powered by [ConvertAPI](https://www.convertapi.com/)\n\n## Support\n\nFor issues and questions:\n- ConvertAPI support: [support@convertapi.com](mailto:support@convertapi.com)\n- GitHub Issues: [Report an issue](https://github.com/ConvertAPI/convertapi-mcp/issues)\n",
  "bytes": 6474,
  "sha": "a4fa3d44112c158d77ada56a153b3a4ad5254c9b0994e9944db0dc2cbf80087d",
  "repo_slug": "convertapi/convertapi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_convertapi_convertapi_mcp_a8fac332/readme"
}