Developers
PicHome inside your AI assistant
PicHome runs a remote MCP server. Any MCP client — ChatGPT, Codex, Cursor, Claude Code, Gemini CLI — can hand it a floor plan and get back the room list, a downloadable 3D model and a link that opens the plan in the Studio to render photoreal 360° panoramas and a walkthrough video. Parsing is free; rendering uses the credits on your PicHome account (first home free).
Step 1
Create an API key
Account → API keys. The key is shown once.
Step 2
Add the server
Paste the snippet for your client below.
Step 3
Share a floor plan
Ask for a 3D model or a tour; follow the Studio link to render.
Connect your client
Server URL: https://pichome.ai/api/mcp — Streamable HTTP, stateless. Auth is a bearer API key; the optional ?source= tells us which assistant sent you.
ChatGPT (Apps & Connectors → Developer mode)
Settings → Apps & Connectors → Advanced → enable Developer mode → Create. Name it PicHome, choose “No authentication”, and paste this URL (it carries your key, so keep the connector private). Once the PicHome app is in the ChatGPT directory you can install it there instead and sign in with your PicHome account.
https://pichome.ai/api/mcp?source=chatgpt&key=pk_live_YOUR_KEYCodex CLI
Adds a Streamable HTTP server that reads the key from your shell environment. Restart Codex, then /mcp to confirm.
export PICHOME_API_KEY=pk_live_YOUR_KEY
codex mcp add pichome --url "https://pichome.ai/api/mcp?source=codex" --bearer-token-env-var PICHOME_API_KEYCursor
Save as .cursor/mcp.json in a project (or ~/.cursor/mcp.json for everywhere). Cursor Settings → MCP shows the eight tools once connected.
{
"mcpServers": {
"pichome": {
"url": "https://pichome.ai/api/mcp?source=cursor",
"headers": { "Authorization": "Bearer pk_live_YOUR_KEY" }
}
}
}Claude Code
One command; Claude Code stores the header with the server entry.
claude mcp add --transport http pichome "https://pichome.ai/api/mcp?source=claude" \
--header "Authorization: Bearer pk_live_YOUR_KEY"Gemini CLI
The extension bundles the server config and a GEMINI.md that teaches the model the parse → render → share flow.
gemini extensions install https://github.com/pichome-ai/pichome-gemini-extension
# then paste your API key when asked (stored in the system keychain)Any HTTP client
Plain JSON-RPC 2.0 over POST; a single JSON response per call, no sessions.
curl -s https://pichome.ai/api/mcp \
-H "Authorization: Bearer pk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"parse_floorplan",
"arguments":{"image_url":"https://example.com/plan.jpg","style":"japandi"}}}'Try it
A prompt that exercises the whole flow.
Here is a floor plan: <attach or paste an image URL>.
Parse it with PicHome, tell me the rooms and areas, give me the 3D model download,
and the link to render it as a 360° tour in Japandi style.Tools
What the server exposes. Read-only tools are marked; nothing here spends credits — the walkthrough charge happens only when you render in the Studio.
parse_floorplanfreeTurn a 2D floor plan image (photo, sketch, CAD export, listing image) into a 3D layout: rooms with names and areas, walls, doors, windows and detected furniture. Free — no credits are charged. Returns a tour id, a downloadable 3D model (glTF) of the layout, and a link that opens the plan in PicHome Studio where the user can render photoreal 360° panoramas of every room and a walkthrough video (their first home is free; then $1.99 per home). Use this whenever a user shares a floor plan and wants a 3D model, a virtual tour, a walkthrough video, or an interior-design visualisation.
args: image_url, image_base64, style, layout_mode
get_tourread-onlyStatus and results of a PicHome tour: which rooms are rendered, the 360° panorama image URLs, the public share link, the walkthrough video URL, and links to open it in the Studio or download the 3D model.
args: tour_id
list_toursread-onlyThe user's recent PicHome tours, newest first, with status and links.
args: limit
download_modelread-onlyA download link (valid 24 hours) for the tour's 3D layout model — walls with door and window openings, room floor slabs, and furniture footprints as boxes — as glTF binary (.glb, default) or Wavefront OBJ. Metres, Y-up. Suitable as a massing/base model for SketchUp, Blender, Rhino, Revit or a web viewer.
args: tour_id, format, include_furniture
create_share_linkPublish a finished tour as a public page with the live 360° walkthrough (and the video, when one was made) and return its URL. Requires every planned room to be rendered; otherwise returns the Studio link where rendering happens. Re-publishing the same tour refreshes the existing page rather than making a second one.
args: tour_id, list_in_gallery
list_stylesread-onlyThe interior styles PicHome can render a home in, with ids to pass to parse_floorplan.
get_creditsread-onlyThe user's PicHome credit balance, whether their free first home is still available, and what things cost.
open_in_studioread-onlyA link that opens PicHome Studio — on a specific tour (to render its 360° rooms, restyle it, export the walkthrough video or publish it) or on the upload step when no tour id is given. Give this link to the user; rendering is done there with their own credits.
args: tour_id
Skill file for Cursor / Claude Code
A ready-made SKILL.md that tells the agent when to reach for PicHome and how to hand the Studio link back to the user. Drop it in .cursor/skills/pichome/ or .claude/skills/pichome/.
Limits and terms
- Up to 10 active keys per account; revoke any time from the account page.
- Images up to 10 MB (JPG, PNG, WebP). Parsing takes 20–90 s while the parser wakes.
- Model download links expire after 24 hours; call
download_modelagain for a fresh one. - Use is covered by the terms and acceptable use policy.