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, and property videos) directly from Claude, ChatGPT, Cursor, and any other MCP client.

npm version Official MCP registry

Add to Cursor

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_video polls server-side and returns the finished videoUrl inline (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