HouseKraft MCP Server — AI Interior Design Tools for Claude, Cursor & VS Code

Ask In Plain Words

Say what you want.
The assistant does the rest.

MCP (Model Context Protocol) is the open standard AI assistants use to call outside tools. HouseKraft's MCP server gives your assistant all of HouseKraft's design tools.

"Stage this living room in a Scandinavian style."

Runs stage on your photo.

"Paint the walls sage green, then show it with oak floors."

Chains walls and flooring.

"Empty all 20 photos in this listing."

Runs bulk_unstage as one job.

"Make one walkthrough video through these three rooms."

Runs walkthrough_multi.

Setup

Connect in
one minute.

Create a key on the Developers page. It's shown once, so copy it straight away. Then add the server to your assistant.

MCP server

https://app.housekraft.co/api/v1/mcp

Claude Code

Run this once in a terminal:

claude mcp add --transport http housekraft https://app.housekraft.co/api/v1/mcp \
  --header "Authorization: Bearer $HOUSEKRAFT_KEY"

Cursor

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "housekraft": {
      "url": "https://app.housekraft.co/api/v1/mcp",
      "headers": { "Authorization": "Bearer hk_live_…" }
    }
  }
}

VS Code

Add this to .vscode/mcp.json. VS Code asks for the key the first time:

{
  "inputs": [
    { "type": "promptString", "id": "housekraft-key",
      "description": "HouseKraft API key", "password": true }
  ],
  "servers": {
    "housekraft": {
      "type": "http",
      "url": "https://app.housekraft.co/api/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:housekraft-key}" }
    }
  }
}

Claude Desktop

Settings → Developer → Edit Config, add this to claude_desktop_config.json and restart. Needs Node.js:

{
  "mcpServers": {
    "housekraft": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.housekraft.co/api/v1/mcp",
               "--header", "Authorization:${HOUSEKRAFT_AUTH}"],
      "env": { "HOUSEKRAFT_AUTH": "Bearer hk_live_…" }
    }
  }
}

Other MCP clients

Any client that speaks Streamable HTTP: this address, with this header:

https://app.housekraft.co/api/v1/mcp
Authorization: Bearer hk_live_…

Connectors in claude.ai and ChatGPT sign in with OAuth, which isn't offered yet. Use one of the assistants above for now.

How It Works

Built on
the same engine.

1

Photos in

Give a photo as an asset id or an https:// link, upload one with upload_image, use your Library, or pass on an earlier result.

2

Quick tools return images

They wait and return the finished image, with a small preview the assistant can see.

3

Longer tools return a job

Videos, bulk jobs and En Masse return a job, which the assistant checks with get_job.

4

Same account everywhere

Same key, same credits and refunds, results in the same Library as the website.

Its Tools

23 tools your
assistant can call.

Tool	What it does
`walls`	Repaints the walls with the colour you choose.
`flooring`	Replaces the floor: wood, tile, marble, vinyl, or a photo of a real product.
`material`	Changes the material of a surface, or of several marked areas at once.
`furniture`	Adds, swaps or removes a piece of furniture.
`lighting`	Relights the room for another time of day.
`weather`	Changes the weather and the view through the windows.
`stage`	Furnishes an empty room in a described style, a reference photo's style, or with exact pieces.
`unstage`	Removes furniture, rugs and decor, leaving the empty room.
`pov`	Shows the same room from another camera angle.
`editor`	Changes only what you point at.
`dollhouse`	Turns a 2D floor plan into a top-down 3D dollhouse render.
`panorama`	Builds a 360° panorama from 1 to 6 photos.
`walkthrough`	Turns one room photo into a short walkthrough video.
`walkthrough_multi`	Makes one continuous video through several photos in order.
`bulk_stage`	Stages up to 50 empty rooms in one job.
`bulk_unstage`	Empties up to 50 furnished rooms in one job.
`enmasse`	Shows one room with many options at once.
`upload_image`	Adds a photo to your Library and returns its asset id.
`get_job`	A run's status and result.
`list_jobs`	Your recent API and MCP runs.
`list_library`	Your HouseKraft Library: uploads and results.
`get_account`	Your credit balance and plan.
`get_tool_options`	The website's own choices: colours, floors, styles, angles.

MCP docs →About the API

FAQ

Questions,
answered.

What is the HouseKraft MCP server?

It is a Model Context Protocol server that lets AI assistants use HouseKraft's interior design tools. You ask in plain words, and the assistant picks the tool, runs it on your account and shows you the result.

Which AI assistants work with it?

Claude Code, Cursor, VS Code and Claude Desktop, plus any MCP client that supports Streamable HTTP.

Does it work as a connector in claude.ai or ChatGPT?

Not yet. Those connectors sign in with OAuth, which HouseKraft doesn't offer yet. Use one of the supported assistants with your API key for now.

What does it cost?

Runs use credits from your HouseKraft account at the same prices as the website and the API. Failed runs are refunded automatically.

Do I need a separate key?

No. It uses your HouseKraft API key. Deleting the key also stops the assistant.

Where do the results go?

Into your HouseKraft Library, the same as runs on the website or through the API.

Design byconversation.

Get your key, add the server, and ask your assistant to restyle a room.

Get your API key → Read the MCP docs

Say what you want.The assistant does the rest.