MCP tools
Every tool the PropertyPixel MCP server exposes.
Server URL: https://mcp.propertypixel.app (Streamable HTTP, OAuth). Each tool maps to one REST endpoint with the same inputs and outputs. See the API reference.
| Tool | What it does | REST | Access | Hints |
|---|---|---|---|---|
get_account | Workspace, access level, credit balance and plan. | GET /account | read | read-only |
list_projects | List projects in the workspace. | GET /projects | read | read-only |
get_project | One project with its photos and upload-link status. | GET /projects/{id} | read | read-only |
create_project | Create an empty project for a listing. | POST /projects | write | |
delete_project | Delete a project with its photos and results. | DELETE /projects/{id} | write | destructive |
add_photos | Add photos from https URLs or ChatGPT attachments. | POST /projects/{project_id}/photos | write | open-world |
delete_photos | Delete photos and everything made from them. | POST /projects/{project_id}/photos/delete | write | destructive |
create_upload_link | A link and QR code to upload photos from a phone. | POST /projects/{project_id}/upload-links | write | |
list_edit_options | Every enhancement and staging style, with costs. | GET /edit-options | read | read-only |
enhance_photos | Apply AI edits to photos. Spends credits. | POST /enhancements | write | |
stage_photos | Virtually stage rooms. Spends credits. | POST /stagings | write | |
get_recommendations | Free suggested edits per photo. | POST /recommendations | write | |
apply_recommendations | Run suggested edits. Spends credits. | POST /recommendations/apply | write | |
get_job_status | Progress and results for up to 100 jobs. | GET /jobs?ids= | read | read-only |
show_results | A project's finished and in-progress results (opens the gallery widget). | GET /projects/{id}/results | read | read-only |
pick_results | Mark or unmark a result as a pick. | PATCH /jobs/{id}/pick | read | |
get_download_link | Download links for results, one file or a zip. | POST /downloads | read | read-only |
get_download | Check a zip being prepared. | GET /downloads/{id} | read | read-only |
Listing videos
| Tool | What it does | REST | Access | Hints |
|---|---|---|---|---|
list_listing_video_options | Templates, formats, camera moves, transitions, music, voices and credit costs. | GET /listing-video-options | read | read-only |
list_listing_videos | A project's listing videos. | GET /listing-videos?project_id= | read | read-only |
get_listing_video | One video: clips, settings, AI clip status and rendered files with download links. | GET /listing-videos/{id} | read | read-only |
create_listing_video | A free draft from 2–30 of a project's photos in a template. Every clip starts as a still photo. | POST /listing-videos | write | |
edit_listing_video | Apply edit ops (order, length, captions, template, music, voiceover, cards…). Can spend credits. | POST /listing-videos/{id}/edits | write | |
generate_listing_video_ai | Turn still clips into AI video, or remake AI clips. Spends credits. | POST /listing-videos/{id}/ai-video | write | |
export_listing_video | Render MP4s (portrait, landscape or square) of the current version. | POST /listing-videos/{id}/exports | write |
A listing video goes: create_listing_video (free draft) → edit_listing_video (optional, free unless an op makes AI clips) → generate_listing_video_ai (quote, then confirm) → poll get_listing_video → export_listing_video → poll get_listing_video for download_url. Drafts with no AI video can't be exported, and an AI clip never goes back to a still photo. Edit calls take base_version (the version you last read) and are refused with 409 conflict if the video changed since.
REST-only endpoints: POST /quotes, POST /uploads, POST /uploads/{id}/complete and GET /jobs/{id}.
Spending tools
Calling a spending tool without quote_id returns a quote (object: "quote_required") and spends nothing. The assistant shows you the cost; once you confirm, it calls the tool again with the same arguments plus quote_id. In ChatGPT and Claude the confirm card does this for you. See Credits and quotes.
Widgets
Tools that show results render the PropertyPixel widget (ui://propertypixel/app-<hash>.html, versioned per release) in clients that support MCP Apps: confirm cards, a live results gallery with before/after comparison, picks and downloads, photo upload, and an edit picker. Clients without widgets get the same information as text and structured content.
Prompts
The server also offers guided prompts. Clients that support MCP prompts show them in their prompt or slash-command menu. Each one walks the assistant through the tools above, and every spend still waits for your confirmation.
| Prompt | What it does | Arguments (all optional) |
|---|---|---|
prepare_listing | Brings photos in, fixes what each one needs and stages empty rooms, after agreeing a plan with you. | project |
stage_empty_rooms | Finds the empty rooms in a listing and stages them in one design style. | project, style |
make_listing_video | Picks a template, creates a draft video, generates AI motion after your OK, and exports the MP4. | project, template |