Room census
Which rooms this space has, how big each kind is, and which rooms have no type.
What it answers
Section titled “What it answers”- What rooms does this unit have?
- How big are the bedrooms?
For the agent, the tool is described as: Count rooms by type with floor areas for one scan, from the wall graph. Cheap; run it first on any building to learn its layout. Returns one metric per room type and an area lens.
Who it is for
Section titled “Who it is for”Apartment manager, Commercial cleaning bidder, CoStar research lead, CoStar researcher, Daycare operator, Fire captain, Moving large furniture, Family planning home security, Houston homeowner before a storm, Insurance underwriter, Light sleeper or night-shift worker, Office tenant, Older adult or family, Remote worker, Renter checking a listing’s claims, Renter checking a listing, Wheelchair user.
Inputs
Section titled “Inputs”| Input | Type | Required | Default | Notes |
|---|---|---|---|---|
scan |
string | yes | Scan id. Filled from the selected building. |
An input that nothing fills (the selected building, a saved preference, a persona’s preset) becomes a question to the person. The agent asks only for those.
Data used
Section titled “Data used”| Layer | Id | Needed | If it is missing |
|---|---|---|---|
| Rooms | matterport.rooms |
required | The verdict is unknown, with the reason. |
| Room names | matterport.room_labels |
optional | The tool runs without it. |
What it returns
Section titled “What it returns”A tool result: a verdict (pass, warn, fail or unknown), metrics, checks and findings, each with its source.
- Draws on the building: a colour per room.
- Panel blocks:
VerdictHeader,MetricRow,MiniChart,FloorPlanMini,StepLog. - Speed: fast. Read-only.
How it works
Section titled “How it works”Rooms by type with their areas, and a lens that tints each room by area.
Reliability
Section titled “Reliability”Sources this tool gave on the test home:
| Where it came from | Layer | Method | Reliability | Note |
|---|---|---|---|---|
| Measured from the scan | matterport |
geometry |
high | Matterport room floor area |
| Looked up in the scan | matterport |
lookup |
medium | Matterport room classification |
The tool sets the label for each value. A model never does. The tools give a scan’s wall graph the layer matterport whichever device made the scan, so a phone scan’s geometry carries that label too.
Limits
Section titled “Limits”- Needs: rooms. On a scan without it, the verdict is
unknownand says why. - A result is a planning aid, not an inspection.
On the made-up test home
Section titled “On the made-up test home”This section was written by running the tool when the docs were built, on a hand-made RoomPlan export (no real place was scanned), with no sponsor keys and the network switched off.
Pass 6 rooms, 80 m²: Living Room, Bedroom, Kitchen, Bathroom, Hallway.
| Value | Result | Where it came from | Reliability |
|---|---|---|---|
| Rooms | 6 | Measured from the scan | high |
| Floor area | 80.1 m² | Measured from the scan | high |
| Rooms with a type | 100 % | Looked up in the scan | medium |
| Bedroom (2) | 32 m² | Measured from the scan | high |
| Living Room (1) | 30.1 m² | Measured from the scan | high |
| Kitchen (1) | 10.5 m² | Measured from the scan | high |
| Bathroom (1) | 4.5 m² | Measured from the scan | high |
| Hallway (1) | 3 m² | Measured from the scan | high |
| Check | Measured | Against | Status |
|---|---|---|---|
| At least half the rooms have a type | 100 | 50 % | pass |
What it reported while it ran:
- Read 6 rooms from the wall graph
- Grouped them into 5 types
Run it
Section titled “Run it”threshold run room_census --scan <scan-id>curl -X POST http://127.0.0.1:8787/api/tools/room_census/run -H 'content-type: application/json' -d '{...inputs}'Over MCP the tool is named room_census. See MCP server and CLI.