# ImagePrep360 MCP guide

Human guide: https://imageprep360.com/mcp
MCP endpoint: https://imageprep360-mcp.vercel.app/mcp
Transport: Streamable HTTP for hosted clients, stdio for desktop clients.

## Hosted setup

Anyone can look up recipes and plan a crop. A registered ChatGPT connector also lets you sign in to ImagePrep360 and turn an attached photo into a PNG.

1. If your workspace already has the ImagePrep360 connector, select it in a chat. Ask which recipes work on wood. To prepare a photo, attach it, request a PNG, then follow the sign-in and consent prompts.
2. To add a catalog-only connection, open Plugins in ChatGPT, choose Add custom MCP server, paste the server URL and choose No authentication.
3. For a new connection that can prepare images, your workspace administrator needs an ImagePrep360 OAuth client registered for that connector’s exact callback URL. Use the assigned client ID and PKCE (S256). Public clients use no client secret.

## Desktop setup

Install Node.js 20 or later and extract https://imageprep360.com/mcp/imageprep-mcp.zip. Add this to your client's MCP settings. Replace both paths, select an existing working folder, and restart the client.

```json
{
  "mcpServers": {
    "imageprep360": {
      "command": "node",
      "args": [
        "/absolute/path/imageprep-mcp.cjs",
        "--workspace",
        "/absolute/path/to/photos"
      ]
    }
  }
}
```

## Tools

- list_recipes — Lists recipe IDs, materials, physical sizes and DPI. Local and hosted.
- plan_engraving — Calculates the crop and output dimensions from the source width and height. Local and hosted.
- prepare_png — Returns a processed PNG from an image attachment or base64 input. Local or authenticated hosting.
- prepare_file — Reads a file in your chosen folder and saves a uniquely named engraving PNG. Local with a working folder.

## Try it

- Which recipes work for a photo on wood?
- For a 4,000 × 3,000 photo, what crop and pixel dimensions would the wood-photo-6x4 recipe use?
- Prepare cat.jpg in my working folder with wood-photo-6x4 and save the PNG.

## File handling

PNG and JPEG inputs can be up to 3 MiB. Input and output can each contain up to 8 megapixels. Local file processing reads the configured folder and preserves previous exports. Your assistant receives the tool results. The hosted catalog takes recipe names and dimensions. ImagePrep360 MCP does not operate a laser or use Google Drive.
