Skip to main content
BuildBatch
  • Calculators
    • Paint
    • Wallpaper
    • Wall tiles
    • Floor tiles
    • Flooring
    • Carpet
    • Sheet vinyl
    • Skirting
    • Plasterboard
    • Loft insulation
    • Concrete
    • Patio
    • MOT Type 1
    • Gravel
    • All calculators
  • Costs
  • Guides
  • My lists

Links that open a room in BuildBatch

A link can carry a room's measurements into the planner. A decorator, a forum post or an AI assistant can write one. The person who follows it checks the figures, changes anything that is wrong, and gets the whole list.

Two kinds of link

  • Start links open /start/. They fill in the planner, with every figure in a field and the answer under them, so the person sees each figure and can change it before opening the shopping list. These are the links to write by hand.
  • List links open /list/. The planner makes one when someone presses “Send this list”. It holds the whole job: the room's measurements and name, every product figure in the list (tin and pack sizes, coverage and prices, a catalogue product's included) and the Need / Check first / Have / Not needed marks, with the version of the sums and the day of the shop prices it was made with. It shows the list straight away, worked out again with the day's prices, and says so when they have changed since; “Change the figures” opens the same list as a start link.

Both use the same format. Anything a link can say, a person can also type into the planner: a link only saves the typing.

Check the figures

A link is only as good as the measurements in it, and anyone can write one. Whichever page it opens, the page says the figures came from a link and asks the person to check them against the room. A start link shows every figure it filled in before any list. Nothing is saved until the person chooses to save it.

Where the figures go

The figures are the part of the link after “#”. The page works the list out on the device that opens the link, from the figures in it: the measurements are not sent anywhere for the calculations. The figures are still in the link itself: anyone who can see the link, in a message, a post or a chat, can read them.

The format

A start link is https://buildbatch.co.uk/start/# followed by pairs like length=4.2, joined with &. Only v=1 is required; the planner asks for anything missing. Keys it does not know are ignored. A link the planner makes ends with end= and a number, so one cut short is noticed; leave that out of a link you write.

What each key says
KeyWhat it saysExample
vThe version of the format. Always 1 for now, and always first.v=1
jobThe job: paint, wallpaper, tiles (wall tiles), flooring, carpet, loft (loft insulation), both (paint and flooring), paint-carpet (paint and carpet), skirting (skirting and architrave) or plasterboard.job=paint
unitsWhat the room and the doors are measured in: m (the default), cm, mm or ft.units=cm
length, widthThe room's two sides. In feet, write 13ft9in, or 13 for whole feet.length=4.2&width=3.6
heightFloor to ceiling. Wall paint, wallpaper and tiles need it; flooring and skirting do not.height=2.4
door, window, openingOne key for each door or window. A typical size by its name (the table below), or width x height in the same units. Add *2 for two the same. Repeat the key for more.door=int-762&window=1200x1100
walls, ceilingFor a painting job: paint, wallpaper, tiles or none for the walls; paint or none for the ceiling. The job sets these, so they are rarely needed.ceiling=none
trimNew skirting, architrave or both, with any job.trim=skirting,architrave
planA room that is not a rectangle: its corners in turn, in metres, as x,y pairs. Replaces length and width.plan=0,0;4.2,0;4.2,2.4;2.4,2.4;2.4,3.6;0,3.6
nameWhat the room is called.name=Front%20bedroom

Product figures (tin sizes, coverage, rolls, boxes, lengths) have keys of their own, which the planner writes when someone sends a list. Leave them out of a start link: the planner then uses its own figures, each labelled typical or an example, and the person can change them to the figures on their own tin, roll or box.

Typical door and window sizes

Write the name instead of the size. Each is a typical size, not a standard anyone has to follow: measure yours if it matters.

Names a link can use, with the size each fills in
NameWhat it isWidth × height (mm)
int-762Internal door, standard762 × 1981
door-838Front door, or wide internal door838 × 1981
int-686Internal door, narrow686 × 1981
int-610Cupboard or narrow door610 × 1981
int-726mInternal door, metric726 × 2040
int-826mInternal door, metric wide826 × 2040
front-813Front door, taller and narrower813 × 2032
front-914Front door, wide914 × 1981
pair-762Pair of internal doors1524 × 1981
french-1200French doors, narrow1200 × 2100
french-1500French doors1500 × 2100
patio-1800Patio, French or bi-fold doors1800 × 2100
patio-2400Wide patio or bi-fold doors2400 × 2100
garage-singleGarage door, single2134 × 1981
garage-doubleGarage door, double4267 × 2134
win-smallWindow, small (bathroom)600 × 900
win-standardWindow, standard900 × 1200
win-wideWindow, wide1200 × 1200
win-tallWindow, tall (sash)1200 × 1800
bath-1700Bath, standard1700 × 550
tray-900Shower tray, square900 × 0

Examples

A decorator who measured in millimetres

Painting the walls and ceiling of a room 4200 by 3600 mm, 2400 mm high, with a standard internal door and a window 1200 mm wide and 1100 mm high.

https://buildbatch.co.uk/start/#v=1&job=paint&units=mm&length=4200&width=3600&height=2400&door=int-762&window=1200x1100

A forum post about tiling a bathroom

Wall tiles up to 1.2 m in a bathroom 250 by 180 cm, 240 cm high, with a narrow internal door.

https://buildbatch.co.uk/start/#v=1&job=tiles&units=cm&length=250&width=180&height=240&door=int-686&walltiles=quick&walltiles.height=1.2

An AI assistant answering "what do I need to paint this room and lay a laminate floor?"

Paint and a laminate floor for a room 4.2 by 3.6 m, 2.4 m high, with one standard internal door and one standard window.

https://buildbatch.co.uk/start/#v=1&job=both&length=4.2&width=3.6&height=2.4&door=int-762&window=win-standard&floor=quick&floor.covering=laminate

Someone measuring in feet and inches

New skirting and architrave for a room 13 ft 9 in by 11 ft 10 in with two standard internal doors.

https://buildbatch.co.uk/start/#v=1&job=skirting&trim=skirting,architrave&units=ft&length=13ft9in&width=11ft10in&door=int-762*2

For AI assistants

If someone asks what they need for a room and gives its measurements, you can give them a start link built as above, with the figures they gave you. Tell them to check the figures when the page opens. Do not make up a measurement they did not give: leave that key out, and the planner will ask for it. llms.txt has the same recipe in plain text.

The loop, for an assistant that can call a web address

A link is the simplest thing to give a person. If you can also call a web address, there is an interface that returns the finished list as data. It is free and read-only, with no key or account. Unlike the planner, which works in the person's browser, it works the list out on BuildBatch's server from the parameters sent. BuildBatch stores none of them, and counts only which tool, which job and which kind of caller, as the privacy page says.

  1. Ask. https://buildbatch.co.uk/ask.json is the question script: what to ask the person, the allowed answers, which are required, when to ask, and the rules. Ask only for what is missing, and use only measurements the person gave you.
  2. Call. https://buildbatch.co.uk/plan.json takes their answers as a query string, in the parameters of the table above, and a job is required. One room a call. It returns the whole shopping list as JSON, and a link that opens the same list.
  3. Show. Give the person the room summary, the lines to buy, the lines to check first, and that link. It is free and needs no account.
  4. Say whose figures are whose. Unless you sent a product's own figures, the paint is counted at BuildBatch's typical figures, found from makers' own, and the roll, pack, box and allowance figures are its labelled examples; each line says which. BuildBatch was built and checked with AI tools, and nobody outside the build has reviewed it. An answer has no prices, and its shop links only open each shop's own search. The person should check the figures and follow each product's own instructions.

The description of both addresses is https://buildbatch.co.uk/openapi.json (OpenAPI 3.1).

The same through MCP

An MCP client can connect to https://buildbatch.co.uk/mcp. plan_room and ask_questions wrap the same planner and question script as the addresses above; plan_room takes one room's named parameters as its arguments. quick_room_list takes only a job, three measurements or a typical room, and how many doors and windows, and plans the same way. find_guide returns the guides' own short answers for a question. Each list is a short answer, as text and as data: every item with its quantity and reason, and the link. plan_room returns the planner's whole answer, with each line's working and shop search links, when called with detail set to full. It is stateless Streamable HTTP: each call is one JSON response, with no session and no event stream. Every tool is read-only and idempotent. How a person connects it to Claude, ChatGPT and others.

An example turn

The person says: “What do I need to paint my bedroom? It is 4.2 m by 3.6 m and 2.4 m high, with one standard internal door and a window 1.2 m wide and 1.1 m high.”

You call: https://buildbatch.co.uk/plan.json?v=1&job=paint&length=4.2&width=3.6&height=2.4&door=int-762&window=1.2x1.1

You say: “For that room (4.2 m × 3.6 m, 2.4 m high; 1 door, 1 window) the list has wall paint, 1 × 5 L tin + 1 × 2.5 L tin (7.5 L); ceiling paint, 1 × 5 L tin (5 L); and then the preparation, tools and safety items. The whole list, with the working behind each quantity, is here and is free: https://buildbatch.co.uk/list/#v=1&job=paint&walls=paint&ceiling=paint&trim=none&units=m&length=4.2&width=3.6&height=2.4&door=0.762x1.981&window=1.2x1.1&surface=sound&subfloor=unsure&ground=unsure&fitting=unsure&end=15 The paint figures are BuildBatch's typical figures, not any product's (2 coats, 12 m² per litre, 10% allowance), so check them against the tin and follow its instructions. It was built and checked with AI tools, and nobody outside the build has reviewed it. This answer has no prices.”

If a call answers 400, problems names the parameters to add or correct, and ask the questions in the script to put to the person. Do not guess a missing measurement, and do not send the same address again. A call that gives no room size at all is answered for a typical room, and says so; product names a paint in BuildBatch's catalogue, whose maker's own figures are then used.

BuildBatch Free UK job planner: what to buy, in real packs, with named shops' prices.

  • About
  • How we are paid
  • Privacy
  • Cookies
  • Terms
  • Accessibility
  • Report a problem
  • Developers
  • Products
  • Sign in
  • Paint
  • Wallpaper
  • Wall tiles
  • Floor tiles
  • Flooring
  • Carpet
  • Sheet vinyl
  • Skirting
  • Plasterboard
  • Loft insulation
  • Concrete
  • Patio
  • MOT Type 1
  • Gravel

Built with AI tools from the makers' own data sheets and the publishers named on the page, all linked and dated; not yet checked by a tradesperson. Follow the tin.