API keys

Use HouseKraft's tools from your own code. Each run uses credits from your HouseKraft account, the same balance as the website.

Get your API key

API keys belong to your HouseKraft account. Sign in to HouseKraft and create your key on the Developers page. It is shown once, so copy it straight away. The same key works for the API and for AI assistants (MCP).

Available to accounts with an active paid plan, or that have bought credits.

Quick start

Send your key in the Authorization header. Quick tools answer with the finished result; longer ones answer with a job to check until status is done. The file is at job.output.url.

0. Keep your key in an environment variable

export HOUSEKRAFT_KEY=hk_live_…

1. Upload a photo

curl -s -X POST https://app.housekraft.co/api/v1/uploads \
  -H "Authorization: Bearer $HOUSEKRAFT_KEY" \
  -F image=@room.jpg

2. Run a tool

curl -s -X POST https://app.housekraft.co/api/v1/tools/walls/run \
  -H "Authorization: Bearer $HOUSEKRAFT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "<asset id from step 1>", "color_id": "sage green"}'

3. If the answer says "running": get the result

curl -s https://app.housekraft.co/api/v1/jobs/<job id> \
  -H "Authorization: Bearer $HOUSEKRAFT_KEY"

Docs and examples for every tool Guide (JSON) Pricing

Use with AI assistants (MCP)

Add HouseKraft to Claude Code, Cursor, VS Code or Claude Desktop with the same key, then ask in plain words, e.g. "stage this living room in Scandinavian style". Runs use your credits, as above.

MCP server

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

Add it to your assistant

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, then 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

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

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

MCP docs and its tools