Skip to main content

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.

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)

Source distribution for roomvana-mcp 0.1.2
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)

Table of built distributions (wheels) for roomvana-mcp 0.1.2
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page