MCP 서버

Roomproof

com.getroomproof/roomproof
디자인 및 크리에이티브 공개 · 연결 가능 MCP 2026-07-28

이 MCP로 할 수 있는 일

Creates and validates scaled room layouts with furniture placement, dimensions, openings, walkways and door-swing checks.

check_plan
Check plan
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.
읽기 전용 멱등성
입력 스키마
{'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.'}}}
create_room
Create room
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.
입력 스키마
{'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."}}}
move_furniture
Move furniture
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).
멱등성
입력 스키마
{'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.'}}}
open_plan
Open plan
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.
입력 스키마
{'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.'}}}
place_furniture
Place furniture
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).
입력 스키마
{'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.'}}}
read_product
Read product
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.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', 'required': ['input'], 'properties': {'input': {'type': 'string', 'description': 'A product URL, or the pasted text of the product page.'}}}
set_door
Set doors and windows
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.
멱등성
입력 스키마
{'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.'}}}
show_catalog
Show catalog
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.
읽기 전용 멱등성
입력 스키마
{'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.'}}}
show_plan
Show plan
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.
읽기 전용 멱등성
입력 스키마
{'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.'}}}
추가됨
open_plan
2026년 9월 21일 2:40 AM
추가됨
check_plan
2026년 9월 21일 2:40 AM
추가됨
show_plan
2026년 9월 21일 2:40 AM
추가됨
move_furniture
2026년 9월 21일 2:40 AM
추가됨
show_catalog
2026년 9월 21일 2:40 AM
추가됨
set_door
2026년 9월 21일 2:40 AM
추가됨
place_furniture
2026년 9월 21일 2:40 AM
추가됨
create_room
2026년 9월 21일 2:40 AM
추가됨
read_product
2026년 9월 21일 2:40 AM