Contenta Photo Converter

Contenta Photo Converter MCP server

Lets an AI agent (Claude Code, Claude Desktop/Cowork, Codex, Cursor, VS Code and other MCP clients) use Contenta Photo Converter on your Windows PC: batch image conversion, resizing, effects, metadata, PDF albums and slideshows for 100+ image formats.

Contenta Photo Converter is the MCP server of Contenta Converter, a Windows 10/11 desktop app with a free trial: https://www.contenta-converter.com/download.php

How it works

This package is a small launcher. It finds Contenta Converter on your PC (contenta.exe, installed per-user in %LOCALAPPDATA%\Programs\ContentaConverter or on your PATH) and runs the app's own MCP server (contenta serve) over stdio. Tools: convert_image, batch_convert, ai_transform, create_pdf_album, create_slideshow, merge_pdfs, detect_format, get_file_info, list_formats, list_effects, read_metadata, write_metadata, get_license_status.

If the app is not installed yet, the launcher serves a single get_started tool that gives your agent the download link and the install steps instead.

Full CLI and MCP reference: https://github.com/brunojanvier77/ContentaSoft/blob/main/contenta-converter/mcp-server.md (MCP tools and their parameters) and https://github.com/brunojanvier77/ContentaSoft/blob/main/contenta-converter/cli.md (the command line).

Add it to your client

Claude Code (Windows):

claude mcp add contenta-photo-converter -- cmd /c npx -y @contentasoft/contenta-photo-converter-mcp@1.0.5

Claude Desktop, Cursor and other clients that use mcpServers (JSON):

{

"mcpServers": { "contenta-photo-converter": { "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/contenta-photo-converter-mcp@1.0.5"] } } }

VS Code (.vscode/mcp.json, note the servers key):

{

"servers": { "contenta-photo-converter": { "type": "stdio", "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/contenta-photo-converter-mcp@1.0.5"] } } }

Codex (codex mcp add contenta-photo-converter -- cmd /c npx -y @contentasoft/contenta-photo-converter-mcp@1.0.5, or ~/.codex/config.toml):

[mcp_servers.contenta-photo-converter]

command = "cmd" args = ["/c", "npx", "-y", "@contentasoft/contenta-photo-converter-mcp@1.0.5"] startup_timeout_sec = 60 tool_timeout_sec = 3600

The first start downloads this small package, which can take longer than a client's default startup timeout (Codex: 10 s; Claude Code: set MCP_TIMEOUT); after that it starts at once. Long jobs such as video encodes can exceed a client's default tool timeout too (Codex: 60 s; Claude Code: MCP_TOOL_TIMEOUT). The app is told to stop a job when the client cancels it.

Once the app is installed you can also skip the launcher: "command": "contenta", "args": ["serve"].

What runs and what is sent

• The launcher itself sends nothing over the network and writes nothing to disk. It starts contenta.exe.
• The app works on local files on your PC. It sends anonymous usage telemetry (which tools ran, which MCP client connected, trial state) to ContentaSoft; turn it off in the app's settings. Privacy policy: https://www.contenta-converter.com/privacy.php
• ai_transform sends the image to Google Gemini with your own Gemini API key.
• The free trial has no end date: the first 10 outputs per PC come out clean, later ones carry a trial watermark (PDF albums, merged PDFs and slideshows are always marked on the trial). contenta status shows how many clean outputs are left; a batch spends one per file. Nothing stops working; a licence removes the limits.

License

The launcher is MIT-licensed (see LICENSE). Contenta Converter itself is commercial software by ContentaSoft AB.