PropWalk, for developers.

When to use PropWalk

• Posts for a listing. A real estate agent wants social media posts for a home they are selling. Give PropWalk the address or the Zillow link and it makes a week of posts and a walkthrough video, captions and hashtags written. Tools: add_listing (find_home when the address is vague), then build_week.
• Posts with no listing. An agent with no listing needs something to post: buyer and seller how-tos, local market numbers and checklists for their town, with their name on every post. Tool: build_topic_week.
• Posting it for them. Book the posts to the agent’s own Instagram, Facebook and TikTok at good times, then move or cancel them. Tools: connect_social, schedule_week, schedule_post, reschedule_post.
• One post. Just listed, open house, price drop, just sold, a how-to or a short series. Tools: make_listing_post, make_topic_post, make_series.
• A walkthrough video. A walkthrough video made only from the listing’s own photos, tall for Reels and TikTok and wide for Zillow and the MLS. Tools: make_listing_videos, then check_job.
• Listing photo edits. Virtual staging, relighting, decluttering, a new sky or exterior, renovation previews. Tools: stage_photos, relight_photos, declutter_photos, enhance_exterior, renovate_photos.
• How the posts are doing. Reach, the best post, what to post next, and the leads from listing websites. Tools: performance_report, post_metrics, list_leads.

Not a fit: social media for businesses outside real estate, or posting anywhere but Instagram, Facebook and TikTok.

The MCP server

• Endpoint: https://propwalk.io/mcp (Streamable HTTP). Each request is one JSON-RPC message or a batch, answered with JSON; no sessions and no event stream. The same server answers at https://propwalk.io/api/mcp, the address the connect page gives people.
• Protocol version 2025-06-18, with tools and prompts. initialize returns instructions for the assistant: the order things go in, say the price before spending credits, check long jobs on its own.
• Long jobs (videos, photo edits) return a job_id; call check_job every 20 to 30 seconds until it is done. Finished pictures come back inline.
• Discovery: a Server Card at https://propwalk.io/mcp/server-card (the experimental MCP Server Card extension) and an AI Catalog at https://propwalk.io/.well-known/ai-catalog.json.

Sign-in (OAuth)

• Every call needs Authorization: Bearer <token>. Without one the server answers 401 with a WWW-Authenticate header that points at its OAuth metadata, so MCP clients start sign-in on their own.
• OAuth 2.1 authorization code flow with PKCE (S256) and the scope propwalk. Clients register themselves (dynamic client registration at https://propwalk.io/api/oauth/register) or use a client ID metadata document URL; no client secret.
• Discovery: https://propwalk.io/.well-known/oauth-protected-resource/mcp (RFC 9728) and https://propwalk.io/.well-known/oauth-authorization-server (RFC 8414).
• The person signs in to PropWalk and approves the app. They see and disconnect connected apps in Settings.

Getting access

• No sales call and no API key to ask for: sign up at https://propwalk.io/login?mode=signup&next=/studio, then add the server to an assistant.
• Free plan: $0, no card. 7 posts a month (one week) you download and post yourself, and one walkthrough video a month (15 seconds from up to 5 photos, 720p). No watermark.
• Free trial: 3 days on Starter or Pro, monthly or yearly, card up front, one per customer. Everything in the plan works from the first minute, posting included. Cancel before the 3 days end and nothing is charged; otherwise the first charge (the month, or the year on a yearly plan) lands when the free days end.
• Sandbox: https://propwalk.io/mcp/sandbox speaks MCP with no sign-in. It lists the real tools and answers every call with sample data; nothing is saved, spent or posted.
• Then a Free account is the safe place to try it for real: reading tools are free, and each tool’s description says what it costs.

Limits

• Each account has daily safety caps on the calls and on the credits spent through connected apps. A tool that reaches one says so, and when it resets.
• Plans and credits work exactly as in the app. A tool that needs a plan or more credits answers with a plain sentence and the link that fixes it.

Markdown for agents

• Send Accept: text/markdown to https://propwalk.io/ or to this page and the same URL answers in Markdown, with Vary: Accept. An address that does not exist answers 404 with a short Markdown note.
• https://propwalk.io/llms.txt is the site in one Markdown file: what PropWalk is, the prices and every public page. https://propwalk.io/llms-full.txt has every page’s text inlined.

The 48 tools

• propwalk_credits Account overview: who the agent is, plan, credit balance (and what it buys), free walkthrough left, listing websites left this month, connected social accounts, posts used this week and how far ahead posts can be booked.
• stage_photos Virtually stage empty or sparse real-estate rooms — adds tasteful furniture and decor while keeping the room's architecture.
• relight_photos Relight and color-correct listing photos — brightens, balances, and cleans up poorly lit interior shots without changing the room.
• enhance_exterior Transform a home's exterior photo — swap the sky/season/time-of-day and freshen the yard.
• declutter_photos Remove clutter and personal items from occupied-home photos (counters, toys, cords, laundry) while leaving the room intact.
• renovate_photos Preview a renovation on a room photo — repaint walls, refinish cabinets, or swap flooring.
• upload_image Upload image bytes (base64) and get back hosted https URLs for use with any PropWalk tool.
• upscale_photo Upscale one finished PropWalk photo into a print/MLS-ready high-res file.
• generate_walkthrough Create a cinematic walkthrough VIDEO of a listing from its photos (in tour order).
• generate_video_clip Generate a short marketing VIDEO clip from a text prompt (5–15s).
• generate_image Generate a marketing IMAGE from a text prompt (flyers, social graphics, concept shots).
• enhance_prompt Expand a rough idea into a detailed generation prompt.
• check_job Check a generation started by another tool; when finished it returns the result and renders finished photos inline.
• build_week PropWalk's core: build a listing's week of social posts — Just listed, photo tour, the walkthrough video, features, the numbers, a standout photo, book a showing — designed, written and captioned with the agent's name and brokerage, the same week the app's "Make my week" builds.
• list_posts List the caller's recent weeks and posts (kits), or (with kit_id) every post in one kit — title, caption, format, booking status — with the covers already drawn shown inline.
• schedule_post Book one post to go out on the agent's connected Instagram / Facebook / TikTok at a set time — PropWalk posts it for them.
• post_metrics Read engagement numbers (saves, likes, comments, shares, reach) for scheduled posts — one kit (kit_id) or everything scheduled in the last N days.
• brand_kit Read the caller's brand kit — agent name, brokerage, phone, license, logo/headshot URLs, and a light read on their caption voice (emoji use, sentence length, sign-off).
• update_profile Change what goes on every post and page: the agent's name, brokerage, phone, license, market (city, state), booking link, brand colors, headshot and logo links, MLS disclosure.
• connect_social See which Instagram / Facebook / TikTok accounts PropWalk posts to, and get the link to connect one (connecting happens in the browser on the network's own sign-in page).
• find_home Look a home up by a partial address and get exact matches (with their Zillow links) to pass to add_listing.
• add_listing Address in: bring a home into PropWalk from its address or Zillow link.
• list_listings The agent's listings, newest first: id, address, price, photos, videos, latest week and website link.
• get_listing Everything about one listing: facts, description, features, photo links (first ones shown), videos, latest week, website link and its visits and leads.
• update_listing Change a listing: price, description, beds, baths, sqft, features, its stage (coming-soon, active, open-house, pending, sold — sold also marks the date), the open house time, the website's banner photo, or publish/unpublish its website.
• add_listing_photos Add photos to a listing (public https links; upload_image first for attached photos).
• write_listing_copy Write copy for a listing from its facts and photos: the MLS description (headline, short / medium / long, features, room notes, fair-housing check) or 3 Facebook/Instagram ad variants.
• build_topic_week No listing?
• make_listing_post Make one post for a listing (a carousel or photo post, designed and captioned): just listed, open house, price drop, just sold, the kitchen, guess the price, and more.
• make_topic_post Make one post that needs no listing: a how-to, a checklist, mistakes to avoid, what it costs, the agent's take, an intro, a day in the life, or an ask-me-anything.
• make_series A multi-part series on one topic (2-7 posts, "Part 1 of 5"…), booked a few days apart automatically when an account is connected.
• trending_topics What real-estate topics are trending for agents right now (ranked from real posts' numbers), or search the full topic bank.
• get_post Show one post: every slide as an image, the words on each slide, the caption and hashtags, its look, and its video or voiceover if it has one.
• edit_post Change a post in plain words, like the app's post chat: "shorter caption", "swap slide 3 to the kitchen photo", "make the headline about the pool", "rewrite it for first-time buyers".
• list_looks Browse the post looks (200+ designs: photo-first, paper, editorial, glass, bold, collage…), with sample images.
• change_look Change the look of one post (day) or a whole week.
• narrate_post Turn a listing post into a voiceover reel (a voice reads it over the photos).
• schedule_week Fill my week: book every ready post in a week to go out one a day at good times on the agent's own clock (their best times once PropWalk has learned them), to every connected account.
• list_scheduled Every post booked to go out (and any that failed), with times, where it goes, and its schedule_id.
• reschedule_post Move a booked post to a new time.
• unschedule_post Cancel a booked post before it goes out.
• performance_report How it's going: posts, reach and engagement this week vs last, the best post, what to do next (Pro), plus listing website visits and leads over 90 days.
• list_leads The leads that came in from listing websites, shared videos and open-house sign-ins: name, email, phone, message, which listing, how warm.
• make_listing_videos One tap for a listing's videos from its own photos: the walkthrough tour (and the front-door entrance clip).
• list_videos Every walkthrough, cut and studio clip/image the agent has made, with links and ids.
• cut_video Cut a finished walkthrough into social videos, free: teaser, price reveal, door reveal, budget tour, full tour, rate-it, POV, one per room, and campaign versions (just listed, open house, price improved, pending, sold).
• brand_video Add a branded intro and/or outro (the agent's name, the address, the price) to a finished walkthrough.
• send_to_seller Email a finished video to the seller (or anyone) from PropWalk in the agent's name, with an optional note; replies go to the agent.

Prompts

• make_my_week Address in, week out: bring a listing in and get a week of posts made, shown and booked.
• no_listing_week Seven posts from your market (buyers, sellers, local, you) when you have no listing right now.
• weekly_check_in How last week went, what's booked, new leads, and what to post next.
• prep_listing Full pass on a set of listing photos: fix the lighting, clear clutter, and stage any empty rooms.
• fix_photos Rescue dark, cluttered, or flat listing photos without re-shooting.
• make_walkthrough Turn a set of listing photos into a cinematic walkthrough tour video.
• renovation_preview Show a seller or buyer what a room looks like with new paint, cabinets, or flooring.
• listing_marketing Generate social graphics and a short promo clip for a listing.