pedra-ai/pedra-mcp

Official Model Context Protocol server for the Pedra API — use Pedra's AI real-estate photo editing (virtual staging, renovation, room emptying, enhancement, sky replacement, object removal/blur, property videos, and hosted 360° virtual tours) directly from **Claude, ChatGPT, Cursor**, and any other MCP client.
It exposes **one tool per API endpoint**. Each photo and video tool is a single blocking call that returns the final asset URL(s) — there are no job IDs to poll. Virtual tours build in the background: pedra_create_virtual_tour returns a tourId, and pedra_get_virtual_tour is polled until it's ready.
Quick start
The server reads your Pedra API key (Settings in your Pedra account) from the PEDRA_API_KEY environment variable. No account yet? Start it without a key — see No Pedra account yet?.
The server runs over stdio and is published to npm, so most clients just run it with npx — no global install needed.
Claude Desktop (one-click)
Download the latest **pedra-mcp.mcpb** from Releases and double-click it (or drag it into Claude Desktop → Settings → Extensions). Claude installs the bundled server and prompts for your PEDRA_API_KEY — no JSON editing.
Claude Desktop (manual)
Or add this to your claude_desktop_config.json (Settings → Developer → Edit Config):
Cursor
In ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
Any MCP client
Run the binary directly with the key in the environment:
Or install it:
Smithery
You can also install and configure Pedra automatically via Smithery:
(swap claude for cursor, windsurf, etc.) Smithery prompts for your PEDRA_API_KEY and writes the client config for you.
No Pedra account yet?
Start the server without PEDRA_API_KEY, for example in Claude Code:
Then just ask for something ("stage this photo with Pedra"). Without a key the server adds two tools, and the assistant does the rest:
1. pedra_request_access with your email. Pedra emails you a link (valid 30 minutes): a new account chooses a password there, an existing one clicks **Allow**. Nothing is created until you click, and you can decline.
2. pedra_check_access until you've confirmed. Once approved, every Pedra tool works for the rest of the session. The key is kept in memory only, never written to disk; the tool result shows it along with how to keep it: add it as PEDRA_API_KEY to the server's env (e.g. claude mcp add pedra -e PEDRA_API_KEY= -- npx -y @pedra-ai/mcp, or paste it into the extension's settings in Claude Desktop).
Until then, the other tools answer "No API key yet: call pedra_request_access with the user's email". Inbox confirmation is required, disposable email domains are refused, and requests are rate-limited. New accounts start with Pedra's free trial credits.
(In ChatGPT and claude.ai, use Pedra's hosted connector instead: connecting it runs a sign-in where new users can create an account.)
Tools
The nine image-editing tools (enhance through blur) also take propertyId, to save the result into that property's gallery, and name, to save the original photo there under that name in the same call. The result then includes source (imageId, name) of the original. preserveAspectRatio returns the result at the input's exact size.
| Tool | Endpoint | What it does |
|------|----------|--------------|
| pedra_enhance | /enhance | Improve lighting, color, sharpness |
| pedra_enhance_and_correct_perspective | /enhance_and_correct_perspective | Enhance + straighten perspective |
| pedra_empty_room | /empty_room | Remove all furniture/objects |
| pedra_furnish | /furnish | Virtually stage a room |
| pedra_renovation | /renovation | Renovate walls/floors/finishes |
| pedra_edit_via_prompt | /edit_via_prompt | Edit from a natural-language prompt |
| pedra_sky_blue | /sky_blue | Replace a dull sky with clear blue |