Convertica MCP

What convertica-net/convertica-mcp MCP server does

The convertica-net/convertica-mcp MCP server gives an MCP client access to more than 35 Convertica file-processing tools. It works with local files and supports document conversion, PDF operations, and image processing. Supported workflows include converting PDFs to or from Word, Excel, PowerPoint, JPG, HTML, Markdown, Text, and EPUB; creating PDF/A files; and converting HTML or URLs to PDF.

PDF operations include merging, splitting, compressing, rotating, cropping, watermarking, signing, protecting, and unlocking files. Image workflows include format conversion, optimization, and HEIC conversion to JPG, PNG, or PDF. The complete converter catalog is returned by the discovery tool rather than being hard-coded into the client workflow.

How it works

The server exposes two MCP tools. Call list_converters without arguments to retrieve the available converter slugs, input fields, and option definitions. Use the returned tool value with convert_file; examples include pdf-to-word and pdf-organize/merge.

convert_file accepts local file paths, optional tool-specific options, and an optional output directory. For multi-file operations, the file order matters. By default, the generated result is written next to the first input file. Passing output_dir changes the destination.

The convertica-net/convertica-mcp MCP server sends conversion requests to Convertica over HTTPS and waits synchronously for the response. Files are read from and written to the local machine. Convertica states that processed files are deleted from its servers after the response. API usage counts against the account’s monthly quota, while failed calls are not counted.

Setup and configuration

Install and run the server with the npm package through npx:

npx -y convertica-mcp

Set CONVERTICA_API_KEY in the MCP client environment. The key is obtained through Convertica’s account and API-key pages, and the README directs users to subscribe through Convertica’s pricing page before creating one.

For Claude Desktop, Cursor, or Windsurf, configure the server with the npx command, the -y and convertica-mcp arguments, and an environment entry containing the API key. Claude Code can add the same server with its MCP command and environment option. The repository also documents npm install and smoke-test commands for local development; the protocol smoke test does not require a key, while a real conversion does.

Tools and capabilities

• list_converters: Lists available converters, file fields, and options. It takes no input.
• convert_file: Runs one converter against local file paths and saves the output locally.
• PDF, office-document, markup, ebook, and image format conversion.
• PDF merge, split, compression, rotation, cropping, watermarking, signing, protection, unlocking, and PDF/A conversion.
• HTML or URL rendering to PDF.
• Image conversion and optimization, including HEIC input handling.

The convertica-net/convertica-mcp MCP server is suited to assistants that need to act on files already available on the user’s machine. It is not described as a file browser or general-purpose storage service; its exposed operations center on conversion and related PDF or image processing.

Limitations and notes

A valid CONVERTICA_API_KEY is required for conversion requests. The server depends on Convertica’s hosted service, so conversion calls require network access and are subject to the account’s monthly quota. Results are saved locally, but the source files must be available through paths supplied to convert_file. The README states that the server is MIT licensed and is not affiliated with Anthropic.