Roomvana MCP server (Python)
An MCP server for Roomvana — 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.
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 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:
claude mcp add --transport http roomvana https://api.roomvana.co/mcp
Or point any MCP client at it with a JSON config:
{
"mcpServers": {
"roomvana": {
"type": "http",
"url": "https://api.roomvana.co/mcp"
}
}
}
Run locally
Requires Python 3.10+ and uv.
{
"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
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
Metadata
Release files for roomvana-mcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| roomvana_mcp-0.1.2.tar.gz | 83.2 kB | Without provenance | Details for roomvana_mcp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| roomvana_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for roomvana_mcp-0.1.2-py3-none-any.whl |
Total release size: 93.5 kB
Release files / roomvana_mcp-0.1.2.tar.gz
| Download URL | roomvana_mcp-0.1.2.tar.gz |
|---|---|
| Size | 83.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
16b4bb28dfd00a41e3b04cd8f678cbf579551a26b7a1379f510570a5ec6a31c5
|
|
BLAKE2b-256 checksum How to use checksums |
8f90835a40ab7b6c58c6d85dc1978cc0c982772af400d932fea10d34f468b20d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.13 {"installer":{"name":"uv","version":"0.11.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / roomvana_mcp-0.1.2-py3-none-any.whl
| Download URL | roomvana_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 10.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
79871bfb09cd6a5ed3eb31f09e52907ca45146ec62eaad70ce7cfc2f53b2a428
|
|
BLAKE2b-256 checksum How to use checksums |
55dbd90163f016d3c8444ebab879ab3086a55410e1e0387c06577469d7eacf1c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.13 {"installer":{"name":"uv","version":"0.11.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for roomvana-mcp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.