Pixly MCP
Pixly gives AI assistants real-estate visual tools: virtualstaging, listing-photo enhancement, decluttering, day-to-night, plot signs, andcinematic property video — HD and watermark-free.
Connector → https://pixly.app/api/mcp · Setup & docs → pixly.app/mcp
Generations spend your normal Pixly credit balance — same pipeline, quality andpricing as the app, and every result also lands in your Pixly Library. There isno separate API plan to buy.
Tools
| Tool | Description |
|---|---|
virtual_staging |
Furnish and style an empty (or badly furnished) room photo in a chosen interior style |
edit_staged_photo |
Apply a specific change to a staged photo (swap the sofa, add a rug) while preserving the rest |
enhance_photo |
Turn an amateur listing photo into a finished professional one — returns 3 variants |
declutter_photo |
Remove clutter and personal items while keeping the room and architecture intact |
day_to_night |
Turn a daytime exterior into a magazine-style dusk scene, building and angle unchanged |
plot_sign |
Place a photorealistic 3D monument sign with your text onto a photo of an empty plot |
cinematic_motion |
Turn one listing photo into a short clip with a real camera move (orbit, fly-through, crane…) |
before_after_reel |
Animate a before→after transformation into a social-ready reveal video |
create_upload_ticket · upload_image_from_url |
Get photos in |
get_job · list_library · get_credit_balance |
Poll jobs, browse results, check credits |
Tools compose. One prompt can declutter the lived-in rooms, stage the emptyones, and cut the reveal reel from the result.
Connect
Claude, ChatGPT — no API key
Add https://pixly.app/api/mcp as a custom connector and sign in with yourPixly account. Claude: Settings → Connectors → Add custom connector. ChatGPT:Settings → Connectors → Advanced → Developer mode.
Claude Code, Cursor — API key
Create a key at pixly.app/app/settings, then:
claude mcp add -s user --transport http pixly https://pixly.app/api/mcp \
--header "Authorization: Bearer $PIXLY_API_KEY"
Cursor and Windsurf take the same endpoint in their MCP config, with anAuthorization: Bearer header.
Clients that only speak stdio
Pixly's server is remote (streamable HTTP). If your client cannot reach aremote server, bridge it with the communitymcp-remote:
npx mcp-remote https://pixly.app/api/mcp
CLI
The pixly command in this repo is a thin MCP client for the same endpoint —useful for scripts, CI, and coding agents that would rather run a command thanhold an MCP connection.
npm install -g pixly-cli
export PIXLY_API_KEY=pixly_sk_...
# Stage an empty room. Pass a URL, a local file, or an r2Path — local files
# upload automatically, straight off an iPhone included.
pixly stage living-room.jpg --style scandinavian
pixly stage IMG_4821.HEIC --style japandi
# One-click photo tools
pixly enhance photo.jpg
pixly declutter photo.jpg --out clean.jpg
pixly day-to-night exterior.jpg
pixly plot-sign lot.jpg --text "SOLD" --look stone
# Videos
pixly motion photo.jpg --move orbit --duration 5
pixly reel --before empty.jpg --after staged.jpg --reveal smooth
# Account
pixly balance
pixly jobs
pixly uploads # photos you have uploaded, with their r2Path
pixly tools # works with no API key
pixly help
Local files may be jpg, jpeg, png, webp, heic, heif, tif ortiff, up to 10 MB. HEIC is what an iPhone shoots by default; Pixly convertsnon-web formats server-side before any model sees them.
Results are written to the current directory (or --out <file>). Tools thatreturn several images (enhance gives you 3 to pick from) get -1, -2, …suffixes.
| Env var | Default | Description |
|---|---|---|
PIXLY_API_KEY |
— | Your API key, from Settings. Required for everything except pixly tools. |
PIXLY_MCP_URL |
https://pixly.app/api/mcp |
Endpoint override. |
Note on scope
This repository holds the connector manifest (server.json) and the CLI. TheMCP server itself is remote — it runs inside the Pixly application and is notopen source. Tool schemas are generated from a single registry in thatapplication and served over tools/list, which is why the CLI never hardcodesthem: run pixly tools and you get whatever the endpoint currently offers.
Links
License
MIT
