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

Documentación

Servidor MCP de Pedra

Servidor oficial del Model Context Protocol para la API de Pedra: usa la edición de fotos inmobiliarias con IA de Pedra (home staging virtual, renovación, vaciado de habitaciones, mejora, reemplazo de cielo, eliminación/desenfoque de objetos, videos de propiedades y recorridos virtuales 360° alojados) directamente desde Claude, ChatGPT, Cursor y cualquier otro cliente MCP.

Expone una herramienta por endpoint de API. Cada herramienta de foto y video es una llamada bloqueante única que devuelve la(s) URL(s) final(es) del recurso; no hay IDs de trabajo que consultar. Los recorridos virtuales se construyen en segundo plano: pedra_create_virtual_tour devuelve un tourId, y se consulta pedra_get_virtual_tour hasta que esté listo.

Inicio rápido

El servidor lee tu clave de API de Pedra (Configuración en tu cuenta de Pedra) desde la variable de entorno PEDRA_API_KEY. ¿Aún no tienes cuenta? Inícialo sin clave; consulta ¿Aún no tienes cuenta de Pedra?.

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 versión de pedra-mcp.mcpb desde Releases y haz doble clic en ella (o arrástrala a Claude Desktop → Configuración → Extensiones). Claude instala el servidor incluido y te pide tu PEDRA_API_KEY; no es necesario editar JSON.

Claude Desktop (manual)

O agrega 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 a través de Smithery:

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

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

¿Aún no tienes cuenta de Pedra?

Inicia el servidor sin PEDRA_API_KEY, por ejemplo en Claude Code:

claude mcp add pedra -- npx -y @pedra-ai/mcp

Luego solo pide algo ("haz el staging de esta foto con Pedra"). Sin una clave, el servidor agrega dos herramientas y el asistente hace el resto:

pedra_request_access con tu correo electrónico. Pedra te envía un enlace por correo (válido por 30 minutos): una cuenta nueva elige una contraseña allí; una existente hace clic en Permitir. No se crea nada hasta que hagas clic, y puedes rechazarlo.
pedra_check_access hasta que hayas confirmado. Una vez aprobado, todas las herramientas de Pedra funcionan durante el resto de la sesión. La clave se mantiene solo en memoria, nunca se escribe en disco; el resultado de la herramienta la muestra junto con cómo conservarla: agrégala como PEDRA_API_KEY al env del servidor (p. ej., claude mcp add pedra -e PEDRA_API_KEY=<key> -- npx -y @pedra-ai/mcp, o pégala en la configuración de la extensión en Claude Desktop).

Hasta entonces, las demás herramientas responden "No hay clave de API aún: llama a pedra_request_access con el correo del usuario". Se requiere confirmación en la bandeja de entrada, se rechazan los dominios de correo desechables y las solicitudes tienen límite de frecuencia. Las cuentas nuevas comienzan con los créditos de prueba gratuitos de Pedra.

(En ChatGPT y claude.ai, usa el conector alojado de Pedra: conectarlo inicia un inicio de sesión donde los nuevos usuarios pueden crear una cuenta).

Herramientas

Las nueve herramientas de edición de imágenes (de mejorar a desenfocar) también aceptan propertyId, para guardar el resultado en la galería de esa propiedad, y name, para guardar la foto original allí con ese nombre en la misma llamada. El resultado incluye entonces source (imageId, name) del original. preserveAspectRatio devuelve el resultado en el tamaño exacto de la entrada.

Herramienta	Endpoint	Qué hace
`pedra_enhance`	`/enhance`	Mejora iluminación, color y nitidez
`pedra_enhance_and_correct_perspective`	`/enhance_and_correct_perspective`	Mejora + endereza la perspectiva
`pedra_empty_room`	`/empty_room`	Elimina todos los muebles/objetos
`pedra_furnish`	`/furnish`	Hace staging virtual de una habitación
`pedra_renovation`	`/renovation`	Renueva paredes/pisos/acabados
`pedra_edit_via_prompt`	`/edit_via_prompt`	Edita a partir de un prompt en lenguaje natural
`pedra_sky_blue`	`/sky_blue`	Reemplaza un cielo apagado por azul claro
`pedra_remove_object`	`/remove_object`	Elimina un objeto usando una máscara
`pedra_blur`	`/blur`	Desenfoca rostros, placas, etc.
`pedra_create_video`	`/create_video`	Genera un video de 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 a partir de fotos de la propiedad
`pedra_generate_voice`	`/generate_voice`	Convierte un guion en una pista de audio de voz
`pedra_music_library`	`/music_library`	Lista pistas de música de fondo, idiomas de voz y voces de narración
`pedra_list_properties`	`/list_properties`	Lista las propiedades de la cuenta
`pedra_list_property_images`	`/list_property_images`	Lista las fotos de una propiedad (o, con `type: "360"`, sus fotos 360°) como URLs
`pedra_create_property`	`/create_property`	Crea una propiedad
`pedra_add_images_to_property`	`/add_images_to_property`	Agrega fotos (o, con `type: "360"`, fotos 360°) a una propiedad por URL, opcionalmente con `names`
`pedra_add_local_panoramas`	`/add_images_to_property` (por lotes)	Solo local: sube archivos de fotos 360° desde esta computadora a una propiedad
`pedra_create_upload_link`	`/create_upload_link`	Página sin inicio de sesión para subir fotos o fotos 360° desde un teléfono o computadora (`type: "360"` solo para recorridos)
`pedra_create_virtual_tour`	`/create_virtual_tour`	Construye un recorrido virtual 360° alojado (la IA nombra y enlaza las habitaciones)
`pedra_get_virtual_tour`	`/get_virtual_tour`	Estado del recorrido, enlace para compartir, código para insertar, escenas, enlaces
`pedra_list_virtual_tours`	`/list_virtual_tours`	Lista los recorridos virtuales de la cuenta
`pedra_update_virtual_tour`	`/update_virtual_tour`	Renombra, reordena, elimina habitaciones, reenlaza, cambia el estilo (gratis)
`pedra_add_virtual_tour_scenes`	`/add_virtual_tour_scenes`	Agrega habitaciones al final de un recorrido
`pedra_credits`	`/credits`	Lee el plan y los créditos restantes
`pedra_feedback`	`/feedback`	Pulgar arriba/abajo + posible devolución de créditos
`pedra_request_access`	`/agent_signup`	Solo sin clave de API: envía al usuario un enlace por correo para crear/permitir su cuenta
`pedra_check_access`	`/agent_signup_status`	Solo sin clave de API: verifica la solicitud; una vez aprobada, todas las herramientas funcionan durante la sesión

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

una URL pública de https://,
un URI de data:, o
una ruta absoluta a un archivo de imagen local: el servidor lo lee del disco y lo incorpora como base64 por ti, para que puedas apuntar una herramienta a un archivo que acabas de arrastrar sin 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 reenviar a la herramienta: arrastra un archivo, o guarda lo pegado y pasa su ruta. Las fotos en el teléfono del usuario pasan por pedra_create_upload_link: se suben en una página sin inicio de sesión (hasta 100 archivos, 24 h), luego pedra_list_property_images devuelve sus URLs para editar, pedra_create_video o pedra_create_virtual_tour.

Las subidas tienen un límite diario: 30 imágenes en el plan gratuito, 500 en los planes de pago (se reinicia a medianoche UTC), contando cada imagen almacenada desde fuera de la aplicación (pedra_add_images_to_property, pedra_add_local_panoramas, escenas URL en recorridos, archivos de enlace de subida); al superarlo, la llamada falla con HTTP 429, upload_limit y no se almacena nada. Enlaces de subida: 5 al día gratis, 50 de pago (upload_link_limit).

Ejemplos de prompts una vez conectado:

"Usa Pedra para hacer el staging virtual de https://example.com/empty-living-room.jpg como sala de estar minimalista."

"Haz el staging virtual de /Users/me/Desktop/empty-living-room.jpg como sala de estar minimalista."

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

Recorridos virtuales

Envía tus fotos 360°, recibe un recorrido virtual alojado, enlazado y compartible: la IA nombra las habitaciones y coloca los puntos de navegación de puerta a puerta. Las herramientas de recorrido tienen los mismos nombres, descripciones y esquemas de entrada que el servidor MCP alojado de Pedra (https://app.pedra.ai/mcp), por lo que un agente se comporta igual en cualquiera de los dos.

Un flujo típico:

Lleva las fotos 360° a una propiedad.
- Archivos en esta computadora → pedra_add_local_panoramas con las rutas en orden de recorrido. Esta herramienta solo existe en este servidor local: lee los archivos del disco y los envía codificados en base64, 10 por llamada bajo el límite de solicitud de 50 MB de la API. Los archivos de más de ~33 MB no se pueden enviar de esta manera.
- Fotos en el teléfono de alguien (o archivos grandes) → pedra_create_upload_link con type: "360", y entrega el uploadUrl (sin inicio de sesión, válido 24 h).
- Fotos ya en línea → omite este paso y pasa las URLs como scenes.
Constrúyelo: pedra_create_virtual_tour con el propertyId (usa cada foto 360° en orden de subida) o con scenes. Devuelve un tourId de inmediato.
Espera: consulta pedra_get_virtual_tour hasta que status sea "ready" (aproximadamente 10 s por habitación); luego comparte tourUrl o inserta embedCode. Una compilación de "failed" indica el motivo y no cuesta nada.
Ajusta con pedra_update_virtual_tour (gratis, instantáneo) o agrega habitaciones con pedra_add_virtual_tour_scenes.

Enlazar cuesta max(3, ceil(rooms/3)) créditos para "sequential" (predeterminado; cada habitación a la siguiente), 5–160 para "smart" (la IA determina qué habitaciones se conectan) y nada para "none". Eliminar un recorrido es solo por API (no se expone como herramienta).

"Crea un recorrido virtual de Pedra de Calle Mayor 12 desde /Users/me/360/entrance.jpg, /Users/me/360/living.jpg y /Users/me/360/kitchen.jpg, en ese orden, y dame el enlace."

Cómo funciona

Este servidor es un envoltorio delgado sobre @pedra-ai/sdk, que codifica los detalles del contrato de la API:

Síncrono por diseño (excepto los recorridos virtuales). Cada endpoint de foto y video bloquea y devuelve la(s) URL(s) final(es) en el cuerpo de la respuesta. Incluso pedra_create_video consulta en el 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, etc.) 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 API de Pedra para realizar la edición solicitada, autenticada con tu PEDRA_API_KEY. Sin una clave, pedra_request_access envía la dirección de correo que le das a Pedra para que Pedra te envíe un enlace de confirmación; una clave obtenida de esa manera se mantiene en memoria solo durante la sesión. No almacena datos por sí mismo. La recopilación, el uso, el almacenamiento, la retención, el intercambio con terceros y la información de contacto de los datos están cubiertos por la política de privacidad de Pedra: https://pedra.ai/privacy.