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"

Ferramentas MCP

O servidor expõe duas ferramentas.

list_converters

Lista todos os mais de 35 conversores do Convertica com seus campos de arquivo e opções. Chame esta ferramenta primeiro para encontrar o slug tool correto para convert_file. Não requer entrada.

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

convert_file

Executa uma das mais de 35 ferramentas de conversão do convertica.net em arquivo(s) local(is) e salva o resultado ao lado da entrada (ou em output_dir). Requer autenticação por meio da variável de ambiente 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)" }
  }
}

As conversões suportadas incluem: PDF ⇄ Word / Excel / PowerPoint / JPG / HTML / Markdown / Text / EPUB, PDF → PDF/A, HTML / URL → PDF, mesclar / dividir / compactar / girar / recortar / marca d'água / assinar / proteger / desbloquear PDF, converter / otimizar imagem / HEIC → JPG·PNG·PDF, e mais. Lista completa via list_converters ou em convertica.net.

Configuração e chave de API

Você precisa de uma chave de API do Convertica: assine em convertica.net/pricing e depois crie uma chave em convertica.net/users/api-keys. Documentação da 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

• Os arquivos são lidos e gravados no seu disco local; os resultados são salvos ao lado do arquivo de entrada, a menos que você passe output_dir.
• As conversões são executadas de forma síncrona por HTTPS; os arquivos processados são excluídos dos servidores do Convertica logo após a resposta (detalhes).
• As chamadas de API são contabilizadas na cota mensal do seu plano; chamadas com falha não são contadas.

Desenvolvimento local

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

Licença e créditos

MIT. Não afiliado à Anthropic; "Convertica" é o serviço por trás do convertica.net.