Room planning to scale from your AI: it places furniture, Roomproof checks walkways and door swings.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Re-checks the saved layout only: pieces sticking out, overlaps, blocked areas including door swings, and a 0.9 m path to every piece. Does not place, move or spend a wish. Call it after move_furniture or when issues are unclear; ok true with an empty issues list is the condition for open_plan. Needs key on your own project, free on beispiel-wohnzimmer.
Plan id from create_room, or beispiel-wohnzimmer.
Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id.
Variant id from a previous response; default the newest.
Re-checks the saved layout only: pieces sticking out, overlaps, blocked areas including door swings, and a 0.9 m path to every piece. Does not place, move or spend a wish. Call it after move_furniture or when issues are unclear; ok true with an empty issues list is the condition for open_plan. Needs key on your own project, free on beispiel-wohnzimmer.
| Argument | Type | Description |
|---|---|---|
| key | string | Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id. |
| project* | string | Plan id from create_room, or beispiel-wohnzimmer. |
| variant | string | Variant id from a previous response; default the newest. |
{
"type": "object",
"required": [
"project"
],
"properties": {
"key": {
"type": "string",
"description": "Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id."
},
"project": {
"type": "string",
"description": "Plan id from create_room, or beispiel-wohnzimmer."
},
"variant": {
"type": "string",
"description": "Variant id from a previous response; default the newest."
}
}
}Free, no key. Creates a new plan at scale 1:50 and returns its project id plus purchase_url. Send name, plus either width_m and depth_m (rectangle) or rectangles (L-shape, alcove, bay), never both. Always send openings in this same call; without openings the checker treats the room as having no doors and skips the door-swing check. Each side 0.3 to 200 m. Coordinates: x to the right, y down, origin at the room's top-left corner.
| Argument | Type | Description |
|---|---|---|
| key | string | Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id. |
| name | string | Name of the plan, e.g. Living room. Default My room. |
| depth_m | number | Depth in meters (top to bottom), 0.3 to 200. |
| width_m | number | Width in meters (left to right), 0.3 to 200. |
| openings | array | All doors and windows of the room. The swing area of every door becomes a blocked area that furniture must keep clear. |
| rectangles | array | Instead of width_m and depth_m: 1 to 12 partial areas in meters. kind add joins the area, kind cut removes it. x, y is the rectangle's top-left corner, w, h its size. |
{
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id."
},
"name": {
"type": "string",
"description": "Name of the plan, e.g. Living room. Default My room."
},
"depth_m": {
"type": "number",
"description": "Depth in meters (top to bottom), 0.3 to 200."
},
"width_m": {
"type": "number",
"description": "Width in meters (left to right), 0.3 to 200."
},
"openings": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"wall",
"center"
],
"properties": {
"kind": {
"enum": [
"door",
"window"
],
"type": "string",
"description": "door or window."
},
"wall": {
"enum": [
"left",
"right",
"top",
"bottom"
],
"type": "string",
"description": "The wall the opening sits in, as seen on the plan."
},
"hinge": {
"enum": [
"left",
"right"
],
"type": "string",
"description": "Doors only: the end that carries the hinges, default left. Omit for windows."
},
"width": {
"type": "number",
"description": "Width in meters, 0.4 to 6. Default 0.9 for a door, 1.2 for a window."
},
"center": {
"type": "number",
"description": "Center of the opening in meters along that wall, measured from the wall's top-left end: from the left end on the top and bottom walls, from the top end on the left and right walls."
}
}
},
"description": "All doors and windows of the room. The swing area of every door becomes a blocked area that furniture must keep clear."
},
"rectangles": {
"type": "array",
"items": {
"type": "object",
"required": [
"x",
"y",
"w",
"h",
"kind"
],
"properties": {
"h": {
"type": "number",
"description": "Height in meters, 0.3 to 200."
},
"w": {
"type": "number",
"description": "Width in meters, 0.3 to 200."
},
"x": {
"type": "number",
"description": "Left edge in meters."
},
"y": {
"type": "number",
"description": "Top edge in meters."
},
"kind": {
"enum": [
"add",
"cut"
],
"type": "string"
}
}
},
"description": "Instead of width_m and depth_m: 1 to 12 partial areas in meters. kind add joins the area, kind cut removes it. x, y is the rectangle's top-left corner, w, h its size."
}
}
}Moves, rotates or removes one piece in the saved layout and returns the re-checked plan as an image with issues. Send x and y together (piece center, meters), rot, or remove true. The result is saved even with issues, so read them and move again if needed. Needs key on your own project, free on beispiel-wohnzimmer (not saved).
| Argument | Type | Description |
|---|---|---|
| x | number | New piece center, horizontal, in meters. Send with y. |
| y | number | New piece center, vertical, in meters. Send with x. |
| key | string | Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id. |
| rot | number | New rotation in degrees clockwise. |
| index | integer | If several pieces share the name: which one, counted from 1 in list order. Default 1. |
| piece* | string | Display name from placed, furniture or issues in the last place_furniture, show_plan or check_plan response, e.g. 3-seat sofa. Not the catalog id. |
| remove | boolean | true removes the piece; x, y and rot are then ignored. |
| project* | string |
Call only after the last check_plan returned no issues. Returns view_url (read-only, to share) and edit_url (for the owner, with the scaled PDF download). Needs key; not available on beispiel-wohnzimmer.
| Argument | Type | Description |
|---|---|---|
| key | string | Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id. |
| new | boolean | true creates a new view_url and invalidates the previous share link. Only if the user wants that. |
| project* | string | Plan id from create_room. |
{
"type": "object",
"required": [
"project"
],
"properties": {
"key": {
"type": "string",
"description": "Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id."
},
"new": {
"type": "boolean",
"description": "true creates a new view_url and invalidates the previous share link. Only if the user wants that."
},
"project": {
"type": "string",
"description": "Plan id from create_room."
}
}
}Places furniture and returns the checked plan as an image plus placed, rejected, issues and image_prompt. Send exactly one of spots, placement, or wish. Prefer spots: you name each piece and a rough position (at), the server finds the exact spot, snaps to a 5 cm grid and avoids walls, doors and other pieces. Use placement only when the user gives exact positions; never invent x, y or rot. Use wish only when the user describes the room without naming pieces; it calls Roomproof's own model, is slower and less predictable. Every way is checked against the floor area, overlaps, blocked areas and a 0.9 m path; what does not fit comes back in rejected with a reason. Dimensions in millimeters; x and y in meters to the CENTER of the piece, from the room's top-left corner. Needs key on your own project, free on beispiel-wohnzimmer (nothing is saved there).
| Argument | Type | Description |
|---|---|---|
| key | string | Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id. |
| keep | boolean | Default false: the new pieces replace everything in the plan. true adds them to the pieces already there. |
| name | string | Name of the saved variant, default Draft. |
| wish | string | One sentence describing the room, e.g. a living room for four with a reading corner. Only without spots and placement. |
| spots | array | Preferred. 1 to 40 pieces, each with catalog or with name plus width_mm and depth_mm, plus at. Larger pieces are placed first. |
| blocked |
Free, no key. Turns a product link (IKEA, any furniture shop) or the pasted text of a product page into real dimensions: name, width_mm, depth_mm, height_mm, price, link. Call it as soon as the user gives a furniture link. On success pass name, width_mm, depth_mm, height_mm, price and link unchanged into a custom piece in place_furniture. If blocked is true, ask the user to paste the product page text and call read_product again with that text as input. Never guess millimeters; a missing dimension is listed in missing.
| Argument | Type | Description |
|---|---|---|
| input* | string | A product URL, or the pasted text of the product page. |
{
"type": "object",
"required": [
"input"
],
"properties": {
"input": {
"type": "string",
"description": "A product URL, or the pasted text of the product page."
}
}
}Replaces the full openings list of a project you created (an empty list removes all). Windows have no hinge. Until openings exist, door-swing clearance is not checked. Saved layouts may get new issues afterwards; run check_plan. Needs key; not available on beispiel-wohnzimmer.
| Argument | Type | Description |
|---|---|---|
| key | string | Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id. |
| project* | string | Plan id from create_room. |
| openings* | array | All doors and windows of the room, 0 to 20. Replaces the existing list completely. |
{
"type": "object",
"required": [
"project",
"openings"
],
"properties": {
"key": {
"type": "string",
"description": "Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id."
},
"project": {
"type": "string",
"description": "Plan id from create_room."
},
"openings": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"wall",
"center"
],
"properties": {
"kind": {
"enum": [
"door",
"window"
],
"type": "string",
"description": "door or window."
},
"wall": {
"enum": [
"left",
"right",
"top",
"bottom"
],
"type": "string",
"description": "The wall the opening sits in, as seen on the plan."
},
"hinge": {
"enum": [
"left",
"right"
],
"type": "string",
"description": "Doors only: the end that carries the hinges, default left. Omit for windows."
},
"width": {
"type": "number",
"description": "Width in meters, 0.4 to 6. Default 0.9 for a door, 1.2 for a window."
},
"center": {
"type": "number",
"description": "Center of the opening in meters along that wall, measured from the wall's top-left end: from the left end on the top and bottom walls, from the top end on the left and right walls."
}
}
},
"description": "All doors and windows of the room, 0 to 20. Replaces the existing list completely."
}
}
}Free, no key. Lists every piece Roomproof knows: catalog id (ASCII slug, copy it exactly), display name, width_mm, depth_mm, group. Call it with no group first. Custom pieces (name plus width_mm and depth_mm, e.g. from read_product) do not need the catalog.
| Argument | Type | Description |
|---|---|---|
| group | string | Optional filter. Must be one of the strings in groups from a previous show_catalog response, e.g. Living or Outdoor. |
{
"type": "object",
"properties": {
"group": {
"type": "string",
"description": "Optional filter. Must be one of the strings in groups from a previous show_catalog response, e.g. Living or Outdoor."
}
}
}Returns the saved plan as an image drawn to scale, plus image_prompt and image_positions. For a photo of the room copy image_prompt verbatim into your own image generator; Roomproof does not render photos. Needs key on your own project, free on beispiel-wohnzimmer.
| Argument | Type | Description |
|---|---|---|
| key | string | Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id. |
| project* | string | Plan id from create_room, or beispiel-wohnzimmer. |
| variant | string | Variant id from a previous response; default the newest. |
{
"type": "object",
"required": [
"project"
],
"properties": {
"key": {
"type": "string",
"description": "Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id."
},
"project": {
"type": "string",
"description": "Plan id from create_room, or beispiel-wohnzimmer."
},
"variant": {
"type": "string",
"description": "Variant id from a previous response; default the newest."
}
}
}| Plan id from create_room, or beispiel-wohnzimmer. |
| variant | string | Variant id from a previous response; default the newest. |
{
"type": "object",
"required": [
"project",
"piece"
],
"properties": {
"x": {
"type": "number",
"description": "New piece center, horizontal, in meters. Send with y."
},
"y": {
"type": "number",
"description": "New piece center, vertical, in meters. Send with x."
},
"key": {
"type": "string",
"description": "Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id."
},
"rot": {
"type": "number",
"description": "New rotation in degrees clockwise."
},
"index": {
"type": "integer",
"description": "If several pieces share the name: which one, counted from 1 in list order. Default 1."
},
"piece": {
"type": "string",
"description": "Display name from placed, furniture or issues in the last place_furniture, show_plan or check_plan response, e.g. 3-seat sofa. Not the catalog id."
},
"remove": {
"type": "boolean",
"description": "true removes the piece; x, y and rot are then ignored."
},
"project": {
"type": "string",
"description": "Plan id from create_room, or beispiel-wohnzimmer."
},
"variant": {
"type": "string",
"description": "Variant id from a previous response; default the newest."
}
}
}| array |
| Rectangles that must stay free (radiator, wall cupboard, walkway): x, y, w, h in meters from the room's top-left corner, not piece centers. Door swings are added automatically. |
| outdoor | boolean | With wish only: limit the model to outdoor furniture, for terraces and balconies. |
| project* | string | Plan id from create_room, or beispiel-wohnzimmer. |
| placement | array | Exact positions from the user, 1 to 60 pieces. Each with catalog or with name plus width_mm and depth_mm, plus x, y (meters to the piece center) and rot. Nothing is nudged: a piece that sticks out or overlaps is rejected. |
{
"type": "object",
"required": [
"project"
],
"properties": {
"key": {
"type": "string",
"description": "Purchase token rp_ plus 20 characters, from the purchase confirmation. Required on projects you created, not on beispiel-wohnzimmer. Not the project id."
},
"keep": {
"type": "boolean",
"description": "Default false: the new pieces replace everything in the plan. true adds them to the pieces already there."
},
"name": {
"type": "string",
"description": "Name of the saved variant, default Draft."
},
"wish": {
"type": "string",
"description": "One sentence describing the room, e.g. a living room for four with a reading corner. Only without spots and placement."
},
"spots": {
"type": "array",
"items": {
"type": "object",
"properties": {
"at": {
"type": "string",
"description": "Rough position, exactly one of: wall:top, wall:bottom, wall:left, wall:right, corner:top-left, corner:top-right, corner:bottom-left, corner:bottom-right, near:door, near:<piece name from this list>, free. Default free."
},
"link": {
"type": "string",
"description": "Product link from read_product, unchanged. Custom pieces only."
},
"name": {
"type": "string",
"description": "Custom piece instead of catalog, e.g. from read_product. Then width_mm and depth_mm are required."
},
"price": {
"type": "number",
"description": "Price from read_product, unchanged. Custom pieces only."
},
"catalog": {
"type": "string",
"description": "Catalog id from show_catalog, an ASCII slug such as sofa-3-plaetzer. Copy it, never translate or invent it."
},
"depth_mm": {
"type": "number",
"description": "Depth in millimeters, 50 to 10000. The side going into the room."
},
"width_mm": {
"type": "number",
"description": "Width in millimeters (a sofa is 1600 to 2600, never 2.0), 50 to 10000. The longer side seen from the front."
},
"height_mm": {
"type": "number",
"description": "Height in millimeters, if known. Custom pieces only."
}
}
},
"description": "Preferred. 1 to 40 pieces, each with catalog or with name plus width_mm and depth_mm, plus at. Larger pieces are placed first."
},
"blocked": {
"type": "array",
"items": {
"type": "object",
"required": [
"x",
"y",
"w",
"h"
],
"properties": {
"h": {
"type": "number"
},
"w": {
"type": "number"
},
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"name": {
"type": "string",
"description": "Shown on the plan, e.g. Radiator."
}
}
},
"description": "Rectangles that must stay free (radiator, wall cupboard, walkway): x, y, w, h in meters from the room's top-left corner, not piece centers. Door swings are added automatically."
},
"outdoor": {
"type": "boolean",
"description": "With wish only: limit the model to outdoor furniture, for terraces and balconies."
},
"project": {
"type": "string",
"description": "Plan id from create_room, or beispiel-wohnzimmer."
},
"placement": {
"type": "array",
"items": {
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "number",
"description": "Piece center, horizontal, in meters from the left wall."
},
"y": {
"type": "number",
"description": "Piece center, vertical, in meters from the top wall."
},
"rot": {
"type": "number",
"description": "Rotation in degrees clockwise, default 0. 90 turns the width along the left/right walls."
},
"link": {
"type": "string",
"description": "Product link from read_product, unchanged. Custom pieces only."
},
"name": {
"type": "string",
"description": "Custom piece instead of catalog, e.g. from read_product. Then width_mm and depth_mm are required."
},
"price": {
"type": "number",
"description": "Price from read_product, unchanged. Custom pieces only."
},
"catalog": {
"type": "string",
"description": "Catalog id from show_catalog, an ASCII slug such as sofa-3-plaetzer. Copy it, never translate or invent it."
},
"depth_mm": {
"type": "number",
"description": "Depth in millimeters, 50 to 10000. The side going into the room."
},
"width_mm": {
"type": "number",
"description": "Width in millimeters (a sofa is 1600 to 2600, never 2.0), 50 to 10000. The longer side seen from the front."
},
"height_mm": {
"type": "number",
"description": "Height in millimeters, if known. Custom pieces only."
}
}
},
"description": "Exact positions from the user, 1 to 60 pieces. Each with catalog or with name plus width_mm and depth_mm, plus x, y (meters to the piece center) and rot. Nothing is nudged: a piece that sticks out or overlaps is rejected."
}
}
}