Metadata-Version: 2.5
Name: roomvana-mcp
Version: 0.1.2
Summary: MCP server for Roomvana — browse room types & design styles and get a direct link to the Roomvana studio. Redesign your house, yard or any room from a photo at https://roomvana.ai
Project-URL: Homepage, https://roomvana.ai
Project-URL: Source, https://github.com/TJLDC/roomvana-mcp
Project-URL: Issues, https://github.com/TJLDC/roomvana-mcp/issues
Author: Roomvana
License-Expression: MIT
License-File: LICENSE
Keywords: ai,home-design,interior-design,mcp,modelcontextprotocol,roomvana
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Artistic Software
Classifier: Topic :: Internet
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp<3,>=2.3.0
Description-Content-Type: text/markdown

# Roomvana MCP server (Python)

An [MCP](https://modelcontextprotocol.io) server for **[Roomvana](https://roomvana.ai)** — AI home design for houses, yards and rooms. It lets an AI assistant browse the room types and design styles Roomvana supports and hand the user a studio link with their choices pre-selected. Upload a photo of your house, yard or any room and see it redesigned at **[roomvana.ai](https://roomvana.ai)**.

Read-only and no sign-in required: this server never uploads photos or spends credits. The actual redesign happens on the website.

## Tools

| Tool | Parameters | What it does |
| --- | --- | --- |
| `list_design_styles` | none | Lists the design styles Roomvana can render (modern, japandi, industrial, coastal, …), each with a short description. |
| `list_room_types` | none | Lists the rooms and outdoor spaces Roomvana can redesign — interior rooms, house exterior, and garden/patio/backyard. |
| `design_a_room` | `room` (string, required), `style` (string, optional), `notes` (string, optional) | Returns a [roomvana.ai](https://roomvana.ai) studio link with the chosen room and style pre-selected; validates both against Roomvana's live catalog. `notes` is free text that is echoed back to the user, not encoded in the link. |

## Use the hosted endpoint

Roomvana also runs the same tools over Streamable HTTP at `https://api.roomvana.co/mcp` — no install, no API key.

Claude Code:

```bash
claude mcp add --transport http roomvana https://api.roomvana.co/mcp
```

Or point any MCP client at it with a JSON config:

```json
{
  "mcpServers": {
    "roomvana": {
      "type": "http",
      "url": "https://api.roomvana.co/mcp"
    }
  }
}
```

## Run locally

Requires Python 3.10+ and [uv](https://docs.astral.sh/uv/).

```json
{
  "mcpServers": {
    "roomvana": {
      "command": "uvx",
      "args": ["roomvana-mcp"]
    }
  }
}
```

Add that to your MCP client config (Claude Desktop: `claude_desktop_config.json`; other clients: their MCP config file), then restart the client.

### From source

```bash
uv sync
uv run roomvana-mcp
```

## Example

> "I want to redo my bedroom in a japandi style."

The assistant calls `design_a_room` with `room=bedroom`, `style=japandi` and returns:

```
https://roomvana.ai/design?room=bedroom&style=japandi
```

Open it, upload a photo of the room, and generate a redesign. Your walls, windows and layout stay put — only the look changes.

## How it works

The list of supported rooms and styles is fetched live from Roomvana's public catalog endpoint (`https://api.roomvana.co/options`), so the server never offers something Roomvana can't render. If that endpoint is unreachable, it falls back to a bundled snapshot.

## Links

- Website: https://roomvana.ai
- Design studio: https://roomvana.ai/design

## License

MIT
