# Contenta Photo Converter

> Contenta Photo Converter is an MCP server for design and media. Lets AI agents batch-convert, resize and watermark photos with Contenta on Windows. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** Windows, CLI
- **Website:** https://www.contenta-converter.com
- **Repository:** https://github.com/contentasoftware/mcp-launcher/tree/HEAD/packages/contenta-photo-converter-mcp
- **MCP Registry name:** com.contenta-software/contenta-photo-converter
- **Categories:** design and media, files and documents
- **Listing updated:** 2026-11-14

## About

This server is a small launcher that finds Contenta Converter on a Windows PC and starts the app's own MCP server over stdio. If the desktop app is not installed yet, the launcher exposes a single get_started tool that hands your agent the download link and install steps.

Work happens on local files. The app reads about 100 input extensions, from camera RAW to HEIC, PDF and SVG, and writes 28 output extensions. Tools cover single and batch conversion, an AI transform step, PDF albums, slideshows, PDF merging, format detection, metadata reading and writing, and licence status.

The README is open about what leaves the machine: the app sends anonymous usage telemetry that can be switched off, and ai_transform sends the image to Google Gemini using your own Gemini API key. The launcher itself is MIT-licensed, while Contenta Converter is commercial software with a free trial.

## Features

- **Batch conversion:** batch_convert runs a whole folder of photos through one set of format, size and quality settings.
- **Wide format support:** Reads RAW, HEIC, AVIF, PDF, SVG and many legacy formats, and writes 28 output types.
- **PDF albums and slideshows:** create_pdf_album, create_slideshow and merge_pdfs turn image sets into documents.
- **Metadata control:** read_metadata and write_metadata handle EXIF, IPTC and XMP fields.
- **Install helper:** Without the app present, a get_started tool gives the agent the download link and steps.
- **Cancellable jobs:** The app is told to stop a running job when the client cancels it.

## Good for

- Resize and watermark hundreds of product photos for online shops
- Convert a wedding shoot's RAW files to web-ready JPEGs overnight
- Prepare listing photos for MLS upload with metadata handled
- Build a PDF album from a folder of images
- Strip or rewrite EXIF data across a batch

## Install

### Claude Code (Terminal)

```sh
claude mcp add contenta-photo-converter -- npx -y @contentasoft/contenta-photo-converter-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `convert_image`: Contenta Converter tool: convert image
- `batch_convert`: Contenta Converter tool: batch convert
- `ai_transform`: Contenta Converter tool: ai transform
- `create_pdf_album`: Contenta Converter tool: create pdf album
- `create_slideshow`: Contenta Converter tool: create slideshow
- `merge_pdfs`: Contenta Converter tool: merge pdfs
- `detect_format`: Contenta Converter tool: detect format
- `get_file_info`: Contenta Converter tool: get file info
- `list_formats`: Contenta Converter tool: list formats
- `list_effects`: Contenta Converter tool: list effects
- `read_metadata`: Contenta Converter tool: read metadata
- `write_metadata`: Contenta Converter tool: write metadata
- `get_license_status`: Contenta Converter tool: get license status
- `register_license`: Contenta Converter tool: register license
- `get_started`: Returns the download link and install steps when the desktop app is missing

## FAQ

### Does it work on macOS or Linux?

The README describes it as running on a Windows PC alongside the Windows 10/11 Contenta Converter app.

### Is it free?

The launcher is MIT-licensed. The app has a free trial with no end date: the first 10 outputs per PC are clean and later ones carry a trial watermark. A one-time licence removes the limit.

### Does ai_transform keep images local?

No. It sends the image to Google Gemini using your own Gemini API key.

### What if a job takes a long time?

Long jobs such as video encodes can exceed a client's default tool timeout, so the README suggests raising it in Codex or Claude Code.

### Is Contenta Photo Converter free?

Contenta Photo Converter is a paid product with a free trial.

### How do I add Contenta Photo Converter to Claude Code?

Run this command in your terminal: claude mcp add contenta-photo-converter -- npx -y @contentasoft/contenta-photo-converter-mcp

### What are the best alternatives to Contenta Photo Converter?

The closest alternatives to Contenta Photo Converter are HyperFrames by HeyGen, ffmpeg-skill, ASTra, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/contenta-photo-converter
