MCP server

Edit and generate photos from your AI assistant

Add AI Photo Editor to Claude, ChatGPT, Cursor or any MCP client. Ask in plain language, and the assistant creates images, edits photos, removes backgrounds and upscales results with your account credits.

Server URLhttps://aiphotoeditor.io/api/mcp

What your assistant can do

Generate images

Turn a text prompt into an image with Nano Banana Pro, GPT Image 2, Seedream, Flux and more.

Edit photos

Change backgrounds, outfits, lighting or style, remove objects and restore old photos while keeping the parts you want.

Remove backgrounds

Cut out people and products into transparent PNGs for listings, slides and designs.

Upscale images

Increase resolution and sharpen details before printing or publishing.

Check models and credits

The assistant can compare models, show each price and check your balance before it starts.

Use local files

Coding agents such as Claude Code and Cursor can upload a local image first and then edit it.

How it works

  1. 1

    Add the server

    Paste the server URL into your AI client as a remote MCP server or connector.

  2. 2

    Sign in and approve

    Your browser opens AI Photo Editor. Sign in with Google or email and allow the connection.

  3. 3

    Ask for images

    Describe what you need. Results are saved to your account and also appear in My Generations.

Setup guides

Every client below signs in with OAuth, so you never paste a password or API key. Menu names can differ slightly between app versions.

Claude (web & desktop)⌄
  1. Open Settings → Connectors and choose Add custom connector.
  2. Name it AI Photo Editor and paste the server URL.
  3. Click Connect, sign in to AI Photo Editor and approve access.
  4. In a chat, enable the connector from the tools menu and ask for an image.
Server URL
https://aiphotoeditor.io/api/mcp
Claude Code⌄
  1. Run the command below in your terminal.
  2. Start Claude Code, type /mcp, select aiphotoeditor and choose Authenticate.
  3. Approve access in the browser window, then return to the terminal.
Terminal
claude mcp add --transport http aiphotoeditor https://aiphotoeditor.io/api/mcp
ChatGPT⌄
  1. Open Settings → Apps & Connectors. Under Advanced settings, turn on Developer mode if your plan offers it.
  2. Create a new connector, paste the server URL and choose OAuth authentication.
  3. Sign in to AI Photo Editor, approve access and select the connector in a new chat.
Server URL
https://aiphotoeditor.io/api/mcp
Cursor⌄
  1. Open Cursor Settings → MCP, or edit the file shown below.
  2. Add the aiphotoeditor server and save.
  3. Click Login next to the server and approve access in the browser.
~/.cursor/mcp.json
{
  "mcpServers": {
    "aiphotoeditor": {
      "url": "https://aiphotoeditor.io/api/mcp"
    }
  }
}
VS Code (GitHub Copilot)⌄
  1. Create .vscode/mcp.json in your project, or run MCP: Add Server from the Command Palette.
  2. Add the configuration below and start the server.
  3. Allow VS Code to sign in, approve access in the browser, and use the tools in Copilot agent mode.
.vscode/mcp.json
{
  "servers": {
    "aiphotoeditor": {
      "type": "http",
      "url": "https://aiphotoeditor.io/api/mcp"
    }
  }
}
Windsurf⌄
  1. Open the MCP settings in Cascade, or edit the file shown below.
  2. Add the aiphotoeditor server and refresh the server list.
  3. Approve access in the browser when Windsurf asks you to sign in.
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "aiphotoeditor": {
      "serverUrl": "https://aiphotoeditor.io/api/mcp"
    }
  }
}
Other clients⌄
  1. If your client supports remote MCP servers with OAuth, add the server URL directly.
  2. If it only supports local (stdio) servers, use mcp-remote with Node.js 18 or later as shown below.
  3. The first call opens your browser to sign in and approve access.
mcp-remote
{
  "mcpServers": {
    "aiphotoeditor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://aiphotoeditor.io/api/mcp"
      ]
    }
  }
}

Available tools

Tools that create images use the same credits as the website. Failed tasks return their credits automatically.

ToolWhat it does
generate_imageCreate an image from a text prompt. Choose the model, aspect ratio and quality.
edit_imageEdit up to 10 input images with an instruction, such as a new background, outfit or style.
remove_backgroundReturn the subject on a transparent background.
upscale_imageIncrease resolution and sharpen details.
get_taskCheck a running task and return the result image links.
list_modelsList models, supported settings and the credit price for your account.
get_credit_balanceShow your available credits.
create_upload_urlCreate a temporary upload link for a local PNG, JPEG or WebP file.

Try asking

  • “Generate a 16:9 cozy coffee shop interior in warm morning light with Nano Banana Pro.”
  • “Remove the background from this product photo: https://example.com/shoe.jpg”
  • “Put the person in this photo on a beach at sunset and keep the face unchanged.”
  • “Upload ./images/old-photo.jpg, restore the scratches and upscale the result.”
  • “How many credits do I have, and what does a 4K image cost?”

FAQ

Does the MCP server cost extra?⌄

No. Connecting is free, and each image uses the same credits as on the website. Ask the assistant to run list_models to see current prices for your account.

Do I need an API key?⌄

No. Your AI client opens AI Photo Editor in the browser, you sign in and approve, and the client receives a token that refreshes automatically.

How do I use images from my computer?⌄

Chat apps like Claude and ChatGPT need a public image link. Coding agents such as Claude Code and Cursor can call create_upload_url, upload the file and then edit it.

Where are my results saved?⌄

Results are hosted by AI Photo Editor. The assistant returns the links, and the images also appear in My Generations on the website.

How do I disconnect?⌄

Remove the server or connector in your AI client. Access tokens expire after one hour and stop refreshing once the connection is removed.

Can I create videos through MCP?⌄

Not yet. The MCP server covers image generation and editing. Use the AI Video Generator on the website for videos.