Pedra

Edición de fotos y videos de bienes raíces con IA — staging virtual, renovación, vaciado de habitaciones, mejora, reemplazo de cielo, eliminación de objetos y videos de propiedades — a través de la API de Pedra.

GitHub

Prueba este MCPPatrocinado

Documentación

Pedra MCP Server

Servidor oficial del Model Context Protocol para la Pedra API — usa la edición de fotos inmobiliarias con IA de Pedra (puesta en escena virtual, renovación, vaciado de habitaciones, mejora, reemplazo de cielo, eliminación/desenfoque de objetos y videos de propiedades) directamente desde Claude, ChatGPT, Cursor y cualquier otro cliente MCP.

Expone una herramienta por endpoint de API. Cada herramienta es una llamada de bloqueo única que devuelve la(s) URL(s) final(es) del recurso — no hay IDs de trabajo que consultar.

Inicio rápido

Necesitas una clave de API de Pedra — obtén una desde tu cuenta de Pedra. El servidor la lee de la variable de entorno PEDRA_API_KEY.

El servidor se ejecuta sobre stdio y está publicado en npm, por lo que la mayoría de los clientes solo lo ejecutan con npx — no se necesita instalación global.

Claude Desktop (un clic)

Descarga la última pedra-mcp.mcpb desde Lanzamientos y haz doble clic en ella (o arrástrala a Claude Desktop → Configuración → Extensiones). Claude instala el servidor incluido y te solicita tu PEDRA_API_KEY — sin editar JSON.

Claude Desktop (manual)

O añade esto a tu claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

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

Cursor

En ~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto):

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

Cualquier cliente MCP

Ejecuta el binario directamente con la clave en el entorno:

PEDRA_API_KEY=your-api-key npx -y @pedra-ai/mcp

O instálalo:

npm install -g @pedra-ai/mcp
PEDRA_API_KEY=your-api-key pedra-mcp

Smithery

También puedes instalar y configurar Pedra automáticamente mediante Smithery:

npx -y @smithery/cli install @pedra-ai/mcp --client claude

(cambia claude por cursor, windsurf, etc.) Smithery te solicita tu PEDRA_API_KEY y escribe la configuración del cliente por ti.

Herramientas

Tool	Endpoint	What it does
`pedra_enhance`	`/enhance`	Mejora iluminación, color y nitidez
`pedra_enhance_and_correct_perspective`	`/enhance_and_correct_perspective`	Mejora y endereza la perspectiva
`pedra_empty_room`	`/empty_room`	Elimina todos los muebles/objetos
`pedra_furnish`	`/furnish`	Amuebla virtualmente una habitación
`pedra_renovation`	`/renovation`	Renueva paredes/suelos/acabados
`pedra_edit_via_prompt`	`/edit_via_prompt`	Edita a partir de una instrucción en lenguaje natural
`pedra_sky_blue`	`/sky_blue`	Reemplaza un cielo apagado por un azul claro
`pedra_remove_object`	`/remove_object`	Elimina un objeto usando una máscara
`pedra_blur`	`/blur`	Desenfoca caras, matrículas, etc.
`pedra_create_video`	`/create_video`	Genera un video de la propiedad a partir de imágenes
`pedra_update_video`	`/update_video`	Edita un video sin volver a renderizar clips sin cambios
`pedra_generate_voice_script`	`/generate_voice_script`	Escribe un guion de voz en off a partir de fotos de la propiedad
`pedra_generate_voice`	`/generate_voice`	Convierte un guion en una pista de audio de voz en off
`pedra_music_library`	`/music_library`	Lista pistas de música de fondo + idiomas de voz
`pedra_list_properties`	`/list_properties`	Lista las propiedades de la cuenta
`pedra_list_property_images`	`/list_property_images`	Lista las fotos de una propiedad como URLs
`pedra_create_property`	`/create_property`	Crea una propiedad
`pedra_add_images_to_property`	`/add_images_to_property`	Añade fotos a una propiedad por URL
`pedra_credits`	`/credits`	Lee el plan + créditos restantes
`pedra_feedback`	`/feedback`	Pulgar arriba/abajo + devolución de crédito opcional

La mayoría de las herramientas de imagen toman un imageUrl más algunos parámetros opcionales; consulta el esquema de entrada de cada herramienta en tu cliente MCP. El imageUrl (y maskUrl, y cada fotograma create_video) acepta cualquiera de:

una URL pública https://,
un URI data:, o
una ruta absoluta a un archivo de imagen local — el servidor lo lee del disco y lo incrusta como base64 por ti, para que puedas apuntar una herramienta a un archivo que acabas de arrastrar sin tener que alojarlo primero (.jpg, .jpeg, .png, .webp, .gif, .bmp, .tif/.tiff, .heic/.heif, .avif; hasta 40 MB).

Nota: una imagen pegada en el chat no es una ruta de archivo, por lo que no se puede enviar a la herramienta — arrastra un archivo, o guarda el pegado y pasa su ruta.

Ejemplos de instrucciones una vez conectado:

"Usa Pedra para amueblar virtualmente https://example.com/empty-living-room.jpg como una sala de estar minimalista."

"Amuebla virtualmente /Users/me/Desktop/empty-living-room.jpg como una sala de estar minimalista."

"¿Cuántos créditos de Pedra me quedan?"

Cómo funciona

Este servidor es una capa delgada sobre @pedra-ai/sdk, que codifica los detalles del contrato de la API:

Síncrono por diseño. Cada endpoint bloquea y devuelve la(s) URL(s) final(es) en el cuerpo de la respuesta. Incluso pedra_create_video consulta del lado del servidor y devuelve el videoUrl terminado en línea (puede tardar hasta ~10 minutos; la API mantiene la conexión activa con un latido).
Los errores son errores de herramienta. Las respuestas 4xx de la API (créditos insuficientes, imagen incorrecta, …) vuelven como errores de herramienta MCP con un mensaje legible, no como fallos.

Política de privacidad

Este servidor envía las URLs de imagen/video y los parámetros que pasas a la Pedra API para realizar la edición solicitada, autenticado con tu PEDRA_API_KEY. No almacena datos por sí mismo. La recopilación, uso, almacenamiento, retención, intercambio con terceros e información de contacto están cubiertos por la política de privacidad de Pedra: https://pedra.ai/privacy.