Reel Estate MCP
OfficialThis MCP server lets an AI assistant operate a Reel Estate account to turn listing photos into property videos.
Sign in/out via browser OAuth + PKCE; check auth, plan, and write access.
Browse projects, project stats, clips, rendered movies, voices, and billing usage.
Upload local image files into projects using presigned S3 uploads.
Geocode free-text addresses into ranked listing candidates.
Generate motion video clips from project images and poll job status.
AI-edit photos: virtual staging, twilight, upscale, seasonal, replace/remove/add, and manual prompts.
Add and retime timeline audio, voiceover/music, image/text overlays, and reorder timeline elements.
Render final listing movies with configurable resolution, aspect ratio, duration, and transitions.
Discover API endpoints and call any authenticated backend route through
api_request.Guided help walkthrough for the full sign-in → photos → edit → clip → timeline → render pipeline.
reel-estate-mcp
Turn real-estate listing photos into cinematic property videos from your AI
assistant. reel-estate-mcp is a Model Context Protocol
(MCP) server that connects Claude, Cursor, and other AI assistants to your
Reel Estate account — so you can generate motion
clips, AI-edit photos (virtual staging, twilight, seasonal), add voiceover, and
render finished listing videos, all in plain language.
Reel Estate is the AI real-estate video platform that turns property photos into scroll-stopping listing videos. Create a free account at tryreelestate.com.
You sign in once through your browser (OAuth + PKCE — no API keys, no secrets),
and every call is proxied through the backend's /mcp endpoint, which stays the
single authority for auth, plans, and permissions. This bridge's one superpower on
top of that: it can read local image files and stream them straight into a
project — something a purely remote server can't do.
🎬 Generate real-estate videos — animate photos into clips, then render the movie
🖼️ AI photo editing — virtual staging, twilight, upscale, seasonal, replace/remove/add
🎙️ Voiceover & timeline — narration, music, overlays, reordering
📤 Local uploads — push photos from disk into a project
🔐 Browser sign-in — public OAuth client + PKCE; nothing secret stored
🤖 Works with Claude Code, Claude Desktop, and Cursor
Requirements
Node.js 18+
A Reel Estate account (a paid plan is required to create/generate/render; free accounts are read-only over the MCP)
An MCP-compatible client: Claude Code, Claude Desktop, or Cursor
Related MCP server: mcp-media-engine
Install
Nothing to clone or build — your MCP client launches it on demand via npx. You
only need Node.js ≥ 18. (Prefer a global command? npm install -g reel-estate-mcp,
then use reel-estate-mcp in place of npx -y reel-estate-mcp below.)
Connect your assistant
Zero config — the bridge connects to Reel Estate and handles browser sign-in for you. There's nothing to set up.
Claude Code
claude mcp add reel-estate -- npx -y reel-estate-mcpClaude Desktop / Cursor
Add to your client's MCP config (claude_desktop_config.json, ~/.cursor/mcp.json):
{
"mcpServers": {
"reel-estate": {
"command": "npx",
"args": ["-y", "reel-estate-mcp"]
}
}
}First run — sign in
The first tool call opens your browser to sign in with your Reel Estate account
(Clerk OAuth, authorization code + PKCE). After you approve, the browser returns to
http://localhost:8765/callback, tokens cache under ~/.reel-estate-mcp, and
you're in — you won't log in again until the token expires.
Start with whoami to confirm auth and see your plan, then just ask:
"List my recent projects."
"Create a project for 123 Main St and upload the photos in ./listing."
"Virtually stage the living room photo, generate a drone clip, then render in 9:16."
"How many credits and exports do I have left?"
To switch users or re-authorize, run logout (revokes server-side + clears
the cache) or delete ~/.reel-estate-mcp.
Tools
All API tools proxy through the backend's /mcp api_request, so the backend's
own authorization and plan rules apply.
Tool | What it does |
| Guided, always-current walkthrough (also the |
| Confirm auth; reports |
| Start browser sign-in / clear the session (server revoke + local cache) |
| Browse projects |
| Browse clips, rendered movies, TTS voices |
| Geocode a free-text address → ranked candidates (for real-listing projects) |
| Upload a local image into a project (presigned upload — no storage creds) |
| Upload 10 to 20 local photos into EZ Reel (presigned), or reuse photos already in a project |
| EZ Reel templates and songs |
| The fast path: build a finished listing reel from photos, a template and a song; price it, render it (asks for cost confirmation), poll for the video |
| Browse EZ Reels |
| Animate a photo into a video clip (Runway); poll the job |
| AI photo edit — virtual staging, twilight, upscale, seasonal, replace/remove/add, manual |
| Place voiceover/music/audio or an image/text overlay |
| Retime / resequence the timeline |
| Assemble the timeline into the final listing video |
| Discover the API catalog / call any route — the escape hatch |
Paid vs free
Writes and generation over the MCP require a paid plan — free accounts are
read-only (browse projects, clips, and movies). whoami reports this up front;
a blocked write returns 403 MCP_PAID_PLAN_REQUIRED. See plans at
tryreelestate.com.
How auth works
first tool call
│ StreamableHTTP client ──► backend /mcp (401, needs auth)
▼
opens your browser ──► Clerk OAuth (authorization code + PKCE, public client)
│ │
▼ ▼
loopback http://localhost:8765/callback?code=… access + refresh tokens
│ │
└────────────► finishAuth(code) ──► tokens cached ──┘ (~/.reel-estate-mcp)
every later call: callTool("api_request", …) over the authed /mcp connectionNo secrets to distribute — public client + PKCE, browser login per user.
Prod-capable — uses the same OAuth the backend serves at
/mcp.The backend is the single auth authority — this bridge never mints tokens.
Troubleshooting
Problem | Fix |
No login prompt / "not authenticated" | Run any tool (or |
Switch accounts / re-authorize | Run |
Writes blocked ( | Creating/generating/rendering needs a paid plan; free accounts are read-only. See tryreelestate.com. |
Architecture
src/config.ts— validated env (loaded from this package's folder); derives the/mcpURL, OAuth store dir, callback port, read-only flag, and default client id.src/oauth.ts—OAuthClientProvider: uses the publicclient_id, caches tokens + the PKCE verifier, opens the system browser.src/upstream.ts— the single OAuth'd MCP client connection to/mcp(with the loopback callback server);callTool/callApiRequestproxies.src/api-client.ts—ApiClientovercallApiRequest; enforces read-only.src/catalog.ts— the endpoint catalog surfaced bylist_endpoints.src/tools.ts— tools as plain functions (smoke-testable).src/index.ts— registers the tools as MCP tools over stdio.
Adding a tool
Add
async function fooBar(api, args)insrc/tools.ts(useapi.get(...)/api.request(...), which proxy through/mcp).Register it in
src/index.tswith a ZodinputSchema.Add it to
scripts/smoke.tsif it's a GET.
Everything is already reachable through api_request; convenience tools just make
the common paths first-class.
About Reel Estate
Reel Estate helps real-estate agents and marketers turn ordinary listing photos into professional property videos — AI virtual staging, twilight conversion, motion/drone clips, voiceover narration, and one-click rendering for Instagram, TikTok, and YouTube. This MCP server brings that workflow into your AI assistant. Get started at tryreelestate.com →
Keywords: real estate video generator, AI listing video, virtual staging, MCP server, Model Context Protocol, Claude, Cursor, property video marketing, drone real estate video, twilight photo editing.
Available Tools
23 toolsadd_image_from_fileAdd a photo to a project from a local fileA
Upload a LOCAL image file to a project. Reads the file, mints a presigned S3 URL (POST /projects/:id/images/upload-url), PUTs the bytes straight to storage (no credentials needed), then attaches it (POST /projects/:id/images). This is the credential-less upload path the remote MCP can't do. Image aspect ratio must be between 0.5:1 and 2:1. Blocked in read-only mode.
Inputs: path (required), projectId (required), caption, filename, +1 more.
add_timeline_audioAdd an audio track to the timelineA
Place an EXISTING audio asset (a generated voiceover, a music track, any audio URL) on the timeline at a specific point so it's in the render. duration defaults to the full movie length (ideal for background music); pass sourceDuration for a fixed clip like a voiceover. Get a voiceover url/durationSec from get_project (project.voiceover / voiceovers[]). Blocked in read-only mode.
Inputs: url (required), projectId (required), s3Key, title, +6 more.
add_timeline_overlayAdd an image/logo or text overlay to the timelineA
Overlay an EXISTING image/logo OR a text caption on the timeline at a specific point. For an image, pass imageId (already in the project — url auto-resolved) or a direct url; for text, pass text. position is percent-of-canvas (0-100) from the top-left. Blocked in read-only mode.
Inputs: projectId (required), url, size, text, +8 more.
api_requestCall any API endpointA
Generic authenticated request to ANY backend route. Path is relative to the API base (e.g. '/projects' or 'admin/users'). Use list_endpoints to discover paths. Non-GET methods are blocked when MCP_READONLY is set. Returns { status, ok, request, data } including error envelopes.
Inputs: path (required), method (required), body, query.
edit_imageEdit a project image (Gemini)A
Create a non-destructive, versioned edit of a project image. editType: staging/destaging, twilight(+_interior), upscale, green_grass, bright_day, seasonal (winter/halloween/christmas +_interior), advanced replace/remove/add (need advancedParams), or manual (customPrompt). staging needs roomType+style. Async — returns a jobId; the new version appears on the image. Costs 1 credit.
Inputs: imageId (required), editType (required), projectId (required), style, +3 more.
generate_clipGenerate a video clip from a project imageA
Animate one still project image into a video clip (Runway Gen-4). Async — returns a jobId; poll get_clip_status. imageUrl is auto-resolved from the project if omitted. Costs credits.
Inputs: motion (required), imageId (required), projectId (required), duration, +4 more.
get_clip_statusCheck clip generation statusA
Poll a clip-generation job started by generate_clip (GET /clip-generation/clip-status/:jobId).
Inputs: jobId (required).
get_projectGet a projectA
GET /projects/:id — full project document for the authenticated user.
Inputs: id (required).
get_usageGet usageA
GET /billing/usage — credit and export usage for the authenticated user.
Inputs: no named parameters.
helpHow to use this server (start-to-finish walkthrough)A
Guided, numbered walkthrough of the whole pipeline — sign in → create a project → add photos → edit → animate clips → add music/voiceover/overlays → arrange → render — with example args and the gotchas (async polling, paid gating). Call this first if you're not sure where to start.
Inputs: no named parameters.
list_clipsList clipsB
Clips for the authenticated user. With projectId -> GET /clips/project/:projectId; otherwise GET /clips (the clip library) with paging/status.
Inputs: page, limit, status, projectId.
list_endpointsList API endpointsA
Return the curated catalog of API endpoints (grouped) so you know what api_request can call. Not exhaustive — every mounted route is reachable, this covers the main surface.
Inputs: no named parameters.
list_moviesList moviesC
Rendered movies for the user. With projectId -> GET /movies/project/:projectId; else GET /movies.
Inputs: projectId.
list_projectsList projectsA
GET /projects for the authenticated user. Supports paging, sorting, search, and status filter.
Inputs: page, limit, search, sortBy, +4 more.
list_voicesList voicesA
GET /voices — voiceover voices available to the user (stock + cloned).
Inputs: no named parameters.
loginLog inA
Authenticate with the backend. If not already logged in, returns an authorization URL to open in your browser; approve the sign-in and the token is cached in the background, then retry your action. (Browser-based login can't be popped reliably from here, so you click the link.)
Inputs: no named parameters.
logoutLog outA
Clear the cached OAuth session (and best-effort revoke it server-side) so the next tool call re-authenticates via the browser. Use to switch accounts or reset a broken auth state.
Inputs: no named parameters.
move_timeline_elementRetime a timeline elementA
Change when a single timeline element starts and/or how long it lasts (any track). Use to nudge a floating audio/overlay element to a new point. To resequence all clips, use reorder_timeline. Element ids come from get_project (timeline.tracks[].elements[].id). Blocked in read-only mode.
Inputs: elementId (required), projectId (required), duration, startTime.
project_statsProject statsA
GET /projects/stats — aggregate project counts/metrics for the authenticated user.
Inputs: no named parameters.
render_movieRender the final movie for a projectA
Assemble the project's timeline into the final video (clips + music + watermark + overlays). Only projectId is required; settings fall back to the project. Async — returns a jobId; poll list_movies. Costs credits and an export.
Inputs: projectId (required), settings, aiGeneratedLabel.
reorder_timelineReorder timeline elementsA
Rearrange a track's elements (defaults to the video/clip track) into the given order and recompute sequential startTimes so they play back-to-back. Pass element ids in the desired order; omitted elements keep their relative order and are appended after. Ids come from get_project. Blocked in read-only mode.
Inputs: order (required), projectId (required), gap, trackId.
resolve_addressGeocode a free-text addressA
Resolve a free-text address into ranked candidates (formatted, placeId, location, components). Use before creating a project for a real listing — pass the chosen candidate as the project address so listing facts (price/beds/baths) auto-populate. Prefer candidates with isStreetLevel=true.
Inputs: query (required), limit.
whoamiWho am IA
Show the upstream MCP URL, read-only flag, the account plan, whether writes are allowed (canWrite) with a plain-language writeAccess reason, and the live /users/profile response for the OAuth-authenticated user. Good first call to confirm auth and whether create/generate/render tools will work (free accounts are read-only over the MCP). If not signed in, it returns a 'run login' error — use the login tool.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Tools are mostly distinct with clear purposes. Minor overlap between timeline-related tools (add_timeline_audio, add_timeline_overlay, move_timeline_element, reorder_timeline) is mitigated by detailed descriptions. Generic api_request could overlap but is explicitly for non-standard routes.
Naming conventions are mixed: most tools use verb_noun (e.g., add_image, list_projects), but some use noun-like patterns (project_stats, whoami, help). All use underscores, but the pattern is not uniform.
23 tools is slightly on the high side but still reasonable for the comprehensive pipeline (auth, project management, image editing, timeline, rendering, billing). Each tool serves a distinct function, so the count is justified.
Several obvious gaps exist: there is no create_project, delete_project, or update_project tool. Timeline manipulation lacks a remove_timeline_element tool. The surface relies on api_request for missing operations, but that is not ideal for a coherent tool set.
Maintenance
Related MCP Connectors
Make and edit real estate listing videos, photos and websites from your AI assistant.
MCP server giving Claude AI access to 22+ NYC public-record databases for real estate due diligence
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Enhance, virtually stage and make listing videos from real estate photos with AI.
Related MCP Servers
- AlicenseAqualityDmaintenanceBuilt an MCP server that connects Claude Desktop, Cursor, or any MCP client to Northeast Deal Intel's CRE database. 8 tools: • search_deals — filter 14K+ active listings by state, type, score, cap rate • search_comps — 100K+ closed transactions for comp benchmarking • score_deal — submit any property for AI scoring against real comp data • find_1031_candidates — exchange-ready deal filter (price8MIT
- AlicenseAqualityCmaintenanceMCP server for AI-powered image, audio, and video generation, enabling media creation directly from Claude, Cursor, and other MCP clients.1141 npmMIT

arcframe-mcpofficial
AlicenseNot gradedqualityDmaintenanceGenerate videos, images, audio, and 3D models from any MCP-compatible AI agent — Claude, Cursor, ChatGPT, and more.MIT- AlicenseNot gradedqualityDmaintenanceOpen-source MCP server for AI virtual staging and real-estate photography editing. It turns the AI HomeDesign photo API into natural-language tools for virtual staging, redesign, photo enhancement, and more.MIT