Skip to Content
PropertyPixel Docs

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.

ToolWhat it doesRESTAccessHints
get_accountWorkspace, access level, credit balance and plan.GET /accountreadread-only
list_projectsList projects in the workspace.GET /projectsreadread-only
get_projectOne project with its photos and upload-link status.GET /projects/{id}readread-only
create_projectCreate an empty project for a listing.POST /projectswrite
delete_projectDelete a project with its photos and results.DELETE /projects/{id}writedestructive
add_photosAdd photos from https URLs or ChatGPT attachments.POST /projects/{project_id}/photoswriteopen-world
delete_photosDelete photos and everything made from them.POST /projects/{project_id}/photos/deletewritedestructive
create_upload_linkA link and QR code to upload photos from a phone.POST /projects/{project_id}/upload-linkswrite
list_edit_optionsEvery enhancement and staging style, with costs.GET /edit-optionsreadread-only
enhance_photosApply AI edits to photos. Spends credits.POST /enhancementswrite
stage_photosVirtually stage rooms. Spends credits.POST /stagingswrite
get_recommendationsFree suggested edits per photo.POST /recommendationswrite
apply_recommendationsRun suggested edits. Spends credits.POST /recommendations/applywrite
get_job_statusProgress and results for up to 100 jobs.GET /jobs?ids=readread-only
show_resultsA project's finished and in-progress results (opens the gallery widget).GET /projects/{id}/resultsreadread-only
pick_resultsMark or unmark a result as a pick.PATCH /jobs/{id}/pickread
get_download_linkDownload links for results, one file or a zip.POST /downloadsreadread-only
get_downloadCheck a zip being prepared.GET /downloads/{id}readread-only

Listing videos

ToolWhat it doesRESTAccessHints
list_listing_video_optionsTemplates, formats, camera moves, transitions, music, voices and credit costs.GET /listing-video-optionsreadread-only
list_listing_videosA project's listing videos.GET /listing-videos?project_id=readread-only
get_listing_videoOne video: clips, settings, AI clip status and rendered files with download links.GET /listing-videos/{id}readread-only
create_listing_videoA free draft from 2–30 of a project's photos in a template. Every clip starts as a still photo.POST /listing-videoswrite
edit_listing_videoApply edit ops (order, length, captions, template, music, voiceover, cards…). Can spend credits.POST /listing-videos/{id}/editswrite
generate_listing_video_aiTurn still clips into AI video, or remake AI clips. Spends credits.POST /listing-videos/{id}/ai-videowrite
export_listing_videoRender MP4s (portrait, landscape or square) of the current version.POST /listing-videos/{id}/exportswrite

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.

PromptWhat it doesArguments (all optional)
prepare_listingBrings photos in, fixes what each one needs and stages empty rooms, after agreeing a plan with you.project
stage_empty_roomsFinds the empty rooms in a listing and stages them in one design style.project, style
make_listing_videoPicks a template, creates a draft video, generates AI motion after your OK, and exports the MP4.project, template