Pedra
NPM · @PEDRA-AI/MCP
AI real-estate photo editing and 360° virtual tours via the Pedra API: staging, renovation, video.
Available components
Last scanned (5 hours ago)
Scores higher than 81% of npm servers
Category Design and Media
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security81
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available. View diagnostics → Fail
- No install/post-install scripts declared.Pass
- 30 of 94 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to pedra-ai/pedra-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 1 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability66
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 7127 tokens (~215/item across 33 items; 33 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage96
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 89% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 33 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (16)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 22 Nov 26 0
- Stability: 0.97 → pass security
- 21 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- Stability: pass → 0.97 functional
- 20 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- Package version: 0.7.0 → 0.8.0 functional
- 18 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 17 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- Package version: 0.6.1 → 0.7.0 functional
- 13 Nov 26 0
- Stability: 0.97 → pass security
- 12 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 22 Nov 2026 · Analysed npm/@pedra-ai/mcp@0.8.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | pedra-ai/pedra-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/pedra-ai/pedra-mcp/.github/workflows/release.yml@refs/tags/v0.8.0 |
| Rekor log index | 4026297124 |
| Predicate type | SLSA build provenance https://slsa.dev/provenance/v1 |
| Subject digest | sha512:d11c7ba06fd17c2a550569055c405fc45e59e23d953252a6a16be15feca387b402bed9207e90b5a55282e7d4b3b1c0adbcb6cc92ed06458753c9c8c36 |
Background: How many MCP packages publish verified provenance →
Vulnerabilities 1 finding
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-mrhx-c7xc-m3w5 | CVE-2023-54404 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | yes |
Background: What a vulnerability scan can and cannot prove →
Dependencies 94 packages
| Packages resolved | 94 |
|---|---|
| Stale | 30 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
pedra_add_images_to_property Add photos to property ~266
Add photos to a property by URL (the server fetches each one, so any public https image URL or small data: URI works). Returns the stored img.pedra.ai URLs to use with the editing, video and tour tools. For photos on the user's device, use pedra_create_upload_link instead. Pass type "360" for 360° photos (checked to be 2:1 equirectangular), which can then become a virtual tour. (With this local server, 360° photo files on this computer can go through pedra_add_local_panoramas instead.)
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrls | array | yes | Image URLs to fetch and add to the property: up to 20 photos, or up to 10 when type is "360". |
| names | array | – | Optional names, one per image in the same order as imageUrls (e.g. the original file names), up to 200 characters each. Returned by pedra_list_property_images and as source.name when the photo is edi… |
| propertyId | string | yes | Target property id (from pedra_list_properties or pedra_create_property). |
| type | string | – | What the images are: regular photos ("photo", the default) or 360° photos ("360"). |
No output schema declared.
No examples provided.
pedra_add_local_panoramas Add local 360° photos to property ~220
LOCAL-ONLY TOOL (this Pedra MCP server runs on the user's own computer, so it can read files from its disk). Upload 360° photo files (2:1 equirectangular JPEG, PNG or WebP) from absolute local paths into a property, in the order given — that order becomes the walking order when you then call pedra_create_virtual_tour with just the propertyId. Files are sent in batches (10 per call, under the 50 MB request limit); a file over ~33 MB can't be sent this way — use pedra_create_upload_link for those. Prefer this over pedra_create_upload_link whenever the 360° photos are files on this computer. Returns the added photos (imageIds are scene ids) and any that failed, each with its path.
| Name | Type | Req | Description |
|---|---|---|---|
| paths | array | yes | Absolute paths to 360° photo files on this computer, in walking order (file:// URLs and ~ are accepted). |
| propertyId | string | yes | Target property id (from pedra_list_properties or pedra_create_property). |
No output schema declared.
No examples provided.
pedra_add_virtual_tour_scenes Add rooms to virtual tour ~136
Add rooms to the end of an existing virtual tour. With "sequential" linking (default) only the new stretch is linked: the last existing room to the first new one, then each new room to the next. That costs max(3, ceil(new rooms/3)) credits; "none" is free. The tour stays live while this runs; poll pedra_get_virtual_tour until status is "ready".
| Name | Type | Req | Description |
|---|---|---|---|
| linking | string | – | Defaults to "sequential". |
| scenes | array | yes | The new rooms, in walking order. |
| tourId | string | yes | The tour to extend. |
No output schema declared.
No examples provided.
pedra_blur Blur objects ~345
Blur objects in an image (e.g. faces, license plates) for privacy. Returns the blurred image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| objectsToBlur | array | yes | Labels/regions to blur, e.g. ["faces", "license plates"]. |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
No output schema declared.
No examples provided.
pedra_check_access Check Pedra account access ~94
Check whether the user confirmed the access request from pedra_request_access. "pending": they haven't clicked yet, check again in a few seconds. "approved": every Pedra tool works from now on in this session; show the user the result's message so they can keep their API key. "denied" or "expired": ask before requesting again.
| Name | Type | Req | Description |
|---|---|---|---|
| requestId | string | yes | The requestId from pedra_request_access. |
No output schema declared.
No examples provided.
pedra_correct_perspective Correct perspective ~338
Straighten vertical lines in a photo shot with a tilted camera, without enhancing light or color. Use pedra_enhance_and_correct_perspective to do both. Returns the corrected image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
No output schema declared.
No examples provided.
pedra_create_property Create property ~86
Create a new Pedra property. Returns its propertyId and an appUrl. To add photos that are on the user's device, pedra_create_upload_link is simpler (no login); or give the user the appUrl to open the property in Pedra and drop their photos in, then use pedra_list_property_images.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | – | Property name, e.g. the listing address. |
No output schema declared.
No examples provided.
pedra_create_upload_link Create photo upload link ~290
Get a link where the user (or their photographer) uploads photos from their phone or computer into a property. No login, valid 24 hours. Use this whenever the photos are files on the user's device that weren't attached to the chat: for editing, videos or virtual tours. Regular photos and 360° photos both work (360° photos are recognised automatically); pass type "360" for a virtual tour so anything else is refused. Creates the property if no propertyId is given. Give the user the uploadUrl, wait until they say they're done, then use pedra_list_property_images (type "360" for 360° photos), or pedra_create_virtual_tour with the propertyId. (With this local server, files on this computer can also be passed directly: a local path as imageUrl, or pedra_add_local_panoramas for 360° photos.)
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | – | Language of the tour page and of AI room names. Defaults to "en". |
| name | string | – | Name for the new property, e.g. the listing address. Ignored when propertyId is given. |
| propertyId | string | – | Property to upload into (from pedra_list_properties). Omit to create a new one. |
| type | string | – | "any" (default) takes photos and 360° photos; "360" only takes 360° photos. |
No output schema declared.
No examples provided.
pedra_create_video Create property video ~120
Create a property video from a list of images. Blocks server-side until the video is rendered (up to ~10 min) and returns the finished video URL inline.
| Name | Type | Req | Description |
|---|---|---|---|
| branding | object | – | – |
| endingSubtitle | string | – | – |
| endingTitle | string | – | – |
| images | array | yes | Ordered list of images that make up the video. |
| isVertical | boolean | – | Force a vertical (9:16) video. |
| music | object | – | – |
| propertyCharacteristics | array | – | – |
| voice | object | – | – |
No output schema declared.
No examples provided.
pedra_create_virtual_tour Create virtual tour ~284
Build a hosted 360° virtual tour: the rooms are named and linked with navigation points by AI, and you get a shareable link and embed code. Pass the 360° photos as scenes (URLs, or imageIds of 360° photos already in the property) in the order someone would walk through the home, or just a propertyId to use all its 360° photos. Linking: "sequential" (default) links each room to the next and costs max(3, ceil(rooms/3)) credits; "smart" lets AI work out which rooms connect (slower, 5-160 credits by room count); "none" is free. Returns a tourId immediately — the build takes about 10 seconds per room, so poll pedra_get_virtual_tour until status is "ready". One tour per property.
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | – | Language of the tour page and of AI room names. Defaults to "en". |
| linking | string | – | How rooms get connected. Defaults to "sequential". |
| name | string | – | Tour title, e.g. the listing address. |
| propertyId | string | – | Property the tour belongs to. Omit to create a new property. |
| scenes | array | – | The rooms in walking order. Omit to use every 360° photo in propertyId. |
No output schema declared.
No examples provided.
pedra_credits Get credits ~23
Read the account's plan and remaining credits. Never deducts credits.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
pedra_edit_via_prompt Edit via prompt ~339
Edit an image from a natural-language instruction (e.g. "paint the walls sage green"). Returns the edited image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| prompt | string | yes | Natural-language description of the edit to apply. |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
No output schema declared.
No examples provided.
pedra_empty_room Empty room ~317
Remove all furniture and objects from a room, leaving an empty space. Returns the emptied image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
No output schema declared.
No examples provided.
pedra_enhance Enhance image ~358
Enhance a real-estate photo: improve lighting, color, and sharpness. Returns the enhanced image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| preserveOriginalFraming | boolean | – | Preserve the original framing/aspect ratio/resolution exactly (for verification verticals where the output must legally represent the captured photo). Defaults to false. |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
No output schema declared.
No examples provided.
pedra_enhance_and_correct_perspective Enhance + correct perspective ~363
Enhance a photo and correct vertical/horizontal perspective (straighten walls and lines). Returns the corrected image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| preserveOriginalFraming | boolean | – | Preserve the original framing/aspect ratio/resolution exactly (for verification verticals where the output must legally represent the captured photo). Defaults to false. |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
No output schema declared.
No examples provided.
pedra_feedback Submit feedback ~122
Submit thumbs up/down feedback on a generated image, with an optional credit-back on a thumbs-down (subject to the API's eligibility rules).
| Name | Type | Req | Description |
|---|---|---|---|
| comment | string | – | – |
| creditBack | boolean | – | Request a credit refund (only honored on a thumbs-down). |
| imageId | string | – | Explicit image id. One of imageUrl/imageId is required. |
| imageUrl | string | – | The generated image URL to vote on (id is parsed from it). |
| vote | string | – | Thumbs up/down. An empty string clears a previous vote. |
No output schema declared.
No examples provided.
pedra_furnish Furnish / virtually stage ~366
Virtually stage (furnish) a room with AI-generated furniture. Returns the staged image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
| roomType | string | – | e.g. "Living room", "Bedroom", "Kitchen". Auto-detected if omitted. |
| style | string | – | e.g. "Minimalist", "Scandinavian", "Modern". |
No output schema declared.
No examples provided.
pedra_furnish_same_room Stage one room from several angles ~430
Virtually stage 2 to 10 photos of the SAME room, taken from different angles, so every photo gets the same furniture in the same places. Stages the first photo in the given style, then furnishes every other angle from it (or from referenceImageUrl if the room is already staged). Use this instead of calling pedra_furnish per photo whenever the user has several shots of one room: pedra_furnish would give each photo different furniture. Put the widest shot first. Costs 1 credit for the first photo and 2 per extra angle. Runs in the background: returns a jobId right away; call pedra_get_furnish_same_room with it until status is ready.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrls | array | yes | 2 to 10 photos of one room, widest shot first: public https:// URLs, data: URIs, or absolute paths to local image files on this computer. One room per call: stage the living room and the bedroom as s… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
| referenceImageUrl | string | – | Optional public URL of a photo of this room that is already staged. Every photo in imageUrls is then furnished to match it (2 credits each) and style is ignored. |
| roomType | string | – | e.g. "Living room", "Bedroom". Auto-detected if omitted. |
| style | string | – | Style for the first photo, e.g. "Minimalist", "Scandinavian". Required unless referenceImageUrl is set. |
No output schema declared.
No examples provided.
pedra_generate_voice Generate voiceover audio ~136
Render a voiceover from a script via text-to-speech. Returns an audioId — pass it to pedra_create_video / pedra_update_video as voice.audioId to attach the narration (with synced subtitles).
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | – | Voice language, e.g. "English", "Español". Defaults to English. |
| text | string | yes | The script to narrate (max 1000 characters). |
| voiceId | string | – | Which voice narrates. Call pedra_music_library for the voices offered per language — a voice is only valid for the language it is listed under. Defaults to that language's first voice. |
No output schema declared.
No examples provided.
pedra_generate_voice_script Generate voiceover script ~104
Write a short voiceover script from property photos (and optional facts). GPT-4o vision reads the images so the script reflects what's actually shown. Returns the script text — pass it to pedra_generate_voice.
| Name | Type | Req | Description |
|---|---|---|---|
| images | array | – | Photos to base the script on (URLs or { imageUrl }). |
| language | string | – | Script language, e.g. "English", "Español". Defaults to English. |
| propertyCharacteristics | array | – | – |
No output schema declared.
No examples provided.
pedra_get_furnish_same_room Check multi-angle staging ~92
Check a job started with pedra_furnish_same_room. Returns status "processing", "ready", "partial" (some photos failed and weren't charged) or "failed", plus one output per photo in the order sent, each with its own status and, once ready, its url. Never spends credits.
| Name | Type | Req | Description |
|---|---|---|---|
| jobId | string | yes | Id returned by pedra_furnish_same_room. |
No output schema declared.
No examples provided.
pedra_get_virtual_tour Check virtual tour ~93
Get a virtual tour: status ("processing", "ready" or "failed", with the reason), the shareable tourUrl, an embedCode iframe for a website, and its scenes and navigation links. Poll this after pedra_create_virtual_tour or pedra_add_virtual_tour_scenes. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| tourId | string | yes | Id from pedra_create_virtual_tour or pedra_list_virtual_tours. |
No output schema declared.
No examples provided.
pedra_list_properties List properties ~55
List the user's Pedra properties (id, name, photo count, and an appUrl to open each in Pedra). Use this to find photos already in the account — e.g. to build a video from a listing's photos.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
pedra_list_property_images List property photos ~116
List the photos in a Pedra property as img.pedra.ai URLs, ready to pass straight to pedra_create_video or the image-editing tools. Get the propertyId from pedra_list_properties. Pass type "360" to list its 360° photos instead (their imageIds are the scenes of a virtual tour).
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | yes | The property's id (from pedra_list_properties). |
| type | string | – | Which images to list: regular photos ("photo", the default) or 360° photos ("360"). |
No output schema declared.
No examples provided.
pedra_list_virtual_tours List virtual tours ~52
List the account's virtual tours (newest first) with status, share link and room count. Optionally only one property's. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | – | Only this property's tour. |
No output schema declared.
No examples provided.
pedra_make_hd Make HD ~258
Upscale a photo with AI to a sharper, higher-resolution version. Use it on small or blurry listing photos. Returns the HD image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
No output schema declared.
No examples provided.
pedra_music_library List music tracks ~43
List the background-music catalog: valid `music.track` values (genre keys), plus the voice languages and the narration voices offered for each of them. Read-only.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
pedra_remove_object Remove object ~345
Remove an object from an image using a mask. Returns the cleaned image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| maskUrl | string | yes | Mask image marking the region to remove: a public https:// URL, a data: URI, or a local file path. |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
No output schema declared.
No examples provided.
pedra_renovation Renovate space ~366
Renovate a space (walls, floors, finishes), optionally furnished. Returns the renovated image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| furnish | – | – | Whether the renovated room should be furnished (true → with furniture, false → empty). |
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
| roomType | string | – | Room type. Auto-detected if omitted. |
| style | string | – | Renovation style. |
No output schema declared.
No examples provided.
pedra_request_access Get a Pedra account ~151
This Pedra server has no API key yet. Use this when the user wants to use Pedra (photo editing, virtual staging, videos, 360° tours): ask for their email, then call this. Pedra emails them a link to confirm: a new user creates their account there (chooses a password), an existing user clicks Allow. Nothing is created until they click. Tell the user to check their inbox, then call pedra_check_access with the requestId.
| Name | Type | Req | Description |
|---|---|---|---|
| agentName | string | – | Shown to the user in the email, e.g. "Claude Code". Defaults to this MCP client's name. |
| string | yes | The user's email address (ask them for it; don't guess). |
No output schema declared.
No examples provided.
pedra_sky_blue Replace sky ~332
Replace a dull or overcast sky with a clear blue one. Returns the image URL with the new sky. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.
| Name | Type | Req | Description |
|---|---|---|---|
| imageUrl | string | yes | Source image: a public https:// URL, a data: URI, or an absolute path to a local image file on this computer (the file is read and inlined automatically). If the photo is on the user's device and can… |
| name | string | – | Optional name for the original photo (e.g. its file name), up to 200 characters. Only used with propertyId: if the photo isn't in that property yet, it's saved there under this name in the same call… |
| preserveAspectRatio | boolean | – | By default the output comes back at whatever size the AI model produces, which may not match the input's aspect ratio or resolution. Set to true to get the result at the exact width and height of the… |
| propertyId | string | – | Optional id of the Pedra property (from pedra_list_properties) this photo belongs to. When set, the result is saved into that property's gallery — visible and editable from the app — instead of only… |
| skyStyle | string | – | Optional named sky style. |
No output schema declared.
No examples provided.
pedra_update_video Edit existing video ~225
Edit an existing video (by videoId) without re-rendering unchanged clips — only new/changed photos re-animate and cost credits; reordering, music, voice, branding and text re-stitch for free. Omit `images` to change only audio/text/branding while keeping the current timeline. Omit `music`/`voice`/`branding`/ending text to leave them unchanged. Blocks until rendered and returns the new video URL.
| Name | Type | Req | Description |
|---|---|---|---|
| branding | object | – | – |
| endingSubtitle | string | – | – |
| endingTitle | string | – | – |
| images | array | – | Full ordered image list to rebuild the timeline; matching photo+effect clips are reused. Omit to edit only audio/text and keep the current timeline. |
| isVertical | boolean | – | Force a vertical (9:16) video (only when images are sent). |
| music | object | – | – |
| propertyCharacteristics | array | – | – |
| videoId | string | yes | Id of the video to edit (from pedra_create_video). |
| voice | object | – | – |
No output schema declared.
No examples provided.
pedra_update_virtual_tour Edit virtual tour ~262
Change a finished virtual tour in place: rename it or its rooms, reorder rooms (the first one is where the tour opens), remove rooms, replace its navigation links, or change how the navigation points look. Free and instant. The tour's public link shows the change right away. Get sceneIds from pedra_get_virtual_tour.
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | – | Language of the tour page and of AI room names. Defaults to "en". |
| links | array | – | Replaces ALL navigation links. Each is one direction; add the return link separately. |
| name | string | – | New tour title. |
| navigationSize | string | – | Size of the navigation points. |
| navigationStyle | string | – | Look of the navigation points. |
| removeScenes | array | – | sceneIds to take out of the tour (the photos stay in the property). Their links go too. |
| sceneNames | object | – | New room names, as { sceneId: "Kitchen" }. |
| sceneOrder | array | – | Every sceneId of the tour in the new order. The first one opens the tour. |
| showLabels | boolean | – | Always show room names next to the navigation points. |
| tourId | string | yes | The tour to change. |
No output schema declared.
No examples provided.
How do I install the Pedra MCP server?
Pedra runs locally as an npm package, launched with npx -y @pedra-ai/mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @pedra-ai/mcp
claude mcp add pedra-ai-pedra-mcp -- npx -y @pedra-ai/mcp
What is the Pedra MCP server?
Pedra is an MCP server listed in the public MCP registry as io.github.pedra-ai/pedra-mcp. AI real-estate photo editing and 360° virtual tours via the Pedra API: staging, renovation, video. This page covers its npm package (@pedra-ai/mcp).
Is the Pedra MCP server safe to use?
Pedra scores 87 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 22 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Pedra MCP server expose?
Pedra exposes 33 tools: pedra_request_access, pedra_check_access, pedra_enhance, pedra_enhance_and_correct_perspective, pedra_correct_perspective, and 28 more. Their descriptions and schemas cost roughly 7,127 tokens of context every time the server is loaded.
Is the Pedra MCP server still maintained?
Pedra is still listed as active in the MCP registry. We last reached this channel on 22 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Pedra MCP server under?
Pedra declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.
What did VerifyMCP test on the Pedra MCP server?
VerifyMCP ran 16 checks on Pedra, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.