---
name: pichome
description: Turn a 2D floor plan image into a 3D layout model, photoreal 360° room panoramas, a walkable virtual tour and a walkthrough video with PicHome. Use when the user shares or mentions a floor plan, house plan, apartment layout, 户型图, or asks for a 3D model / virtual tour / walkthrough video / interior visualisation of a plan.
---

# PicHome — floor plan → 3D model, 360° tour, walkthrough video

PicHome is available as a remote MCP server. Use it through the `pichome` MCP tools
when they are connected; otherwise tell the user how to connect (below).

## When to use

- The user gives you a floor plan image (URL or file) and wants any of:
  a 3D model, room list with areas, a virtual tour, a walkthrough video,
  an interior-design visualisation, "what would this look like in X style".
- The user asks to check on, share or download a PicHome tour they started.

## Flow

1. `parse_floorplan` with `image_url` (public URL) or `image_base64`. Pass
   `style` (see `list_styles`; default `nordic`) and `layout_mode`
   (`keep` = furnish as drawn, `redesign` = AI re-plans each room) when the
   user has expressed a preference. **This is free** and takes 20–90 s.
2. Report the result plainly: room names and areas, the glTF/OBJ model link,
   and the **Studio link**. Rendering the 360° panoramas and the video is done
   by the user in the Studio with their own credits (first home free, then
   $1.99). Never imply that you rendered anything or spent credits.
3. Later, `get_tour` shows which rooms are rendered and gives the panorama,
   video and share URLs. `create_share_link` publishes a finished tour as a
   public page. `download_model` gives a fresh 24-hour model link.

## Rules

- Do not call `parse_floorplan` twice for the same image; reuse the tour id.
- If the image is not a floor plan (a photo, a render, a site plan), say so
  and ask for the plan drawing instead of calling the tool.
- Keep prices exact: parsing free; home of up to 5 rooms + video 100 credits
  ($1.99) after the free first home; new style for a finished home 60 credits;
  one room again 15 credits.
- The 3D model is a massing model (walls with openings, floor slabs,
  furniture boxes), in metres, Y-up — say so if the user expects textures.

## Connecting (if the tools are missing)

Ask the user to create an API key at https://pichome.ai/account, then:

- Cursor `.cursor/mcp.json`:
  `{"mcpServers":{"pichome":{"url":"https://pichome.ai/api/mcp?source=cursor","headers":{"Authorization":"Bearer pk_live_…"}}}}`
- Claude Code:
  `claude mcp add --transport http pichome "https://pichome.ai/api/mcp?source=claude" --header "Authorization: Bearer pk_live_…"`
- Codex:
  `codex mcp add pichome --url "https://pichome.ai/api/mcp?source=codex" --bearer-token-env-var PICHOME_API_KEY`

Docs: https://pichome.ai/developers