Pedra MCP logo

Pedra MCP

by pedra-ai

Edit real-estate photos, create property videos, and build hosted 360° tours through the Pedra API over MCP.

Install Pedra MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "pedra-ai-pedra-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pedra-ai/mcp"
      ],
      "env": {
        "PEDRA_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The pedra-ai/pedra-mcp MCP server connects MCP clients to the Pedra API for real-estate photo editing, property media, and hosted 360° virtual tours. It exposes one tool per API endpoint, with image and video operations returning final asset URLs in a single blocking call; tour creation runs asynchronously and is checked by ID. Use it when an agent needs to enhance, stage, renovate, organize, or publish property media. The server runs over stdio through npx and can use a Pedra API key or an email-based access flow when no key is configured.

Use cases

  • Stage empty listing rooms virtually
  • Improve and straighten property photos
  • Create narrated property videos
  • Build hosted 360° virtual tours
  • Organize property photos and panoramas

Key features

  • AI real-estate photo editing
  • Property video rendering and updates
  • Voiceover script and audio generation
  • Hosted 360° virtual tours
  • Property gallery and upload management
  • Local image and panorama support

Tools29

What Pedra MCP lets your agent do. Expand a tool for its parameters.

Self-reported~490 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/20 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @pedra-ai/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads1.2kPackage downloads in the last 30 days.
Last commit11d agoMost recent push to the default branch.
Tools exposed29Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Pedra MCP works

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.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Pedra MCP

pedra-ai/pedra-mcp is an MCP server that connects AI clients to the Pedra API. Its main tools edit real-estate photos, create and update property videos, generate voiceovers, manage property images, and build hosted 360° virtual tours. It runs over stdio, typically through npx, and authenticates with PEDRA_API_KEY.

Install it by running `npx -y @pedra-ai/mcp` from an MCP client configuration. Set `PEDRA_API_KEY` in the server environment, or install the npm package globally and run `pedra-mcp`.

Yes, pedra-ai/pedra-mcp works with Cursor through its `.cursor/mcp.json` configuration. Add an MCP server that runs `npx` with `-y` and `@pedra-ai/mcp`, then provide the Pedra API key through the `PEDRA_API_KEY` environment variable.

Yes, its image tools accept absolute local file paths and inline the files as base64 before sending them to Pedra. Supported formats include JPG, PNG, WebP, GIF, BMP, TIFF, HEIC, HEIF, and AVIF, with a maximum file size of 40 MB.

Create or upload a property, add 360° photos using `type: "360"`, and call `pedra_create_virtual_tour`. The tool returns a tour ID while processing continues; call `pedra_get_virtual_tour` to check status and retrieve the share link, embed code, scenes, and links when ready.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPedra MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/pedra-ai-pedra-mcp?style=directory)](https://allmcps.com/mcp/pedra-ai-pedra-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/pedra-ai-pedra-mcp"><img src="https://allmcps.com/api/badge/pedra-ai-pedra-mcp?style=directory" alt="Pedra MCP on AllMCPs" /></a>