Skip to content
Photoroom MCP for Cursor

Image editing MCP server for Cursor

Add Photoroom to Cursor's mcp.json and the agent can relight product photos, cut them out, add shadows and more for the platform or app you're building, without leaving the editor.
Cursor's agent asking Photoroom to relight seller photos of a vase and a ring and put them on white

Add Photoroom to Cursor

One entry in mcp.json and a sign-in. There's no client ID or secret to add.
The Photoroom entry in the global Cursor mcp.json file (API connector address)
Every project

Add this to ~/.cursor/mcp.json:

{"mcpServers": {"photoroom": {"url": "https://mcp.photoroom.com/mcp-api" } } }

The Photoroom entry in a project's .cursor/mcp.json file (API connector address)
One project

Put the same entry in .cursor/mcp.json inside the project, and Photoroom loads only there.

Cursor showing the Photoroom MCP server waiting for sign-in
Sign in

Sign in to your API space when Cursor asks. With Pro, Max or Ultra, use https://mcp.photoroom.com/mcp as the url instead. The server then shows on the Customize page, where you manage your MCP servers.

Trusted by leading companies

API connector or Photoroom MCP: which to connect

Your Photoroom plan decides it, not the editor you use. Not on a plan yet? Pick by the work: building edits into your own product or pipeline suits an API plan, and asking for images as you need them suits Pro, Max or Ultra.

API connector, for API subscriptions

Connect while signed in to your API space, and Cursor's agent calls the Photoroom API with your key, on your API credits. It's the route for the listing flow or app you're building.

Photoroom MCP, for Pro, Max and Ultra

Cursor's agent gets the Photoroom app's tools: cutouts, shadows, ghost mannequin, virtual try-on and more, on your plan's credits, with no API key to manage.

Enterprise, for catalog-scale teams

On an Enterprise plan, how you connect depends on your contract, which your account team will decide with you. Enterprise can also add tailored multi-tool workflows and checks on every output.

Cursor image editing with Photoroom tools

Relighting, background removal, AI shadows, product staging and more, called by Cursor's agent when you ask for the edit.

Photoroom MCP

Connect the Photoroom MCP to the LLM where you work and automate your product listing visuals.

Background Removal

The AI background removal API detects complex edges, handles transparency, and delivers clean cutouts at scale - ideal for product catalogs and marketplace listings.

Virtual Model

Place apparel and accessories on AI-generated models that match your brand aesthetic. On-model imagery via the Virtual Model API: no casting, no studio, no production timelines.

Flat Lay

Generate consistent, editorial-quality flat lay product photography at enterprise scale. Maintain visual identity across thousands of SKUs through the Flat Lay API.

Ghost Mannequin

Produce ghost mannequin apparel shots with perfect shape retention through an AI-powered Ghost Mannequin API endpoint. Scale invisible mannequin photography without a studio.

Product Staging

Place your product into realistic lifestyle scenes - held, worn, or displayed - with the natural lighting and composition of a high-end photoshoot.

Edit With AI

Describe any change in plain language and our AI makes it - swap colors, remove or add objects, restage the scene, or shift the camera angle.

Product Beautifier

Enhance low-quality product and food images automatically with the Beautifier API. No retouchers, no studios. Our AI restores detail, corrects color, and improves overall quality at scale.

Add Shadows

Add realistic shadows to the main subject of your image, with complete control over the softness, intensity and position of the shadow.

Generate Backgrounds

Dynamically create new backgrounds with our first-class generative AI, perfectly matching the subject of the original picture.

Relighting

Fix badly lit photos automatically. Our AI rebalances over- and under-exposed images, with modes that keep product colors accurate or optimize for portraits.

Text Removal

Remove watermarks, labels, and real-world signage from your images automatically - choose what goes and what stays.

Expand

Resize any image to any format without cropping. Our AI generates the extra background to match the original, filling every empty pixel seamlessly.

Uncrop

Recover subjects clipped by the frame. Our AI reconstructs the missing parts from the visible portion, automatically.

Ironing

Make every garment look freshly pressed. Our AI smooths creases and wrinkles out of clothing photos automatically - no steamer, no reshoot.

Create Any Image

Generate images from a text description alone - no source photo needed. Describe the scene, pick a format, and get original content back.

Uncertainty Score

Know when a cutout needs a second look. Every response returns a confidence score from 0 to 1, so you can auto-flag ambiguous images for review at scale.

Perspective Correction

Straighten angled shots of flat, rectangular products - cards, books, games - into clean, straight-on views. No generative AI, so hallucinations are impossible by design.

Positioning

Control exactly where the subject sits in the result - scaling, alignment, padding, and margins - so every image in a catalog comes out consistently framed.

Smart Cropping

Reframe images around the subject automatically - prompt it to focus on a specific element, or crop faces out for marketplace compliance.

Upscale

Turn small, low-res images into sharp ones at 4× the size - with a fast mode for volume and a slow mode for maximum quality.

Product images for what you're building

Photoroom does the editing and Cursor's agent asks for it, so the images and the code move forward together.
Three dark seller photos of ankle boots on a cluttered floor, relit on white with soft shadows

Seller photos that make your listing flow look broken

The listing flow you're building gets whatever photos sellers upload: dark, cluttered, shot on a kitchen table. Ask Cursor to have Photoroom relight them and add a soft shadow on white, without opening a design tool.

Earrings catalog page with six styles of earrings on matching light tiles

Product cards that line up in your layout

Building a product grid or a listing page? Ask for the same background, shadow and framing on every product image, so the cards look like one catalog in the design you're coding.

App upload code calling the Photoroom API for white background, relighting and soft shadow

The same edits, built into your app

When your app needs to edit images on every upload, our docs page for coding agents has a ready-made prompt with the Photoroom API's endpoints and settings. Give it to Cursor's agent with the result you want, and it writes the integration code.

Results from teams already editing with Photoroom

4x

faster market rollouts

89%

lower image processing costs

56%

higher conversion on listings

236%

increase in average order value

Exclusive to Enterprise plans

When the listing flow you built goes to production

For platforms where sellers upload at volume, Enterprise plans can add an editing workflow built for your listing flow and a check on every output.
Collage of a beige duffel bag with green straps, showing its exterior, spacious interior with pockets, and a hand holding it.
Visual Agents
Visual Agents execute the perfect workflow for your use case. They analyze every input, generate and edit, score the output, retry until it passes. Every visual runs the same loop and only the ones that pass reach your catalog.
Three images of a woman in a yellow blazer, each with a completion score: 83%, 92%, and 100% labeled as "Best fidelity."
Visual QA
Even the best AI models get it wrong, so Visual QA scores every output for fidelity, catches the misses, and corrects the details before they reach your customers.
Collage of a woman in a white halter dress, a bowl of vibrant poke, and a woman holding a mustard handbag with hoop earrings.
Enterprise Guarantee
Pay only for outputs that pass. Every output is checked against your brief by our fidelity model, and anything that misses is regenerated before it reaches your team.
Four fashion items with play icons: a brown handbag, sage green mule, person in a gray shirt and cardigan, and white sneakers with orange accents.
Image to Video API
The Image to Video API turns static product photography into short-form video automatically. Submit a product image and receive a polished video with natural camera motion, animation, or configured effects.
Photoroom MCP

Better product photos without leaving Cursor

Add one server with your API plan and give your listing flow, product grid or storefront product images that look ready to sell.

Frequently asked questions

How do I add an image editing MCP server to Cursor?

Add Photoroom to Cursor's mcp.json: put the entry below in ~/.cursor/mcp.json for every project, or in .cursor/mcp.json for one project, then sign in to your API space when Cursor asks. With Pro, Max or Ultra, use https://mcp.photoroom.com/mcp as the url instead. Cursor's agent can then call Photoroom's editing tools.

{
  "mcpServers": {
    "photoroom": {
      "url": "https://mcp.photoroom.com/mcp-api"
    }
  }
}

Do I add headers or a client secret to mcp.json?

No. The entry only needs the url. Cursor registers itself with the Photoroom server (dynamic client registration) and signs in with PKCE, so there's no client ID, secret or header to add.

Which Photoroom tools can Cursor's agent use?

Cursor's agent can call Photoroom editing tools. For product images in a build that means relighting, AI shadows, background removal, product staging and more.

Should my app use the MCP or the Photoroom API?

In Cursor, the MCP is for edits you request mid-build, and the API is what your finished app calls on each upload; the MCP or API guide walks through the choice.

Which plan do I need?

With an API subscription, use mcp.photoroom.com/mcp-api, as in the setup above. With Pro, Max or Ultra, use mcp.photoroom.com/mcp. Edits through mcp.photoroom.com/mcp use Pro, Max or Ultra credits, and edits through mcp.photoroom.com/mcp-api use API credits from a separate API subscription. API prices are on the API pricing page. On an Enterprise plan? Talk to your account team.

Which image files can I send from my project?

JPEG, PNG or WebP files of 30 MB or less, with the longest side at 5,000 px or under. Save transparent cutouts as PNG or WebP. The docs list every setting.

Which other apps can use the Photoroom MCP?

Outside Cursor, you can connect it in Claude Code with a terminal command or in Codex from its CLI, app or IDE extension. See the full list on the Photoroom MCP page.

Where can I get help?

Visit the Photoroom Help Center for app, plan and account questions. Enterprise customers can contact their account team.

Using the API connector or building with the API? Join our API community to get help from our engineers, or check the troubleshooting page for common issues.

Start selling at first sight

Get listing-ready product visuals in seconds.