Skip to main content
Glama

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-mcp

Claude 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

help

Guided, always-current walkthrough (also the getting_started prompt)

whoami

Confirm auth; reports plan, canWrite, and a writeAccess reason. Run first.

login / logout

Start browser sign-in / clear the session (server revoke + local cache)

list_projects · get_project · project_stats

Browse projects

list_clips · list_movies · list_voices

Browse clips, rendered movies, TTS voices

resolve_address

Geocode a free-text address → ranked candidates (for real-listing projects)

add_image_from_file

Upload a local image into a project (presigned upload — no storage creds)

ez_reel_add_photos · ez_reel_import_photos

Upload 10 to 20 local photos into EZ Reel (presigned), or reuse photos already in a project

ez_reel_catalog

EZ Reel templates and songs

ez_reel_create · ez_reel_quote · ez_reel_submit · ez_reel_status

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

list_reels

Browse EZ Reels

generate_clip · get_clip_status

Animate a photo into a video clip (Runway); poll the job

edit_image

AI photo edit — virtual staging, twilight, upscale, seasonal, replace/remove/add, manual

add_timeline_audio · add_timeline_overlay

Place voiceover/music/audio or an image/text overlay

move_timeline_element · reorder_timeline

Retime / resequence the timeline

render_movie

Assemble the timeline into the final listing video

list_endpoints · api_request

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 connection
  • No 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 login), open the printed URL, and approve.

Switch accounts / re-authorize

Run logout, or delete ~/.reel-estate-mcp.

Writes blocked (403 MCP_PAID_PLAN_REQUIRED)

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 /mcp URL, OAuth store dir, callback port, read-only flag, and default client id.

  • src/oauth.ts — OAuthClientProvider: uses the public client_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 / callApiRequest proxies.

  • src/api-client.ts — ApiClient over callApiRequest; enforces read-only.

  • src/catalog.ts — the endpoint catalog surfaced by list_endpoints.

  • src/tools.ts — tools as plain functions (smoke-testable).

  • src/index.ts — registers the tools as MCP tools over stdio.

Adding a tool

  1. Add async function fooBar(api, args) in src/tools.ts (use api.get(...) / api.request(...), which proxy through /mcp).

  2. Register it in src/index.ts with a Zod inputSchema.

  3. Add it to scripts/smoke.ts if 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 tools
add_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

    A3.5/5.0

    Scored across 23 tools

    Disambiguation4/5

    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 Consistency3/5

    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.

    Tool Count4/5

    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.

    Completeness2/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Built 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 (price
      8
      MIT