get_capabilitiesRead supported styles, rooms, formats, credit cost and connection requirements. No render is created.
Your assistant.
Your next room.
Bring virtual staging and room redesign into an agent workflow. Start with one room photo, approve one image credit, and return to a saved design.
One photo. A complete workflow.
- Connect and prepare
Sign in to your Room & Story account, review Data & privacy, and create an expiring agent key with a render allowance.
- Get a quote
Upload a JPG, PNG or WebP, choose a style, and receive a quote for one image credit. Quoting does not start generation.
- Generate and retrieve
Authorize the credit, submit the quote, then check the saved job. Your assistant can retrieve a preview and private download links.
Choose what changes.
Virtual staging
Change movable furniture and decor while preserving architecture and fixed finishes.
Room redesign
Explore furnishings, colours and materials while keeping the structural layout.
Every result is a visual concept. Compare it with the original before using it in property marketing. Label it After · Room & Story concept.
Explore original and concept examples ↗Tools with a clear purpose.
upload_imageSave a private room image (base64, maximum 9 MiB). Requires the connected user to accept upload terms in Data & privacy first. Does not generate or spend credits.
quote_projectValidate an uploaded image and design brief and quote exactly one image credit. Does not reserve credits or generate. Quote expires after 15 minutes.
create_renderSpend at most one existing image credit to submit the quoted design. Only call within the user’s authorized budget. Reuse the exact quote on retries to prevent duplicate charges. Never automatically request a new quote after an uncertain response.
get_jobRead or reconcile a saved render owned by the connected account. Poll no more often than every 15 seconds. Never regenerate a saved result.
export_projectReturn the original and generated concept download links for one completed render. Optionally include a small image preview. Full-resolution downloads use the owner’s session or authenticated agent download endpoint. Does not publish or make files public.
Built for other people’s agents.
Connect any MCP client that supports Streamable HTTP and a secret Authorization header. Each customer signs in to their own account and creates their own key. No private plugin invitation is required.
https://roomandstory.com/api/mcp
Keys can read and download your saved designs. Give a key a positive render allowance to enable uploads and generation, or choose read-only access. Set an expiry and revoke access whenever you need to.
Full-resolution downloads remain private and work with the same account key. Your agent can also return a preview and a Studio link. No tool automatically purchases credits or publishes your images.