MCP 服务器

Pixly MCP

Provides AI assistants with real-estate visual tools including virtual staging, photo enhancement, decluttering, day-to-night conversion, plot signs, and cinematic property videos via the Pixly API.

README

Pixly MCP

Pixly gives AI assistants real-estate visual tools: virtual staging, listing-photo enhancement, decluttering, day-to-night, plot signs, and cinematic 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 and pricing as the app, and every result also lands in your Pixly Library. There is no 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 empty ones, 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 your Pixly 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 an Authorization: Bearer header.

Clients that only speak stdio

Pixly's server is remote (streamable HTTP). If your client cannot reach a remote server, bridge it with the community mcp-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 than hold 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 or tiff, up to 10 MB. HEIC is what an iPhone shoots by default; Pixly converts non-web formats server-side before any model sees them.

Results are written to the current directory (or --out <file>). Tools that return 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. The MCP server itself is remote — it runs inside the Pixly application and is not open source. Tool schemas are generated from a single registry in that application and served over tools/list, which is why the CLI never hardcodes them: run pixly tools and you get whatever the endpoint currently offers.