# AI HomeDesign MCP [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/AIHomeDesign/aihomedesign-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ai-homedesign-mcp

## Description
MCP server to virtually stage, redesign, enhance and declutter real-estate photos.

## Tools
Capabilities this server exposes over MCP:

- **list_capabilities** — List every tool, grouped by category
- **list_styles** — List allowed design styles, room types & widget options
- **describe_tool** — Show a tool's inputs + a ready‑to‑use example payload
- **virtual_staging** — Furnish an **empty** room in a design style
- **virtual_restaging** — Swap furniture in an **already‑furnished** room
- **interior_design** — Fully redesign a furnished room
- **enhance_image** — Improve lighting, sharpness & color
- **remove_items** — Declutter / remove furniture
- **day_to_dusk** — Turn a daytime exterior into dusk
- **change_wall** — Restyle a surface

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "ai-homedesign-mcp": {
    "url": "https://www.aihomedesign.com"
  }
}
```

## Documentation & README

# AI HomeDesign MCP Server — AI Virtual Staging, Home Staging & Interior Design for Claude

> An open‑source **Model Context Protocol (MCP) server** for **AI virtual staging**
> and **real‑estate photography** editing. It turns the
> [AI HomeDesign](https://www.aihomedesign.com) photo API into natural‑language
> tools, so **Claude** — or any MCP client — can do **virtual home staging**,
> **AI interior design**, photo enhancement, decluttering, and day‑to‑dusk
> conversions just by being asked.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Model Context Protocol](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-3776AB)](https://www.python.org)

---

## What is this?

**AI HomeDesign MCP Server** exposes the [AI HomeDesign V3 API](https://www.aihomedesign.com)
as a set of [Model Context Protocol](https://modelcontextprotocol.io) tools over
streamable HTTP. Any MCP‑compatible AI client — **Claude Desktop, Claude in the
browser, Cursor, and more** — can then run professional **real‑estate photo editing**
in plain English:

- 🛋️ **Virtual staging** — furnish an empty room with photorealistic AI furniture in a chosen design style. Digital **home staging** in seconds, with no physical furniture.
- 🎨 **Virtual restaging & AI interior design** — replace existing furniture or fully redesign a furnished room.
- ✨ **Image enhancement** — fix lighting, sharpness, and color balance for listing‑ready photos.
- 🧹 **Item removal / decluttering** — automatically remove furniture and clutter to reveal a clean space.
- 🌆 **Day to dusk** — convert a daytime exterior into a warm twilight / dusk scene.
- 🧱 **Wall, floor & ceiling changes** — restyle surfaces with a tasteful AI finish.

Because it speaks MCP, there is **no SDK to learn** — you describe what you want and
the model calls the right tool with the right parameters.

## Why virtual staging and home staging over MCP?

Traditional home staging means renting furniture and scheduling a shoot. **Virtual
staging for realtors** replaces that with an edited photo — but it still costs hours
in editing tools or days of turnaround from a staging service.

This server collapses that into a conversation: drop in a listing photo, pick a
style, and get back a downloadable, market‑ready image. It's **multi‑tenant** (every
caller uses their own AI HomeDesign key), **stateless**, and **self‑hostable**, so
it fits both a single agent and a production PropTech product.

---

## Available tools

| Tool | What it does | Input |
| --- | --- | --- |
| `list_capabilities` | List every tool, grouped by category | — |
| `list_styles` | List allowed design styles, room types & widget options | — |
| `describe_tool` | Show a tool's inputs + a ready‑to‑use example payload | tool slug |
| `virtual_staging` | Furnish an **empty** room in a design style | image + style + room |
| `virtual_restaging` | Swap furniture in an **already‑furnished** room | image + style + room |
| `interior_design` | Fully redesign a furnished room | image + style + room |
| `enhance_image` | Improve lighting, sharpness & color | image |
| `remove_items` | Declutter / remove furniture | image |
| `day_to_dusk` | Turn a daytime exterior into dusk | image |
| `change_wall` / `change_floor` / `change_ceiling` | Restyle a surface | image + room |
| `create_project` · `create_order` · `run_process` · `get_process` · `wait_for_result` | Low‑level primitives for full control | see `describe_tool` |

Every helper accepts an **image URL** or a **base64 image**, and returns
downloadable result‑image URLs.

**Supported design styles:** `prime`, `modern`, `farmhouse`, `scandinavian`,
`hampton`, `industrial`, `traditional`, `contemporary`.
**Supported room types:** bedroom, living‑room, kitchen, bathroom, dining‑room,
home‑office, outdoor, nursery.

---

## Quick start

### Option A — Connect to the hosted server (no setup)

1. **Get your API key.** Sign in at [aihomedesign.com](https://www.aihomedesign.com),
   open **API / Developer settings**, and copy your `x-api-key`.
2. **Generate your connector link.** Paste that key into the generator at
   **[aihomedesign.com/mcp](https://aihomedesign.com/mcp)**. The key is validated
   server‑side once, then stored **encrypted**; you get back a personal endpoint:

   ```
   https://mcp.aihomedesign.com/aihd_<your-token>/mcp
   ```

   Your raw key never appears in the URL.
3. **Add it to your AI assistant.** In Claude: **Settings → Connectors → Add custom
   connector**, name it *AI HomeDesign*, and paste the URL. Every tool shows up
   automatically. Works with any MCP‑compatible client.

> ⚠️ The connector link does not contain your raw key, but it **grants access to your
> account — treat it like a password.** Rotating your key in the AI HomeDesign
> dashboard revokes every link previously issued for it.

Server health check, no key needed: [`mcp.aihomedesign.com/health`](https://mcp.aihomedesign.com/health)

### Option B — Self‑host with Docker

```bash
git clone https://github.com/AIHomeDesign/aihomedesign-mcp.git
cd aihomedesign-mcp
cp .env.example .env      # add your AIHD_API_KEY (and DB_DSN/TOKEN_SECRET for multi-tenant)

docker build -t aihomedesign-mcp .
docker run -p 8080:8080 --env-file .env aihomedesign-mcp
```

The MCP endpoint is served at `http://localhost:8080/mcp` (streamable HTTP), with a
health check at `GET /health`.

### Option C — Run locally with Python

```bash
pip install -r requirements.txt
export AIHD_API_KEY=your_key_here
python app/server.py
```

---

## Configuration

All configuration is via environment variables — see [`.env.example`](.env.example).

| Variable | Purpose | Default |
| --- | --- | --- |
| `AIHD_API_KEY` | Default/fallback AI HomeDesign x‑api‑key | — |
| `AIHD_API_BASE` | API base URL | `https://api.aihomedesign.com/v3` |
| `PORT` | Listen port | `8080` |
| `DB_DSN` | Postgres DSN for token map + usage log (optional) | — |
| `TOKEN_SECRET` | Fernet key to encrypt user keys at rest (optional) | — |
| `MCP_CONNECTOR_BASE` | Base used to build connector links | — |
| `UPLOAD_DIR` / `PUBLIC_BASE` | Enable the built‑in image‑upload endpoint | — |

### Security & multi‑tenant design

- **Bring‑your‑own‑key:** each request carries the caller's own AI HomeDesign key; jobs run under that key.
- **Keys never sit in the URL:** the landing page validates a key, then mints an opaque
  `aihd_…` connector token; the raw key is stored **encrypted at rest** (Fernet) and
  swapped back in per request.
- **Usage logging** records the tool, status, and timing per call — never the raw key
  (only a short, non‑reversible fingerprint).
- **Graceful degradation:** if the database is unreachable, the server keeps serving.

---

## How it works

```
MCP client (Claude, Cursor, …)
        │  streamable HTTP  /mcp
        ▼
AI HomeDesign MCP server  ──►  AI HomeDesign V3 API  ──►  result image URLs
   (this repo)                  (api.aihomedesign.com)
```

The server is built on [FastMCP](https://modelcontextprotocol.io) and Starlette/uvicorn,
with a pure‑ASGI auth middleware that binds the per‑request key.

## Tech stack

Python 3.12 · [MCP](https://modelcontextprotocol.io) (FastMCP) · Starlette · uvicorn ·
httpx · PostgreSQL (optional) · Docker.

## FAQ

### What is an MCP server?

An **MCP server** exposes tools, data, and prompts to an AI model through the
[Model Context Protocol](https://modelcontextprotocol.io) — an open standard
introduced by Anthropic. The model discovers the available tools at runtime and
calls them itself, so you never write glue code against a bespoke SDK. This repo is
an MCP server whose tools happen to edit real‑estate photos.

### How do you virtually stage a photo with this?

Connect the server to Claude, then send an empty‑room photo and ask for a style —
for example *"stage this living room in a scandinavian style."* Claude calls the
`virtual_staging` tool with the right parameters and returns a downloadable,
photorealistic image. No manual editing, no design software.

### Is this AI virtual staging free?

The MCP server itself is open source and MIT‑licensed, so you can self‑host it at no
cost. The image processing runs on the [AI HomeDesign](https://www.aihomedesign.com)
API and uses your own API key.

### Does it work with clients other than Claude?

Yes. It speaks standard MCP over streamable HTTP, so any MCP‑compatible client —
Claude Desktop, Claude in the browser, Cursor, and others — can use it.

### What is the difference between virtual staging and virtual restaging?

**Virtual staging** furnishes an *empty* room. **Virtual restaging** swaps the
furniture in an *already‑furnished* room. Use `interior_design` when you want to
redesign a furnished room completely rather than just replace the furniture.

---

## Learn more

- 🔌 Connect in one click: [aihomedesign.com/mcp](https://aihomedesign.com/mcp)
- 🌐 Website: [aihomedesign.com](https://www.aihomedesign.com)
- 📖 Model Context Protocol: [modelcontextprotocol.io](https://modelcontextprotocol.io)

## Contributing

Issues and pull requests are welcome. Please open an issue to discuss substantial
changes first.

## License

Released under the [MIT License](LICENSE).

---

<sub>Keywords: MCP server · Model Context Protocol · Claude MCP · Anthropic MCP · MCP tools ·
virtual staging · AI virtual staging · virtual staging software · home staging ·
virtual staging for realtors · AI home design · AI interior design · real estate photography ·
real estate photo editing · virtual restaging · day to dusk · image enhancement ·
item removal · real estate AI · PropTech.</sub>