Developer docs

Integrate Juracich HDR

Drop real-estate photo editing into your own apps, scripts, and AI assistants — HDR, twilight, sky replacement, decluttering, virtual staging, and more. Two integration surfaces: a REST API and a Model Context Protocol (MCP) connector.

API access (REST, plugins, and the Claude connector) is included on the Studio and Brokerage plans. See pricing.

Authentication

Create an API key in your dashboard under Integrations → Desktop plugins → New API key. Keys are shown once — store it securely. Send it as a Bearer token:

Authorization: Bearer jhdr_xxxxxxxxxxxxxxxxxxxx

REST API — edit a photo

POST https://juracich-hdr.vercel.app/api/v1/edit accepts a single image asmultipart/form-data and returns the edited image URL. The edit runs synchronously (≈30–60s).

Form fields

file — the source image (JPEG/PNG/TIFF, ≤60 MB) — required
preset — one of the preset keys below — required
customPrompt — plain-English edit; required only when preset=custom

curl -X POST https://juracich-hdr.vercel.app/api/v1/edit \
  -H "Authorization: Bearer jhdr_your_key" \
  -F "file=@listing.jpg" \
  -F "preset=natural"

# Custom edit:
curl -X POST https://juracich-hdr.vercel.app/api/v1/edit \
  -H "Authorization: Bearer jhdr_your_key" \
  -F "file=@listing.jpg" \
  -F "preset=custom" \
  -F "customPrompt=remove the cars from the driveway"

Response

{
  "ok": true,
  "jobId": "6a35...",
  "status": "done",
  "outputUrl": "https://.../hdr/output/.../result.webp",
  "error": null
}

Errors return { "ok": false, "error": "..." } with an appropriate status (401 bad key, 402 monthly limit reached, 403 plan without API access, 413 file too large).

Presets

Key	What it does
natural	HDR Editing (Natural) — Balanced exposure, recovered shadows and highlights, natural color.
intense	HDR Editing (Intense) — Strong HDR look — vivid colors, high contrast, bright and clean.
twilight	Real Twilights — Convert daytime exteriors into golden-hour twilights.
window-pull	Window Pull — Recover the view through blown-out or overexposed windows.
sky-replace	Sky Replacement — Replace overcast or blown-out skies with clean blue + matched lighting.
tv-screens	TV Screens — Replace blank or distracting TV content with a tasteful nature scene.
declutter	Removals — Erase cords, signage, mail, magnets, and minor clutter.
declutter-all	Remove Everything — Clear the room entirely — remove all furniture, decor, and items for an empty space.
grass-greening	Grass Greening — Make lawns lush and vibrant green — brown patches healed.
pool-enhancement	Pool Enhancement — Clean, vibrant blue pool water. Debris and discoloration removed.
snow-removal	Snow Removal — Swap winter scenes for spring/summer — clean lawns, dry surfaces.
fire-in-fireplace	Fire in Fireplace — Add a warm, realistic fire to any indoor or outdoor fireplace.
virtual-staging	Virtual Staging — Furnish empty rooms with tasteful, on-trend furniture and decor.
sun-flares	Sun Flares — Tasteful sun rays through windows + warm sunlit glow.
custom	Your prompt — pass `customPrompt` describing the edit.

Claude / MCP connector

Juracich HDR is also a Model Context Protocol server, so it works as a connector inside Claude (and any MCP client). Add this URL as a custom connector:

https://juracich-hdr.vercel.app/api/mcp

Auth: add the connector and sign in with your Juracich HDR account (OAuth 2.1 — no key to paste), or send an Authorization: Bearer jhdr_… header. Claude Code:

claude mcp add --transport http juracich-hdr https://juracich-hdr.vercel.app/api/mcp \
  --header "Authorization: Bearer jhdr_your_key"

Tools include list_edits, edit_photo, edit_photos (batch), create_upload (hosted drop link for full-res photos), list_jobs/get_job, integration management (list_integrations, sync_integration, list_folders, set_watch_folder), and account/usage tools.

Limits

Edits count toward your plan’s monthly allowance (Studio: 500/mo, Brokerage: unlimited). A short-window burst limit also applies. Over the monthly limit, edit calls return 402 until the cycle resets.

Questions or need a higher tier? Email hello@hdr.juracich.com.