Pedra MCP Server
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, and property videos) directly from Claude, ChatGPT, Cursor, and any other MCP client.
It exposes one tool per API endpoint. Each tool is a single blocking call that returns the final asset URL(s) — there are no job IDs to poll.
Quick start
You need a Pedra API key — get one from your Pedra account. The server reads it from the PEDRA_API_KEY environment variable.
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):
{
"mcpServers": {
"pedra": {
"command": "npx",
"args": ["-y", "@pedra-ai/mcp"],
"env": { "PEDRA_API_KEY": "your-api-key" }
}
}
}
Cursor
In ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"pedra": {
"command": "npx",
"args": ["-y", "@pedra-ai/mcp"],
"env": { "PEDRA_API_KEY": "your-api-key" }
}
}
}
Any MCP client
Run the binary directly with the key in the environment:
PEDRA_API_KEY=your-api-key npx -y @pedra-ai/mcp
Or install it:
npm install -g @pedra-ai/mcp
PEDRA_API_KEY=your-api-key pedra-mcp
Smithery
You can also install and configure Pedra automatically via Smithery:
npx -y @smithery/cli install @pedra-ai/mcp --client claude
(swap claude for cursor, windsurf, etc.) Smithery prompts for your PEDRA_API_KEY and writes the client config for you.
Tools
| 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 |
pedra_remove_object | /remove_object | Remove an object using a mask |
pedra_blur | /blur | Blur faces, license plates, etc. |
pedra_create_video | /create_video | Render a property video from images |
pedra_update_video | /update_video | Edit a video without re-rendering unchanged clips |
pedra_generate_voice_script | /generate_voice_script | Write a voiceover script from property photos |
pedra_generate_voice | /generate_voice | Turn a script into a voiceover audio track |
pedra_music_library | /music_library | List background-music tracks + voice languages |
pedra_list_properties | /list_properties | List the account's properties |
pedra_list_property_images | /list_property_images | List a property's photos as URLs |
pedra_create_property | /create_property | Create a property |
pedra_add_images_to_property | /add_images_to_property | Add photos to a property by URL |
pedra_credits | /credits | Read plan + remaining credits |
pedra_feedback | /feedback | Thumbs up/down + optional credit-back |
Most image tools take an imageUrl plus a few optional parameters; see each tool's input schema in your MCP client. The imageUrl (and maskUrl, and each create_video frame) accepts any of:
- a public
https://URL, - a
data:URI, or - an absolute path to a local image file — the server reads it off disk and inlines it as base64 for you, so you can point a tool at a file you just dragged in without hosting it first (
.jpg,.jpeg,.png,.webp,.gif,.bmp,.tif/.tiff,.heic/.heif,.avif; up to 40 MB).
Note: an image pasted into the chat is not a file path, so it can't be forwarded to the tool — drag in a file, or save the paste and pass its path.
Example prompts once connected:
"Use Pedra to virtually stage https://example.com/empty-living-room.jpg as a minimalist living room."
"Virtually stage /Users/me/Desktop/empty-living-room.jpg as a minimalist living room."
"How many Pedra credits do I have left?"
How it works
This server is a thin wrapper over @pedra-ai/sdk, which encodes the API's contract details:
- Synchronous by design. Every endpoint blocks and returns the final URL(s) in the response body. Even
pedra_create_videopolls server-side and returns the finishedvideoUrlinline (it can take up to ~10 minutes; the API keeps the connection alive with a heartbeat). - Errors are tool errors. The API's 4xx responses (insufficient credits, bad image, …) come back as MCP tool errors with a readable message, not crashes.
Privacy Policy
This server sends the image/video URLs and parameters you pass to the Pedra API to perform the requested edit, authenticated with your PEDRA_API_KEY. It stores no data itself. Data collection, usage, storage, retention, third-party sharing, and contact information are covered by Pedra's privacy policy: https://pedra.ai/privacy.
License
MIT © Pedra