Convertica MCP Server

"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"

Herramientas MCP

El servidor expone dos herramientas.

list_converters

Lista los más de 35 convertidores de Convertica con sus campos de archivo y opciones. Llama a esto primero para encontrar el slug tool correcto para convert_file. No requiere entrada.

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

convert_file

Ejecuta una de las más de 35 herramientas de conversión de convertica.net en archivos locales y guarda el resultado junto a la entrada (o en output_dir). Requiere autenticación mediante la variable de entorno CONVERTICA_API_KEY.

{
  "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)" }
  }
}

Las conversiones compatibles incluyen: PDF ⇄ Word / Excel / PowerPoint / JPG / HTML / Markdown / Texto / EPUB, PDF → PDF/A, HTML / URL → PDF, fusionar / dividir / comprimir / rotar / recortar / marca de agua / firmar / proteger / desbloquear PDF, convertir / optimizar imágenes / HEIC → JPG·PNG·PDF, y más. Lista completa mediante list_converters o en convertica.net.

Configuración y clave API

Necesitas una clave API de Convertica: suscríbete en convertica.net/pricing y luego crea una clave en convertica.net/users/api-keys. Documentación de API: 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_..." }
    }
  }
}

Notas de uso

• Los archivos se leen y escriben en tu disco local; los resultados se guardan junto al archivo de entrada a menos que pases output_dir.
• Las conversiones se ejecutan de forma síncrona a través de HTTPS; los archivos procesados se eliminan de los servidores de Convertica inmediatamente después de la respuesta (detalles).
• Las llamadas a la API se miden contra la cuota mensual de tu plan; las llamadas fallidas no se cuentan.

Desarrollo local

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

Licencia y créditos

MIT. No afiliado con Anthropic; "Convertica" es el servicio detrás de convertica.net.