# pedra-ai/pedra-mcp [Health: Active]

**Category:** 🏠 Real Estate  
**Repository:** https://github.com/pedra-ai/pedra-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 1163  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pedra-ai-pedra-mcp

## Description
AI photo and video editing for real-estate listings via the Pedra API: virtual staging, renovation, room emptying, photo enhancement, sky replacement, object removal/blur, and property video generation. npx @pedra-ai/mcp

## Tools
Capabilities this server exposes over MCP:

- **pedra_enhance** — Improve lighting, color, sharpness
- **pedra_enhance_and_correct_perspective** — Enhance + straighten perspective
- **pedra_empty_room** — Remove all furniture/objects
- **pedra_furnish** — Virtually stage a room
- **pedra_renovation** — Renovate walls/floors/finishes
- **pedra_edit_via_prompt** — Edit from a natural-language prompt
- **pedra_sky_blue** — Replace a dull sky with clear blue
- **pedra_remove_object** — Remove an object using a mask
- **pedra_blur** — Blur faces, license plates, etc.
- **pedra_create_video** — Render a property video from images
- **pedra_update_video** — Edit a video without re-rendering unchanged clips
- **pedra_generate_voice_script** — Write a voiceover script from property photos
- **pedra_generate_voice** — Turn a script into a voiceover audio track
- **pedra_music_library** — List background-music tracks, voice languages + narration voices
- **pedra_list_properties** — List the account's properties
- **pedra_list_property_images** — List a property's photos (or, with `type: "360"`, its 360° photos) as URLs
- **pedra_create_property** — Create a property
- **pedra_add_images_to_property** — Add photos (or, with `type: "360"`, 360° photos) to a property by URL, optionally with `names
- **pedra_add_local_panoramas** — Local only:** upload 360° photo files from this computer into a property
- **pedra_create_upload_link** — No-login page to upload photos or 360° photos from a phone or computer (`type: "360"` for tours only)
- **pedra_create_virtual_tour** — Build a hosted 360° virtual tour (AI names and links the rooms)
- **pedra_get_virtual_tour** — Tour status, share link, embed code, scenes, links
- **pedra_list_virtual_tours** — List the account's virtual tours
- **pedra_update_virtual_tour** — Rename, reorder, remove rooms, re-link, restyle (free)
- **pedra_add_virtual_tour_scenes** — Add rooms to the end of a tour
- **pedra_credits** — Read plan + remaining credits
- **pedra_feedback** — Thumbs up/down + optional credit-back
- **pedra_request_access** — Only without an API key:** email the user a link to create/allow their account
- **pedra_check_access** — Only without an API key:** check the request; once approved, every tool works for the session

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "pedra-mcp": {
    "command": "npx",
    "args": ["-y","@pedra-ai/mcp"],
    "env": {
      "PEDRA_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `PEDRA_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What pedra-ai/pedra-mcp does

The pedra-ai/pedra-mcp MCP server gives an MCP client access to Pedra's real-estate media API. Its tools cover image editing, property organization, video creation, voiceover generation, background-music discovery, and hosted 360° virtual tours. This makes it relevant to the 🏠 Real Estate category when an agent needs to prepare listing assets rather than only retrieve property data.

Photo tools can improve lighting, color, and sharpness; correct perspective; remove furniture; virtually furnish a room; renovate finishes; apply a natural-language edit; replace a dull sky; remove a masked object; or blur faces and license plates. Video tools render a property video, update one without re-rendering unchanged clips, create a voiceover script from property photos, and turn a script into audio. Property and tour tools manage galleries, uploads, scenes, links, and tour presentation settings.

## How it works

The server exposes one MCP tool for each Pedra API endpoint. Most image and video operations are blocking calls that return the resulting asset URL or URLs, so the client does not need to poll job IDs. Virtual-tour creation is different: `pedra_create_virtual_tour` returns a tour ID, and `pedra_get_virtual_tour` can be called until the tour is ready. Tour responses can include a share link, embed code, scenes, and scene links.

Image inputs can be public HTTPS URLs, data URIs, or absolute local file paths. Local files are read and sent as base64; supported formats include common raster formats, HEIC/HEIF, and AVIF, with a 40 MB limit. An image pasted directly into chat is not automatically a file path. For phone uploads, `pedra_create_upload_link` creates a temporary no-login page, after which uploaded images can be listed and used in later operations.

## Setup and configuration

The pedra-ai/pedra-mcp MCP server is published as `@pedra-ai/mcp` and runs over stdio. Start it with `npx -y @pedra-ai/mcp`, or install the package globally and run `pedra-mcp`. Set `PEDRA_API_KEY` to the key from the Pedra account settings. Claude Desktop and Cursor can run the same npx command from their MCP configuration; the repository also documents installation through Smithery.

A key is optional for initial access. Without one, the server provides `pedra_request_access`, which emails an account-creation or approval link, and `pedra_check_access`, which checks confirmation. The link is valid for 30 minutes, and confirmation is required before the remaining tools become available for the session. The resulting key is kept in memory until configured as `PEDRA_API_KEY`.

## Tools and capabilities

- Edit listing photos with enhancement, perspective correction, staging, renovation, sky replacement, prompt-based edits, object removal, and blur.
- Create and revise property videos, then generate narration scripts, voice tracks, and music or voice options.
- Create properties, add image or 360° image URLs, list galleries, and upload local panoramas.
- Generate, inspect, list, and update hosted virtual tours, including room order, links, names, scenes, and styling.
- Read remaining credits and submit positive or negative feedback, with optional credit-back.

## Limitations and notes

The free plan allows 30 externally stored images per day and five upload links; paid plans allow 500 images and 50 upload links. Limits reset at midnight UTC, and exceeded uploads fail without storing the files. Upload links support up to 100 files and remain available for 24 hours. The `type: "360"` option is used for 360° photos and tours. Image-editing tools can save results to a property gallery when given a property ID, and can preserve the input's exact dimensions when requested.

_Full upstream README: https://allmcps.com/mcp/pedra-ai-pedra-mcp/readme_