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, staging style and video option, 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
create_videoTurn 1–9 photos into a video. Spends credits.POST /videoswrite
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

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.html) in clients that support MCP Apps: confirm cards, a live results gallery with before/after comparison, picks and downloads, a video player, photo upload, and an edit picker. Clients without widgets get the same information as text and structured content.