Roomproof

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Room planning to scale from your AI: it places furniture, Roomproof checks walkways and door swings.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Roomproof": {
      "url": "https://getroomproof.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (9)

• read_product read-only

  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.

  Parameters:

  • input (required) — string — A product URL, or the pasted text of the product page.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• 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.

  Parameters:

  • 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.

  Hints: read-only no · destructive no · idempotent no · open-world no

• 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).

  Parameters:

  • project (required) — string — Plan id from create_room, or beispiel-wohnzimmer.
  • 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 — 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.
  • 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.

  Hints: read-only no · destructive no · idempotent no · open-world no

• set_door

  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.

  Parameters:

  • project (required) — string — Plan id from create_room.
  • openings (required) — array — All doors and windows of the room, 0 to 20. Replaces the existing list completely.
  • 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.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• show_catalog read-only

  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.

  Parameters:

  • group — string — Optional filter. Must be one of the strings in groups from a previous show_catalog response, e.g. Living or Outdoor.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• 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).

  Parameters:

  • project (required) — string — Plan id from create_room, or beispiel-wohnzimmer.
  • piece (required) — 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.
  • 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.
  • remove — boolean — true removes the piece; x, y and rot are then ignored.
  • variant — string — Variant id from a previous response; default the newest.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• show_plan read-only

  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.

  Parameters:

  • project (required) — string — Plan id from create_room, or beispiel-wohnzimmer.
  • 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.
  • variant — string — Variant id from a previous response; default the newest.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• check_plan read-only

  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.

  Parameters:

  • project (required) — string — Plan id from create_room, or beispiel-wohnzimmer.
  • 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.
  • variant — string — Variant id from a previous response; default the newest.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• 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.

  Parameters:

  • project (required) — string — Plan id from create_room.
  • 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.

  Hints: read-only no · destructive no · idempotent no · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.