{
  "markdown": "<div align=\"center\">\n  <img src=\"https://convertica.net/static/favicon-192x192.png\" width=\"88\" height=\"88\" alt=\"Convertica\" />\n\n  # Convertica MCP Server\n\n  Convert files without leaving your AI assistant. Connect Claude, Cursor, Windsurf or any [MCP](https://modelcontextprotocol.io) client to [Convertica](https://convertica.net) and its 35+ document and image conversion tools.\n\n  [![npm version](https://img.shields.io/npm/v/convertica-mcp?color=cb3837&logo=npm)](https://www.npmjs.com/package/convertica-mcp)\n  [![npm downloads](https://img.shields.io/npm/dm/convertica-mcp?color=cb3837)](https://www.npmjs.com/package/convertica-mcp)\n  [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)\n  [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-net.convertica%2Fmcp-6E56CF)](https://registry.modelcontextprotocol.io)\n  [![convertica-mcp MCP server](https://glama.ai/mcp/servers/convertica-net/convertica-mcp/badges/score.svg)](https://glama.ai/mcp/servers/convertica-net/convertica-mcp)\n\n  [Website](https://convertica.net) · [API docs](https://convertica.net/api/) · [npm](https://www.npmjs.com/package/convertica-mcp)\n</div>\n\n```\n\"Convert ~/Downloads/report.pdf to Word\"\n\"Merge these three PDFs and compress the result\"\n\"Turn this HEIC photo into a JPG\"\n\"Render https://example.com as a PDF\"\n```\n\n## MCP tools\n\nThe server exposes two tools.\n\n### list_converters\n\nLists 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.\n\n```json\n{ \"type\": \"object\", \"properties\": {} }\n```\n\n### convert_file\n\nRuns 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.\n\n```json\n{\n  \"type\": \"object\",\n  \"required\": [\"tool\"],\n  \"properties\": {\n    \"tool\": { \"type\": \"string\", \"description\": \"Converter slug from list_converters, e.g. pdf-to-word or pdf-organize/merge\" },\n    \"files\": { \"type\": \"array\", \"items\": { \"type\": \"string\" }, \"description\": \"Absolute paths of input file(s); order matters for multi-file tools\" },\n    \"options\": { \"type\": \"object\", \"description\": \"Tool-specific options as listed by list_converters, e.g. {angle: 90}\" },\n    \"output_dir\": { \"type\": \"string\", \"description\": \"Directory to save the result (default: alongside the first input file)\" }\n  }\n}\n```\n\nSupported 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](https://convertica.net/).\n\n## Setup and API key\n\nYou need a Convertica API key: subscribe at [convertica.net/pricing](https://convertica.net/pricing/), then create a key at [convertica.net/users/api-keys](https://convertica.net/users/api-keys/). API docs: [convertica.net/api/docs](https://convertica.net/api/docs/).\n\n### Claude Code\n\n```bash\nclaude mcp add convertica -e CONVERTICA_API_KEY=cvk_live_... -- npx -y convertica-mcp\n```\n\n### Claude Desktop / Cursor / Windsurf\n\n```json\n{\n  \"mcpServers\": {\n    \"convertica\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"convertica-mcp\"],\n      \"env\": { \"CONVERTICA_API_KEY\": \"cvk_live_...\" }\n    }\n  }\n}\n```\n\n## Usage notes\n\n- Files are read from and written to your local disk; results are saved next to the input file unless you pass `output_dir`.\n- Conversions run synchronously over HTTPS; processed files are deleted from Convertica's servers right after the response ([details](https://convertica.net/privacy/)).\n- API calls are metered against your plan's monthly quota; failed calls are not counted.\n\n## Local development\n\n```bash\nnpm install\nnpm run smoke                        # protocol check, no key needed\nCONVERTICA_API_KEY=... npm run smoke # + one real conversion\n```\n\n## License and credits\n\nMIT. Not affiliated with Anthropic; \"Convertica\" is the service behind [convertica.net](https://convertica.net).\n",
  "bytes": 4147,
  "sha": "6f75cfcdd9f5254f08ee4d6094ae79bddb557a45810b8b54a4837bc117429794",
  "repo_slug": "convertica-net/convertica-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_net_convertica_mcp_436df519/readme"
}