Skip to main content
Glama
mcp-convertica

mcp-convertica

Official

Convertica MCP Server

Convert files without leaving your AI assistant. Connect Claude, Cursor, Windsurf or any MCP client to Convertica and its 35+ document and image conversion tools.

npm version npm downloads License: MIT MCP Registry convertica-mcp MCP server

Website · API docs · npm

"Convert ~/Downloads/report.pdf to Word"
"Merge these three PDFs and compress the result"
"Turn this HEIC photo into a JPG"
"Render https://example.com as a PDF"

MCP tools

The server exposes two tools.

list_converters

Lists all 35+ Convertica converters with their file fields and options. Call this first to find the right tool slug for convert_file. Takes no input.

{ "type": "object", "properties": {} }

convert_file

Runs one of convertica.net's 35+ conversion tools on local file(s) and saves the result next to the input (or into output_dir). Requires authentication via the CONVERTICA_API_KEY env var.

{
  "type": "object",
  "required": ["tool"],
  "properties": {
    "tool": { "type": "string", "description": "Converter slug from list_converters, e.g. pdf-to-word or pdf-organize/merge" },
    "files": { "type": "array", "items": { "type": "string" }, "description": "Absolute paths of input file(s); order matters for multi-file tools" },
    "options": { "type": "object", "description": "Tool-specific options as listed by list_converters, e.g. {angle: 90}" },
    "output_dir": { "type": "string", "description": "Directory to save the result (default: alongside the first input file)" }
  }
}

Supported conversions include: PDF ⇄ Word / Excel / PowerPoint / JPG / HTML / Markdown / Text / EPUB, PDF → PDF/A, HTML / URL → PDF, merge / split / compress / rotate / crop / watermark / sign / protect / unlock PDF, image convert / optimize / HEIC → JPG·PNG·PDF, and more. Full list via list_converters or at convertica.net.

Related MCP server: MarkltDown MCP Server

Setup and API key

You need a Convertica API key: subscribe at convertica.net/pricing, then create a key at convertica.net/users/api-keys. API docs: convertica.net/api/docs.

Claude Code

claude mcp add convertica -e CONVERTICA_API_KEY=cvk_live_... -- npx -y convertica-mcp

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "convertica": {
      "command": "npx",
      "args": ["-y", "convertica-mcp"],
      "env": { "CONVERTICA_API_KEY": "cvk_live_..." }
    }
  }
}

Usage notes

  • Files are read from and written to your local disk; results are saved next to the input file unless you pass output_dir.

  • Conversions run synchronously over HTTPS; processed files are deleted from Convertica's servers right after the response (details).

  • API calls are metered against your plan's monthly quota; failed calls are not counted.

Local development

npm install
npm run smoke                        # protocol check, no key needed
CONVERTICA_API_KEY=... npm run smoke # + one real conversion

License and credits

MIT. Not affiliated with Anthropic; "Convertica" is the service behind convertica.net.

Available Tools

1 tool
convert_fileConvert a file with ConverticaA

Run one of convertica.net's conversion tools on local file(s) and save the result next to the input (or into output_dir). Use list_converters to see tool slugs and per-tool options. Examples: {tool: 'pdf-to-word', files: ['/docs/report.pdf']}; {tool: 'pdf-organize/merge', files: ['/a.pdf', '/b.pdf']}; {tool: 'url-to-pdf', options: {url: 'https://example.com'}}.

Inputs: tool (required), files, options, output_dir.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so no ambiguity in selecting among tools.

    Naming Consistency5/5

    With a single tool, naming consistency is inherently perfect; the name 'convert_file' follows a clear verb_noun pattern.

    Tool Count2/5

    One tool is too few for a conversion service; it lacks a necessary discovery tool like list_converters that is referenced in the description.

    Completeness2/5

    The server references list_converters but does not provide it, forcing agents to guess available converters; the single tool does not cover the full conversion lifecycle.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers