FloorGen

Draw, edit, check and render 2D/3D floor plans from Claude, ChatGPT or Cursor: walls, rooms, doors, windows, furniture and stairs, with building-code checks and PDF, DXF and glTF export. Remote server, sign in with a free FloorGen account.

Hosted MCP Server

npx add-mcp 'https://floorgen.app/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

What the server does

An MCP client calls tools such as create_project, add_walls, add_opening and place_item to build a real plan: walls with lengths, rooms that close, doors in walls. The plan is an ordinary FloorGen project, so you can open it in the editor, change it by hand and hand it back. Edits an agent makes appear in an open editor within about a second, each as one undoable step, and are listed under Activity.

ItemDetail
EndpointPOST https://floorgen.app/mcp
TransportStreamable HTTP, stateless
Protocol versions2025-03-26, 2025-06-18, 2025-11-25 and 2026-07-28
OAuthOAuth 2.1 with PKCE (S256), dynamic client registration or client metadata documents, rotating refresh tokens
API keysMade in Agents & MCP, start with fg_live_, shown once; sent as Authorization: Bearer <key>
AccountA free FloorGen account (sign in with Google); projects must be synced to it

Connecting a client

Clients that take only a URL (claude.ai, Claude Desktop's connector screen, ChatGPT) sign you in with OAuth: you sign in to FloorGen and pick the access level on a consent page. Clients that let you set a header (Claude Code, Cursor, VS Code and most editors) use an API key, sent as Authorization: Bearer <key>. Keys are made on FloorGen's Home screen, under Agents & MCP at the foot of the sidebar: pick Read only, Read & edit or Full, all projects or chosen ones, and an expiry. Either way you need a free FloorGen account, and only projects synced to it are visible.

Claude (claude.ai, Desktop and mobile)

  1. Open FloorGen in the Claude directory and add it.
  2. Sign in to FloorGen and choose Read only, Read & edit, or Full.
  3. In a chat, turn FloorGen on from the tools menu. A connector added on claude.ai also appears in Claude Desktop and the mobile apps.

The directory connector lists the core tools. For all tools, or for testing, add FloorGen as a custom connector instead: Settings → Connectors → Add custom connector, name it FloorGen and paste https://floorgen.app/mcp?toolsets=all (or the toolsets you want) as the remote MCP server URL.

Claude Code

export FLOORGEN_API_KEY="fg_live_PASTE_YOUR_KEY"
claude mcp add --transport http --scope user floorgen https://floorgen.app/mcp \
  --header "Authorization: Bearer $FLOORGEN_API_KEY"

Check it with claude mcp list, or /mcp inside a session.

ChatGPT

  1. Turn on developer mode: Settings → Apps & Connectors → Advanced settings → Developer mode. Write tools need it.
  2. Create a connector named FloorGen with the MCP server URL https://floorgen.app/mcp and OAuth authentication.
  3. Sign in to FloorGen when asked, pick the access level, then choose the connector in a chat and ask it to list your FloorGen projects.

Cursor

{
  "mcpServers": {
    "floorgen": {
      "url": "https://floorgen.app/mcp",
      "headers": { "Authorization": "Bearer ${env:FLOORGEN_API_KEY}" }
    }
  }
}

In Cursor Settings → MCP, floorgen shows a green dot and its tool count. The Agents & MCP dialog has set-up text for each client (Claude Code, Claude Desktop, claude.ai, Cursor, VS Code with Copilot, Windsurf, Codex CLI, Gemini CLI, Cline, ChatGPT and any other), with a new key filled in. The longer walk-through, with Claude Desktop's config file, is connecting Claude, ChatGPT and Cursor to FloorGen.

Toolsets

A short tool list helps a model choose well, so the server lists only core (60 tools) unless the client asks for more, with ?toolsets= on the URL or an X-FloorGen-Toolsets header: https://floorgen.app/mcp?toolsets=core,stairs,history, or ?toolsets=all for all 211. Claude's directory connector uses the default. A credential only ever sees the tools its access level allows: a read-only key never sees an edit tool.

ToolsetToolsWhat it adds
core60On by default: reading, projects, floors, walls, rooms, openings, furniture, batches, checks, renders, 3D models, undo.
more104The rest of the everyday editing: finishes, surfaces, notes, elevations, schedules, scenarios, comparisons, electrical and lighting.
stairs8Stairs, stair cores and lifts, with their presets and checks.
trace4A background image to trace over, and its scale; DXF import.
live11The open editor tab: selection, view, camera.
macros17Whole floors, layouts and rooms in one call, rooms written as plan text, and the kitchen, bathroom and living room generators.
history7The change log, diffs, redo, checkpoints and the activity feed.

All 211 tools

Grouped by what they work on. Lengths are in centimetres, or text such as 3.5m or 12'6"; every edit takes dry_run and expected_rev. "Edit" tools need Read & edit access, "Delete" tools Full access and a confirmation token.

Reading the plan

Start here: what the server allows, how-to answers from the help centre, and the plan as rows an agent can search.

ToolWhat it doesAccessToolset
get_contextReturns what this FloorGen server speaks and allows.Readcore
get_creditsReturns the signed-in user's AI credits.Readcore
describe_projectA readable summary of the project.Readcore
list_entitiesRows for the plan's entities (and the project's section lines), filtered by type, room, box, ids (a {"tx"} selector lists what a change made) or category (items).Readcore
get_entityOne entity by id with its derived facts.Readcore
findFinds entities from a plain-words query and ranks them.Readcore
get_limitsEvery limit the project meets with how much is used.Readcore
search_helpHow-to answers about using FloorGen itself (snapping, uploading a PDF, sharing, embedding, guest chats, opening a plan) from the help centre.Readcore

The open editor tab

Work with what the person sees in the browser right now (toolset live).

ToolWhat it doesAccessToolset
get_selectionWhat the person has selected in the open editor tab.Readlive
set_selectionSelects things in the open editor tab (they highlight; ids [] clears).Editlive
get_viewHow the open editor tab is showing the project.Readlive
set_viewChanges what the open editor tab shows.Editlive
set_displaySwitches what the open editor tab draws on the 2D plan, like the View menu.Editlive
set_cameraMoves the 3D camera and sets the 3D switches in the open editor tab (it opens the 3D view if needed).Editlive
focus_entitiesMoves the open editor tab's camera to frame the given entities, so the person looks at them (in 2D it pans and zooms the plan).Editlive
export_drawingPrepares a file in the editor and posts it in the chat with Download.Editlive
create_tourGuided video tour of rooms in order, through their doors at eye height.Editlive
ui_actionDoes an app action in the person's editor instead of describing clicks.Editlive

Projects and settings

Create, copy, import, export and delete projects; units, code profile and title block.

ToolWhat it doesAccessToolset
list_projectsLists the projects in this account.Readcore
list_templatesLists the ready-made plans create_project and apply_template (toolset macros) use.Readcore
create_projectCreates a new project.Editcore
rename_projectRenames the project, replacing its current name.Editcore
set_unitsSwitches how the project shows lengths and areas (metric or imperial).Editmore
update_project_settingsChanges project-wide settings; only the fields you pass change.Editmore
update_project_metaSets the title-block details (client, address, revision, notes), the budget currency and the budget unit rates.Editmore
duplicate_projectMakes an independent copy of the project (every floor and design, new ids throughout) as a new project.Editcore
import_projectCreates a new project from a FloorGen project file, given as json (object or text) or as an https url (JSON or gzip, up to 15 MB).Editmore
export_project_jsonReturns the whole project as the text of a.floorgen.json file (traced images embedded; the trash is not included).Readmore
delete_projectDeletes a whole project.Delete (asks to confirm)more
restore_projectBrings back a project deleted through this API within the last 30 days, as it was when deleted.Editmore

Floors, designs and scenarios

Storeys, alternative designs of a floor, whole-house scenarios and detached buildings with storey heights of their own.

ToolWhat it doesAccessToolset
list_floorsLists the floors lowest first.Readcore
add_floorAdds a floor on top, as a basement, or right above a chosen floor, and makes it active.Editcore
update_floorChanges a floor's name, storey height, type (basement, stilt, ground, upper, terrace) or slab thickness, adds or removes entrance steps up to a ground floor on a plinth, or lines its walls up with the floor below (snap_to_below).Editcore
move_floorMoves a floor within the stack, to a position (0 is the lowest) or one step up or down.Editmore
delete_floorDeletes a floor with all its designs.Delete (asks to confirm)more
set_active_floorMakes a floor (the floor argument) the active one, the floor the app shows and the default for plan tools.Editcore
add_designAdds an alternative design (variant) to a floor, blank or a copy of an existing one, and makes it the active design, to try a layout without touching the original.Editcore
rename_designRenames a design.Editmore
set_active_designMakes the design named by the design argument (id or name) the active design of the floor (the floor argument, default the active floor).Editcore
delete_designDeletes the design named by the design argument (id or name; by default the active one) from the floor.Delete (asks to confirm)more
list_scenariosLists whole-house scenarios.Readmore
save_scenarioSaves a scenario.Editmore
apply_scenarioSwitches every floor to the design the scenario saved for it, in one change (like calling set_active_design on each floor; floors added later keep their active design).Editmore
delete_scenarioDeletes a scenario.Editmore
set_buildingDeclares or changes a detached building on the lot (a garage, ADU, barn, shop) that has its own number of storeys and storey heights.Editmore
copy_floorCopies one floor (the floor argument, default the active floor; its active design, or every design with all_designs) with everything on it.Editmore
rotate_floorTurns a whole floor 90, 180, 270 or -90 degrees about its centre in one step, e.g. "turn the plan 180 degrees".Editmore
mirror_floorFlips a whole floor like a mirror image, axis "x" (left and right swap) or "y" (top and bottom swap), e.g. "mirror it" or "flip the layout left to right"; a 180° turn is not a mirror image.Editmore
stretch_planInserts or removes space across the whole plan along a line, or sets its overall size, in one step: e.g. "add 1 ft southward through the hall" ({axis:"y", at:<hall y>, by:"1ft"}) or "make it 14 × 26 m".Editmore

Walls and rooms

Walls are the geometry; rooms are found from closed loops of walls.

ToolWhat it doesAccessToolset
add_wallsDraws walls: a polyline through points (closed:true joins the last point to the first, making a room) or separate segments [{a,b}].Editcore
update_wallsPaint, finish, thickness, height, gable top of walls (never below a door or window top; windows can rise into a gable).Editcore
set_wall_lengthMakes a wall longer or shorter: walls meeting it at right angles slide along so rooms stay square; doors and windows stay put.Editcore
move_wallSlides a wall square to itself; openings ride along.Editcore
split_wallCuts one wall into two joined walls so the joint can be moved (for a slanted or stepped wall).Editmore
set_wall_dividerTurns walls into invisible room dividers (a hairline drawn dashed in 2D and not built in 3D, but still splitting one space into two rooms), or back into normal walls with divider:false.Editmore
add_wall_featureBuilds a niche (a recess into the wall) or a bay window (a bump-out with windows) into a wall.Editmore
update_wall_featureResizes a niche or bay window built with add_wall_feature (width about its centre, depth in or out), or flattens it back into a straight wall (remove: true; the bay's side windows go, the front's stay).Editmore
add_columnsPlaces structural columns (square, round or steel) at points, or on a grid: give the axis positions as grid and a column stands at every crossing, named by axis (Column A1, B1…; letters left to right, numbers top to bottom), with a structural grid line along each axis that has none yet, labelled in bubbles.Editmore
create_room_rectDraws a rectangular room: four walls from the top-left corner (x, y), width and depth.Editcore
create_room_polygonDraws a room of any shape from its corners in order (at least 3; sides must not cross).Editcore
create_room_circleDraws a round room.Editcore
set_wall_curveBends an existing wall into an arc, or straightens it (bulge 0).Editmore
add_footprintsDraws up to 100 rooms in one change, each from its corners (points, as create_room_polygon; a flat [x1, y1, x2, y2, …] works too) or a rectangle (x, y, width, depth, as create_room_rect), with its own name and type.Editmore
update_roomRenames a room and sets its type, floor texture and colour, area label, label position, floor level, ceiling, double height, and whether it counts in the area totals.Editcore
split_roomDivides a room in two with a new wall along the line from a to b (ends within 30 cm of a wall of the room snap onto it; ends up to 30 cm past it are cut back to it).Editmore
merge_roomsJoins two neighbouring rooms into one by removing the wall(s) they share (with any doors and windows in them), like deleting those walls in the editor.Editmore
change_room_useChanges what a room is used for in one step.Editmore
define_zoneName an area inside a room, such as Kitchen, Dining and Living in one open-plan room, as a polygon or rectangle in cm that must lie inside the room (1 cm tolerance).Editmore

Doors, windows and finishes

Openings in walls, curtains and blinds, floor and wall finishes.

ToolWhat it doesAccessToolset
add_openingAdds a door, a window or an open passage to a wall (kind; window_type and grilles for windows; style options).Editcore
update_openingChanges an existing door, window or passage.Editcore
flip_openingFlips the side a door swings (or a garage door lifts) to, its hinge end, or both, when a door opens the wrong way; id from add_opening or list_entities.Editmore
add_window_dressingHangs curtains or a roller blind on a window (or a sliding or double door).Editmore
list_finishesLists the floor finishes and wall materials (id, label, group, whether each suits outdoors, whether it is free on every plan, a floor's usual colour) and some named paint colours.Readmore
set_floor_finishSets the floor texture and/or colour of rooms and of floor surfaces.Editcore
set_wall_finishPaints walls and/or sets their material (see list_finishes) on the same faces as the colour.Editmore
list_exterior_facesLists the wall faces on a floor that face outside the building (for exterior paint, cladding or windows).Readmore

Furniture and fixtures

Search the catalog of about 11,700 models and place, move and restyle items. 1,000 essentials and building parts place on free plans; the full library needs a paid plan.

ToolWhat it doesAccessToolset
list_categoriesList the catalogue categories and their subcategories with how many items each holds (free and premium: how many every plan places or not).Readcore
search_catalogFind furniture and fittings by words, category and size.Readcore
get_catalog_itemFull details of one catalogue item.Readmore
place_itemPlace a catalogue item (catalog_id from search_catalog) the way a drop in the editor does.Editcore
update_itemsChange placed items (id or ids, by id or name).Editcore
arrange_itemsLine up several items, space them evenly, push them against the nearest wall, group them, or restack them.Editmore
place_on_itemPuts an item exactly on top of another (a lamp on a nightstand, a hob on an island, a soffit box over a wall cabinet).Editmore
place_on_wallHang an item on one face of a wall, back flush against it and facing into face_room, at offset along the wall from end a and elevation above the floor.Editmore
add_trim_runRuns a crown moulding or cornice, a skirting board or a picture, dado or plate rail (catalog_id from search_catalog) round a room's inner walls in one call.Editmore
find_free_spaceFinds the empty floor in a room or zone, to see where something big fits.Readcore

Stairs and lifts

Toolset stairs.

ToolWhat it doesAccessToolset
list_stair_presetsLists the stair presets add_stair accepts.Readstairs
add_stairAdds a staircase from a preset on the targeted floor, fitted clear of walls, furniture, lifts and the cores and shafts of other floors.Editstairs
update_stairChanges a stair: type, x, y, rotation, flight, build and span_floors / span_to.Editstairs
set_stair_spanMakes a stair a stair core that repeats on every floor above (each floor gets its own riser count), or turns it back into a single-floor stair.Editstairs
list_lift_presetsLists the lift presets add_lift accepts (home, passenger-8, passenger-13, bed, panoramic, goods, car: a parking car lift) with shaft and cabin size in cm, capacity and door.Readstairs
add_liftAdds a lift (elevator) from a preset on the targeted floor, fitted clear of walls, furniture, stairs, the cores and shafts of other floors and the stairwell openings of stairs from below.Editstairs
update_liftChanges a lift: x, y, rotation, name, shaft, cabin and door.Editstairs

Surfaces, railings, notes and dimensions

Terraces, balconies, cut-outs, railings, notes, dimension lines, the north arrow and section lines.

ToolWhat it doesAccessToolset
add_surfaceDraws a wall-less surface on the plan.Editmore
update_surfaceChanges a surface's name, kind, finish, colour, thickness, height, slope, opacity, visibility, (cutouts) lid or (balconies) railing.Editmore
edit_surface_pointsMoves, inserts or removes corners of a surface.Editmore
clip_surfaceCuts a surface (terrace, floor surface, balcony) with a polygon, rectangle, room or another surface.Editmore
add_balconyAdds a balcony slab with a glass railing.Editmore
add_railingAdds a free-standing railing along a polyline (a terrace edge, gallery or landing).Editmore
update_railingChanges a railing's path, style, height, post spacing, elevation or name.Editmore
measureMeasures the straight-line distance between two points, or the closest distance between two entities (their outlines: a wall's faces, a room's inner wall faces; 0 when they touch or overlap, or a point lies within a wall).Readcore
pin_measurementPins a dimension line between two points so the length shows on the plan.Editmore
add_noteWrites a text note on the plan (a label, remark or sticky note for the client), or a construction detail callout (detail: a title and its layers, such as a footing, insulation or joists; tagged "detail", so {"tag":"detail"} finds them).Editmore
update_noteChanges a note's text, position, style, size, colour or arrow.Editmore
set_north_arrowPlaces the north arrow on the plan and/or sets which way north points.Editmore
set_plotDraws the site's plot (property line) as points or a width x depth rectangle, with setbacks per edge, per side or one for all, and what lies past each edge (edges: road, neighbour or open; the plan draws a road band or a neighbour hatch past it); changing only setbacks or edges keeps the outline.Editmore
add_sectionAdds a section line: a cut through the building from a to b that the app draws as a section view.Editmore
update_annotationMoves the ends of a pinned dimension line or a section line, sets a dimension's offset, or renames or flips a section.Editmore

Tracing an image or a drawing

Put a scanned plan or photo under the plan and scale it, or import a CAD drawing (DXF) as walls, doors and windows (toolset trace).

ToolWhat it doesAccessToolset
set_backgroundPuts an image (a scanned plan, sketch or photo) behind the plan to trace over.Edittrace
calibrate_backgroundRescales the background image so the distance between two plan points equals a real length.Edittrace
update_backgroundChanges the background image's opacity, visibility, lock, position or rotation, or removes it.Edittrace
import_dxfAdds a CAD floor plan (ASCII DXF, R12 to 2018) to the plan on this floor as walls, doors, windows and room names, in one change that undo takes back.Edittrace

Batch edits, copies and the trash

Many edits as one undo step, moving and copying by id, and the restorable trash.

ToolWhat it doesAccessToolset
apply_opsRun up to 100 edits in order as ONE change and a single undo step.Editcore
list_opsLists the op names apply_ops accepts with a one-line summary each (no arguments needed, no project).Readcore
transform_entitiesMove and/or turn walls, furniture, stairs, lifts, surfaces, notes, measurements and railings by id.Editcore
duplicate_entitiesCopies entities by id, e.g. to repeat a bedroom module (its room key) or a furniture group with offset {x: "4m", y: 0}.Editmore
clear_designEmpty the chosen design of a floor: all walls, doors, windows, rooms, furniture, stairs, lifts, surfaces, railings, notes and measurements.Delete (asks to confirm)more
set_layer_flagsLock, unlock, hide or show entities by id (rooms by key), or whole groups with where (by kind, catalogue category, room, outside every room, tag, or plumbing, gas and duct system; all_floors for the whole building), or everything with scope (design, floor, or project: every floor and design).Editmore
soft_deleteThe delete tool, no confirmation needed: removes entities by id into the design's trash, so restore_trash or undo brings them back.Editcore
list_trashLists what soft_delete and purge_hidden (toolset more) removed from the chosen design, newest first.Readcore
restore_trashPuts trashed entities back where they were.Editcore
purge_hiddenMoves everything on the chosen design that is hidden (see set_layer_flags) into the trash, so a tracing clutter pass can be cleaned up and still undone with restore_trash.Editmore
empty_trashPermanently removes entries from the chosen design's trash: pass entries (entry ids from list_trash, or "all") and/or older_than_days.Delete (asks to confirm)more

Structural grid, beams and service runs

Grid lines with their labels, beams under the ceiling, and water, waste, gas and duct runs between service points.

ToolWhat it doesAccessToolset
add_grid_linesDraws structural grid lines (axes labelled in a bubble at each end, A, B… and 1, 2…) as given, or on axes {x.Editmore
add_beamsAdds structural beams under the ceiling: drawn dashed on the plan (overhead) and as a downstand in 3D.Editmore
update_structureMoves the ends of a structural grid line or beam, relabels a grid line, resizes a beam, or deletes either with delete.Editmore
add_service_runDraws a pipe or duct run on the plan.Editmore
update_service_runChanges a pipe or duct run's kind, corners or size in place, or deletes it with delete: true (undo brings it back).Editmore

Decks and porches

A deck or covered porch with IRC 2021 R507 framing, a guard and stairs.

ToolWhat it doesAccessToolset
add_deckBuilds a deck or porch.Editmore
update_deckChanges a deck's outline, height, boards, joists, beam, guard, stairs or porch roof, re-sizes the framing from the tables with auto_size, or deletes it with delete.Editmore

Checks and schedules

The same checks as the editor's issue list, the area schedule and geometry clean-up.

ToolWhat it doesAccessToolset
validate_planThe single audit of the plan; use it after a batch of edits or before showing the plan.Readcore
ignore_issuesThe Review panel's Ignore.Editcore
check_stairsCheck every stair on the chosen floor (including stair cores coming up from below) for riser and tread comfort, width, headroom, handrail height and ramp slope, under the project's building code.Readstairs
check_clearancesOnly the clearance findings of validate_plan, to see if people can move around after placing furniture.Readmore
get_scheduleThe numbers for a brief or a quote.Readmore
audit_furnitureChecks every piece of furniture and reports what is wrong with it.Readcore
check_circulationChecks that a clear path at least 75 cm wide leads from an exterior door (any of them, so each flat of a duplex counts its own; from picks one) to every room's door on the floor, round furniture, stairs and walls.Readcore
fix_geometryCleans up small slips on the floor and design, in one step.Editmore
repair_planApplies the mechanical fixes findings carry (validate_plan rows and audit_furniture findings with a fix).Editcore
check_squareAnswers "are the walls square?" the same way every time, without a script.Readcore
square_wallsSquares up walls that are slightly off the plan axes in one step (check_square lists them).Editcore
list_labelsLists every room label (the name, type and finish saved for a room) on the floor and design.Readmore
manage_labelsMoves labels between rooms or removes them.Editmore
add_service_pointMarks water supply, drain, waste stack, exhaust, vent or gas points, drawn as small symbols on the plan.Editmore
update_service_pointMoves, relabels or changes the kind of a plumbing, gas or ventilation point in place (e.g. a vent stack that was marked as a plain vent: point_id, kind "stack", label "Soil stack"), keeping its id.Editmore
check_servicesChecks the service points on the chosen floor.Readmore

Cost, quantities and brief checks

A rough cost range, the materials take-off, Vastu, coverage and floor area ratio, the brief's figures and seat capacity. Estimates and guidance, never quotes or code approval.

ToolWhat it doesAccessToolset
get_takeoffThe quantities for ordering and pricing.Readmore
estimate_costA ROUGH build-cost range for the plan.Readmore
check_vastuWhere the kitchen, bedrooms, prayer room, living and dining rooms, toilets, stairs and the entrance door lie on the compass, set against traditional Vastu Shastra zones.Readmore
check_zoningSite coverage and floor area ratio over the plot (the one drawn with set_plot, else the plot size in settings), compared with limits the user gives.Readmore
check_briefCompares the plan with what a brief asks for.Readmore
check_capacityHow many seats and tables a room holds at a standard area per seat for its use, how many seats are placed in it now, and, with seats_needed, whether that many fit (comfortably, tightly or not).Readmore
set_assemblyBuilds walls, ceilings and floors in layers (cladding, sheathing, framing member and spacing with cavity insulation, continuous insulation, drywall) with R-values.Editmore
set_climateSets the climate zone the energy check reads.Editmore
get_energyThe energy design aid.Readmore

Electrical, lighting and daylight

Circuits, switch links, light levels, daylight and auto-placed lights. These tools need a plan that includes the electrical and lighting layers.

ToolWhat it doesAccessToolset
get_electricalReads the electrical layer, 60 rows a page with total, returned and next_offset (page with offset; read every page before giving a full list).Readmore
set_circuitsCreates, changes and deletes the design's electrical circuits and puts devices on them, as one change (e.g. a kitchen counter circuit with two receptacles: circuits [{"name": "Kitchen counter", "tag": "K1", "kind": "receptacle", "amps": 20, "gfci": true}], assign [{"circuit": "K1", "item_ids": ["i_…", "i_…"]}]).Editmore
add_circuitAdds one circuit to the design's panel, and optionally puts devices on it, as one change (e.g. a GFCI kitchen counter circuit: name "Kitchen counter", tag "K1", kind "receptacle", amps 20, gfci true, item_ids ["i_…"]).Editmore
link_switchesLinks switches to the lights they work, adding to what is there (e.g. a 3-way pair at both ends of a hall working its two ceiling lights: switch_ids ["i_sw1", "i_sw2"], load_ids ["i_l1", "i_l2"]).Editmore
unlink_switchesUndoes link_switches.Editmore
move_switch_floorMoves a wall switch to the floor directly above or below, at the same spot with the same id, keeping its switch link (e.g. a stair's 3-way placed on the wrong floor: {"item_id": "i_…", "to_floor": "Basement"}).Editmore
get_lightingReads how much light each room of the floor gets, with its target for the room type and a status (meets, low, dark).Readmore
auto_place_lightsAdds ceiling lights to a room in an even grid until its average reaches the lux target for its room type (lumen method), as one change, and wires them.Editmore

Images, elevations, sections and the roof

Pictures the agent can look at, and the elevations and sections the print sets use.

ToolWhat it doesAccessToolset
render_2dDraws the floor plan as a PNG image (or, with sheet, the site, roof or foundation plan).Readcore
render_3dDraws a 3D view of a floor (or one room) as a PNG image, from a chosen corner, with flat shading and no textures.Readmore
render_visualA paid extra.Edit (paid)more
list_elevationsLists the elevations: flat, square-on views of the outside of the building.Readmore
get_elevationReads one elevation as data.Readmore
render_elevationDraws one elevation as a PNG.Readmore
add_elevationSaves an extra elevation looking square at a façade: by bearing, or by a wall's outer side.Editmore
update_elevationRenames, re-aims or restyles a saved elevation.Editmore
delete_elevationDeletes a saved elevation (undo brings it back).Editmore
set_roofSets the automatic roof over the top floor and over lower floors' rooms with nothing above (not a terrace floor), as 3D and elevations draw it.Editmore
render_sectionDraws a cut through the building as a PNG.Readmore

3D models

Projects of kind model (FloorGen 3D Modeler): read a model, edit it with batches of ops, build parametric objects and look at it, and export it as GLB, OBJ or STL. Plan tools refuse a model project and these refuse a plan.

ToolWhat it doesAccessToolset
model_readDescribes a 3D model project in words.Readcore
model_editChanges a 3D model with a batch of ops (1 to 200, at most 20,000 points in all), applied in order as one change.Editcore
model_buildAdds a ready-made parametric object to a 3D model (a pergola, stair, shelf, table and more: model_recipes lists them with their parameters) as a component, placed with its base centre at "at".Editcore
model_rebuildRemakes a component built with model_build using new parameters; every copy of it in the model follows.Editcore
model_recipesLists the parametric objects model_build can make: each recipe kind, what it is, and its parameters with units, bounds and defaults.Readcore
model_renderDraws a 3D model as a PNG line drawing with flat shading: an isometric view, the plan from above, or one of four elevations.Readcore
model_exportWrites a 3D model project as a file: GLB, OBJ (with its MTL) or STL, the same files the studio's Export dialog makes.Readcore

Comparing designs and projects

Side-by-side plans and area tables.

ToolWhat it doesAccessToolset
compare_designsCompares two designs of one floor.Readmore
compare_projectsCompares the areas of 2 to 6 projects side by side.Readmore

History, undo and checkpoints

Every agent edit is logged as a transaction that can be inspected and undone (toolset history, except undo).

ToolWhat it doesAccessToolset
get_historyLists the changes made to a project through agent tools and reverts, newest first.Readcore
diffShows what a logged change did, entity by entity.Readhistory
undoTakes back your own latest change (or the last few with steps); one apply_ops call is one change.Editcore
redoBrings back what you last undid with undo or undo tx (or the last few with steps).Editcore
restore_entitiesPuts the chosen entities back to how they were at an earlier point in the history (a rev, or just before a change), even when other things were edited since.Edithistory
create_checkpointSaves a named copy of the whole project as it is now, so you can come back to it with restore_checkpoint.Edithistory
list_checkpointsLists the saved checkpoints of a project, newest first.Readhistory
restore_checkpointPuts the whole project back as it was at a checkpoint.Delete (asks to confirm)history
get_activityThe activity feed of a project, newest first: logged changes (kind "change") and notes people or agents left (kind "note") together.Readhistory
post_noteLeaves a note in the project's activity feed (shown to the person in the editor), for example to explain a choice or ask a question.Edithistory
who_is_hereShows who has this project open right now.Readlive

One-step layouts

Bigger jobs in one call, each a single undo step with a checkpoint before it (toolset macros).

ToolWhat it doesAccessToolset
build_floorBuilds a floor from its room list: walls, doors, windows and stair, no coordinates.Editmacros
generate_layoutCreates a NEW design with a whole floor plan from a room list and switches to it; not for adding a room to the current plan (use create_room_rect).Editmacros
furnish_roomFurnishes a room (all_rooms true: the whole floor, no kind or room) at once (undo removes it) with a ready-made set, clear of doors.Editmacros
connect_roomsOpens a door (or a plain opening) between two rooms that share a wall: on the longest shared wall, centred where both rooms touch it.Editmacros
add_storey_with_stairAdds a floor above the target floor and a stair up to it, in one step (direction "down": a basement under the lowest floor and a stair down to it).Editmacros
auto_dimensionPins dimension lines on the plan: the overall width and depth outside the walls and, if asked, the width and depth of each rectangular room.Editmacros
apply_templateCreates a NEW design from a template's floor plan (ids from list_templates) and switches to it; not for adding a room to the current plan.Editmacros
propose_variantOffers a change without touching the original.Editmacros
add_adjacent_roomAdds a rectangular room against one side of an existing room in one step.Editmacros
partition_roomCarves a closet, ensuite or pantry out of a corner or a side of a room in one step (an L-shaped or other room square to the compass carves from its own corner furthest that way, or its outermost stretch on that side).Editmacros
resize_roomMoves one side of a room out or in (for an L-shaped or other room square to the compass, its outermost stretch on that side), or sets its net area (area, keep) or its clear inside size (inside_width, inside_depth: measured between the inner wall faces, mixed thicknesses included, landing within 1 mm).Editmacros
add_stair_coreReserves the same stair rectangle on every floor from from_floor to to_floor and puts a stair in it that climbs through them, in one step.Editmacros
swap_roomsSwaps what two rooms are.Editmacros
apply_plan_textAdds and updates rooms, doors, windows and furniture written as plan text, as ONE change and a single undo step.Editmacros
generate_kitchenProposes 2 or 3 kitchen layouts for a room or zone and changes nothing; call again with apply true and option n to place one (replacing an earlier generated kitchen; dry_run previews it).Editmacros
generate_bathroomProposes 2 or 3 bathroom layouts for a room or zone and changes nothing; call again with apply true and option n to place one (replacing an earlier generated bathroom; dry_run previews it).Editmacros
generate_livingProposes 2 or 3 living and/or dining layouts for a room or zone and changes nothing; call again with apply true and option n to place one (replacing an earlier generated layout; dry_run previews it).Editmacros

13 prompts and 15 resources

Each prompt is a playbook: a job written out step by step against the real tools, starting with get_context and ending with validate_plan and render_2d.

PromptWhat it does
design_homeDesign a whole home from a short brief, checked and rendered; report after each step.
furnish_roomFurnish one room in a design copy with the generator for its type, then check clearances.
trace_planTrace a floor plan image into walls, rooms and openings at scale, one floor at a time, lengths in cm, then check it.
review_planReview a plan and give prioritised feedback; no edits unless the user asks.
add_storeyAdd a floor above with a linked, aligned stair and check the stairs.
explain_projectExplain the project in plain words for an audience, without editing.
make_alternativeTry a change in a separate design and compare it with the untouched original.
audit_and_fix_planFind and fix plan problems in small checked steps, or only report (dry_run true or apply false).
refresh_roomBuild new layouts for one room in design copies, never in the original, and compare; nothing switches until the user picks.
render_review_loopRender each floor, fix what the pictures show, repeat (at most three rounds).
safe_destructive_editRemove or rebuild part of a plan safely: checkpoint, soft delete, verify; permanent deletes only via confirm and the user's yes.
compare_designs_reportCompare two designs of one floor and recommend one; read only: no edits, no switching the active design.
export_planExport a plan as pictures of each floor, a 3D view or the whole project file; no edits.
URIWhat it holds
floorgen://projectsYour projects: id, name, last change.
floorgen://catalogCategories of the furniture catalog with item counts.
floorgen://stairs/presetsPresets for add_stair and add_lift.
floorgen://finishesFloor textures, wall materials and named paints.
floorgen://schema/project.jsonJSON Schema of a.floorgen.json project file.
floorgen://guide/conventionsUnits, axes, ids, references and how edits work.
floorgen://guide/playbooksStep-by-step jobs (audit and fix, refresh a room, safe deletes...), the same as the prompts.
floorgen://projects/{id}Project facts: floors, designs, settings.
floorgen://projects/{id}/summary.mdA short readable summary of the project.
floorgen://projects/{id}/floors/{floor}/designs/{design}/plan.jsonOne design of one floor as JSON (floor and design by id or name).
floorgen://projects/{id}/roomsRooms of every floor with areas.
floorgen://projects/{id}/activityLatest edits and notes, newest first.
floorgen://projects/{id}/historyLatest transactions with revisions.
floorgen://catalog/{category}Items of one catalog category, 100 at a time: add?offset=N for the next page (next_uri gives it).
floorgen://guide/playbooks/{name}One playbook: arguments, toolsets and scopes it needs, and the steps.

Safety rails

  • Access levels. Read only, Read & edit, or Full (which can delete), per key or per OAuth grant. A key can be limited to chosen projects and given an expiry.
  • Preview and conflicts. Every edit takes dry_run to see the result without saving, and expected_rev so an edit made on a stale copy is refused.
  • Two-step deletes. Destructive tools return a confirmation token first; the agent has to ask and call again. soft_delete moves things to a trash that restore_trash empties back.
  • Undo and checkpoints. Each call is one logged change that undo reverses. A checkpoint is saved before macros and deletes, and deleted projects can be restored for 30 days.
  • Rate limits. 300 calls and 60 edits a minute per key.

More on how these work together: letting AI agents edit floor plans safely.

Questions

Yes, for agents. The editor works without one, but an AI app reaches only projects synced to a FloorGen account, so sign in (free, with Google) and let your projects sync before you connect it.

Any client that speaks MCP over Streamable HTTP: Claude (web, desktop, mobile and Claude Code), ChatGPT in developer mode, Cursor, VS Code with Copilot, Windsurf, Codex CLI, Gemini CLI and Cline, among others.

An OAuth sign-in covers every project in the account. To keep an agent to one job, make an API key limited to chosen projects, and give it Read only or Read & edit access.

Yes. Each tool call is one step in the editor's undo history and one logged transaction that undo reverses, and checkpoints are saved before bigger changes.

render_2d, render_3d and render_elevation return PNG images the agent can look at. File exports (PDF, DXF, IFC, glTF, video) are in the editor's Export menu. The in-app assistant's export_drawing can make a PDF, PNG, SVG, DXF, IFC or CSV while the project is open; over MCP it needs a live editor tab and answers LIVE_TAB_REQUIRED without one.