# Pedra

> Pedra is an MCP server for design and media. Stage, renovate and enhance real-estate photos, plus videos and 360 tours. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI, Web
- **Website:** https://pedra.ai/api-documentation
- **Repository:** https://github.com/pedra-ai/pedra-mcp
- **MCP Registry name:** io.github.pedra-ai/pedra-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

The server maps one tool to each Pedra API endpoint. Photo and video tools are single blocking calls that return the final asset URLs, so there are no job IDs to poll. Virtual tours are the exception: `pedra_create_virtual_tour` returns a tour ID right away and `pedra_get_virtual_tour` is polled until the tour is ready. The API docs say image calls take roughly 10 to 30 seconds and video calls can block for up to 10 minutes.

The operations include furnishing empty rooms, emptying furnished ones, renovating floors and walls, editing a photo from a text prompt, removing or blurring objects, fixing light and perspective and replacing a grey sky. The wider API also covers floor plans and scheduling social posts.

An API key is read from `PEDRA_API_KEY`. Without one the server starts with `pedra_request_access` and `pedra_check_access`: the user confirms by emailed link, nothing is created until they click, and the key is kept in memory only. Disposable email domains are refused and requests are rate-limited. A Claude Desktop bundle is available for one-click install.

## Features

- **Virtual staging:** Furnish empty rooms in a chosen style, or empty furnished ones.
- **Photo transformation:** Renovate spaces, edit by prompt, remove or blur objects, enhance and correct perspective, and swap skies.
- **Listing videos:** Generate property videos from photos through the video endpoints.
- **Hosted 360 tours:** Create a tour, then poll for readiness before sharing it.
- **Self-service signup:** Without a key, the assistant requests access and the user confirms by email.
- **One tool per endpoint:** Each API endpoint is a separate tool returning final asset URLs.

## Good for

- Stage an empty living room in a minimalist style
- Show a property renovated before work starts
- Replace a grey sky in an exterior photo
- Turn listing photos into a short property video
- Build a 360 tour for a listing portal

## Install

### Claude Code (Terminal)

```sh
claude mcp add pedra-mcp --env PEDRA_API_KEY='<PEDRA_API_KEY>' -- npx -y @pedra-ai/mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pedra-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pedra-ai/mcp"
      ],
      "env": {
        "PEDRA_API_KEY": "<PEDRA_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `pedra_create_virtual_tour`: Start building a hosted 360 virtual tour and return a tour ID.
- `pedra_get_virtual_tour`: Poll a virtual tour until it is ready.
- `pedra_request_access`: Request an API key by email when none is configured.
- `pedra_check_access`: Check whether the user has confirmed the access request.

## FAQ

### Do I need a Pedra account first?

Not necessarily. Start without a key and the assistant can request access by email; the user must confirm before anything is created.

### Is the API key stored on disk?

The README says the key is kept in memory only and never written to disk.

### How are tours different from photo edits?

Photo and video tools return the final result in one call, while tours return an ID and are polled until ready.

### How is Pedra priced?

Subscription with credits: 1 credit per photo edit and 5 per animated clip, with 100 credits a month for 29 euros; new sign-ups get 7 credits, 1 free video and 1 free tour.

### Is Pedra free?

Pedra is a paid product with a free trial.

### How do I add Pedra to Claude Code?

Run this command in your terminal: claude mcp add pedra-mcp --env PEDRA_API_KEY='<PEDRA_API_KEY>' -- npx -y @pedra-ai/mcp

### What are the best alternatives to Pedra?

The closest alternatives to Pedra are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/pedra
