com.craftquantities/engine

Est-ce que com.craftquantities/engine est sûr ?

Au dernier audit MCP Hub, le serveur MCP « com.craftquantities/engine » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 38 outils

• calculate≈ 3247 tokens

  Computes the result of one calculator, identified by its slug, from the input values given: the amount of material a job needs, such as the bags of concrete for a slab or the sheets of drywall for a room, counted in bags, sheets, studs, tiles, litres, gallons, cubic yards or m³. Returns it in metric and US units with the inputs used, sources, a citation and the page link. No prices.

  Paramètres, retour & exemple (7)

  Paramètres

  • slug · string · requis
    The calculator's slug, such as concrete-calculator.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • inputs · object · optionnel
    The calculator's input values, by input id (an unknown id is refused with the accepted ids). A length, area, volume or other measured input takes "12 ft", "3.5 m", "8' 3 1/2\"" or {"value": 12, "unit": "ft"}; a count or percentage takes a number; a select takes one of its option values. Inputs left out take the value the calculator's page opens on.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • explain · boolean · optionnel
    true adds the working: the inputs as the calculator received them, every intermediate figure its own compute reports with its unit, the range check and the unit restatement, ending on the same figures. The answer's figures are identical either way.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.

  Exemple d'appel

  {"name": "calculate", "arguments": {"slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• calculate_batch≈ 3770 tokens

  Runs up to 25 construction calculator calculations in one request, each a calculator slug or permanent id with its own input values, and returns each run's full answer in order (metric and US units, inputs used, sources, citation, page link) or that run's refusal; one refusal leaves the rest answered. No prices.

  Paramètres, retour & exemple (5)

  Paramètres

  • items · array · requis
    The runs, 1 to 25, each one calculator and its inputs; answered in the same order.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · optionnel · US | CA | UK | AU | INTL
    The market for every run that does not name its own.
  • system · string · optionnel · metric | imperial
    The unit system for every run that does not name its own.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.

  Exemple d'appel

  {"name": "calculate_batch", "arguments": {"items": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• check_quote≈ 2557 tokens

  Is a builder's quote right on quantities? Reads a contractor's quote (pasted text) against the reader's own job and returns each quoted quantity against the range the job's calculators give, the lines it leaves out or adds, and the questions to ask. Money is removed and not judged; a difference is a question, not a verdict.

  Paramètres, retour & exemple (8)

  Paramètres

  • job · string · requis · bathroom-quote | plastering-quote | room-fitout-quote | concrete-slab-quote | timber-deck-quote | stud-wall-quote | external-wall-quote | insulate-floor-quote
    The quote check: bathroom-quote, plastering-quote, or a takeoff's ({takeoff id}-quote).
  • quote · string · requis
    The quote's text. Prices may be left in; they are taken out before reading.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • selection · object · optionnel
    Build-up choice id → option id, the takeoff's own (a stud size, an insulation, a cladding). Choices left out take the page's own for the system.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.
  • measurements · object · optionnel
    Measurement id → value, each length, area or volume with its unit ("12 ft", {"value": 3.6, "unit": "m"}); counts as numbers. Ids are those of the takeoff; any left out opens at the page's own figure.

  Exemple d'appel

  {"name": "check_quote", "arguments": {"job": "bathroom-quote", "quote": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• classify_items≈ 1007 tokens

  Groups a materials list, bill of materials, takeoff, plan or project (lines, calculator slugs or a project state token) by CSI MasterFormat 2018 division, by the site's own keyword rule over each line's calculator or words. A suggested grouping, not a specification; no Uniclass or NRM grouping is given. No prices.

  Paramètres, retour & exemple (4)

  Paramètres

  • lines · array · optionnel
    Lines of a takeoff, plan, house, drawing or bill: each a label, and the calculator slug where known.
  • token · string · optionnel
    A project state token: its lines are grouped.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • calculators · array · optionnel
    Calculator slugs or permanent ids.

  Exemple d'appel

  {"name": "classify_items", "arguments": {"lines": [], "token": "texte", "detail": "full", "calculators": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• convert_units≈ 628 tokens

  Converts one value from one unit to another, for example 2 m³ to cubic yards, with the exact factor the site's calculators apply, and returns the converted value and the factor.

  Paramètres, retour & exemple (5)

  Paramètres

  • to · string · requis
  • from · string · requis
  • value · number · requis
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • dimension · string · optionnel
    Only where a unit names more than one kind of quantity.

  Exemple d'appel

  {"name": "convert_units", "arguments": {"to": "texte", "from": "texte", "value": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_drawing≈ 6738 tokens

  Draws one plan on the Construction Canvas from the shapes, rooms laid out by adjacency on a grid, house figures, drawing commands, canvas document or template given, and returns its materials list, a plan of each level, labour hours, a link that opens the drawing on the canvas, and a file. It does not size structure.

  Paramètres, retour & exemple (11)

  Paramètres

  • name · string · optionnel
    The project's name in the file.
  • house · object · optionnel
    The House Estimator's form: the house drawn as the estimator draws it.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • layout · object · optionnel
    Rooms by name, size and which room each stands against, laid out on a grid: shared walls drawn once as partitions, every snap or move reported, and each room checked to close.
  • shapes · array · optionnel
    Simple shapes the assistant has read from the reader's words — a room, a deck, a patio, a bed, a path, a fence of legs and turns — compiled into the canvas's own commands. Every length with its unit.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • variant · string · optionnel
    With template: one of its two "what changes if" variants, by id; a wrong one is refused with the template's own list.
  • commands · array · optionnel
    Drawing commands, in order, on the canvas's blank drawing (one storey; the wall, partition, window and door types). The whole request is at most 64 KiB.
  • document · object · optionnel
    A Construction Canvas document (schema 1 to the canvas's current), opened and checked by the canvas's own opener.
  • template · string · optionnel
    A Construction Canvas template's slug (the template index lists them: single-room, deck, two-car-garage …): the drawing its page shows, in the reader's system, with a link that opens it.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.

  Exemple d'appel

  {"name": "create_drawing", "arguments": {"name": "texte", "house": {}, "detail": "full", "layout": {}, "shapes": [], "system": "metric"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_project_file_from_calculations≈ 1413 tokens

  Creates one My Project backup file from a list of calculator lines (each a calculator slug and its input values). Each line is computed as the site's page adds it; the reader restores the file on craftquantities.com as a new project. Nothing is stored or sent; no prices.

  Paramètres, retour & exemple (5)

  Paramètres

  • name · string · optionnel
    The new project's name.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • calculators · array · requis
    The calculator lines: each a slug and its input values.

  Exemple d'appel

  {"name": "create_project_file_from_calculations", "arguments": {"calculators": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_project_file_from_drawing≈ 6184 tokens

  Creates one My Project backup file from a Construction Canvas drawing: its lines, and the drawing itself, which the site's canvas reopens. The reader restores the file on craftquantities.com as a new project. Nothing is stored or sent; no prices.

  Paramètres, retour & exemple (4)

  Paramètres

  • name · string · optionnel
    The new project's name.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • drawing · object · requis
    The drawing: a house form, shapes, drawing commands or a canvas document.

  Exemple d'appel

  {"name": "create_project_file_from_drawing", "arguments": {"drawing": {}}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_project_file_from_house≈ 1461 tokens

  Creates one My Project backup file from a House Estimator form: the house's lines, and its drawing, which the site's canvas reopens. The reader restores the file on craftquantities.com as a new project. Nothing is stored or sent; no prices.

  Paramètres, retour & exemple (4)

  Paramètres

  • name · string · optionnel
    The new project's name.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • houses · array · requis
    The House Estimator form (one house; two give their lines without a drawing).
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.

  Exemple d'appel

  {"name": "create_project_file_from_house", "arguments": {"houses": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_project_file_from_plan≈ 2856 tokens

  Creates one My Project backup file from a room plan: one planned space, or several spaces and a roof. Its lines and its plan are saved as the site's planner saves them; the reader restores the file on craftquantities.com as a new project. Nothing is stored or sent; no prices.

  Paramètres, retour & exemple (4)

  Paramètres

  • name · string · optionnel
    The new project's name.
  • plan · object · requis
    One planned space, or a planned project of spaces and a roof.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.

  Exemple d'appel

  {"name": "create_project_file_from_plan", "arguments": {"plan": {}}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_project_file_from_takeoffs≈ 1549 tokens

  Creates one My Project backup file from a list of whole-job takeoffs (each a takeoff id and its measurements). Each takeoff's lines are worked as its page commits them; the reader restores the file on craftquantities.com as a new project. Nothing is stored or sent; no prices.

  Paramètres, retour & exemple (5)

  Paramètres

  • name · string · optionnel
    The new project's name.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • takeoffs · array · requis
    The takeoffs: each an id and its measurements.

  Exemple d'appel

  {"name": "create_project_file_from_takeoffs", "arguments": {"takeoffs": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_supplier_quote_request≈ 1211 tokens

  Creates a request for quote from a materials list or bill of materials (the lines of a takeoff, house, plan or calculation, or the reader's own): Markdown to paste, a CSV, the site's link a merchant opens to price it, and a My Project file. It carries no price and sends nothing to anyone.

  Paramètres, retour & exemple (6)

  Paramètres

  • note · string · optionnel
    A note to the merchants: delivery address area, dates, access.
  • items · array · requis
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • project · string · optionnel
    The project's name, as the merchants will see it.
  • currency · string · optionnel
    The currency prices are asked in; left out, the market's.

  Exemple d'appel

  {"name": "create_supplier_quote_request", "arguments": {"items": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• diagnose_symptom≈ 1346 tokens

  Matches one building defect described in plain words, such as a crack, a damp patch, a water leak or a tripping breaker, to the site's diagnosis pages, and returns the candidate causes, what tells them apart, the checks in order and when to call a professional; ambiguous words return candidates. It does not say which cause it is.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    How many diagnoses at most. Left out: one when the match is clear, up to three when it is not.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • symptom · string · requis
    What the reader sees, hears or smells, in their own words: "my breaker keeps tripping when the kettle is on".

  Exemple d'appel

  {"name": "diagnose_symptom", "arguments": {"symptom": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• estimate_house≈ 1609 tokens

  Estimates the materials to build one rectangular house of one or two storeys from a few figures (footprint, walls, roof, openings): every quantity with what to order, assumptions, plans of each storey and labour hours, as the site's House Estimator does. It counts; it does not design a structure. No prices.

  Paramètres, retour & exemple (11)

  Paramètres

  • pitch · string · optionnel · 4 | 6 | 8 | 10 | 12
    Roof pitch, rise in 12.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • family · string · optionnel · wall.framed-exterior | wall.masonry | wall.sip
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • values · object · optionnel
    The form's figures, each length with its unit: length, width, storeyHeight, eaveOverhang, rakeOverhang, slabThickness, footingWidth, footingDepth, trenchDepth, windowWidth, windowHeight, doorWidth, doorHeight ("12 m", "40 ft"); and the counts partitions, windows, outsideDoors, interiorDoors, iceDamEaves. Any left out opens where the page opens it.
  • example · string · optionnel
    Start from one of the site's example houses (its slug) in place of the estimator's opening house.
  • storeys · integer · optionnel · 1 | 2
  • selection · object · optionnel
    The exterior wall's build-up choices.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.
  • roofFamily · string · optionnel · roof.asphalt-shingle | roof.tile-slate
  • roofSelection · object · optionnel

  Exemple d'appel

  {"name": "estimate_house", "arguments": {"pitch": "4", "detail": "full", "family": "wall.framed-exterior", "system": "metric", "values": {}, "example": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• export_drawing≈ 6292 tokens

  Exports a Construction Canvas drawing (a template, shapes, a room layout, drawing commands, house figures or a canvas document) as DXF for CAD, with the site's CQ-* layers, and as SVG, one plan per level in millimetres, or as one openBIM IFC4 model with quantity sets, as the canvas's own download writes them; a file too large to return is rebuilt from the drawing's link.

  Paramètres, retour & exemple (12)

  Paramètres

  • house · object · optionnel
    The House Estimator's form: the house drawn as the estimator draws it.
  • level · string · optionnel
    One level by its id or name; left out, every level with something on its plan.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • layout · object · optionnel
    Rooms by name, size and which room each stands against, laid out on a grid: shared walls drawn once as partitions, every snap or move reported, and each room checked to close.
  • shapes · array · optionnel
    Simple shapes the assistant has read from the reader's words — a room, a deck, a patio, a bed, a path, a fence of legs and turns — compiled into the canvas's own commands. Every length with its unit.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • formats · array · optionnel
    dxf, svg, ifc (openBIM IFC4: one file for the whole drawing, every level, with quantity sets), or several; left out, dxf and svg.
  • variant · string · optionnel
    With template: one of its two "what changes if" variants, by id; a wrong one is refused with the template's own list.
  • commands · array · optionnel
    Drawing commands, in order, on the canvas's blank drawing (one storey; the wall, partition, window and door types). The whole request is at most 64 KiB.
  • document · object · optionnel
    A Construction Canvas document (schema 1 to the canvas's current), opened and checked by the canvas's own opener.
  • template · string · optionnel
    A Construction Canvas template's slug (the template index lists them: single-room, deck, two-car-garage …): the drawing its page shows, in the reader's system, with a link that opens it.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.

  Exemple d'appel

  {"name": "export_drawing", "arguments": {"house": {}, "level": "texte", "detail": "full", "layout": {}, "shapes": [], "system": "metric"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• fetch≈ 234 tokens

  Returns the full text of one Craft Quantities page, identified by its id: what the page works out, its inputs or measurements with units and opening values, and its sources.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    A page id, such as calculator:concrete-calculator, takeoff:concrete-slab or diagnosis:drain-gurgles.

  Exemple d'appel

  {"name": "fetch", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"id": "texte", "url": "texte", "text": "texte", "title": "texte", "metadata": {}}}

• get_benchmark≈ 2080 tokens

  Returns items of the Construction Quantities Benchmark, a CC BY 4.0 dataset of construction quantity questions built from the site's calculator test vectors: each with its inputs and a prompt in metric and US units, the expected answer in each system with its tolerance, and the worked steps. A page of calculators at a time or one calculator's items, with the download link and how to cite it.

  Paramètres, retour & exemple (3)

  Paramètres

  • page · integer · optionnel
    Which page of the benchmark, from 1: each page holds the items of a few calculators, in slug order. 1 when left out.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • calculator · string · optionnel
    One calculator's items only, by its slug, such as concrete-calculator.

  Exemple d'appel

  {"name": "get_benchmark", "arguments": {"page": 1, "detail": "full", "calculator": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_calculator≈ 1112 tokens

  Returns the input fields of one calculator, identified by its slug: each field's id, label, accepted units, range and default value in metric and US units, with the calculator's version, page and citation. It computes nothing.

  Paramètres, retour & exemple (2)

  Paramètres

  • slug · string · requis
    The calculator's slug, such as concrete-calculator.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.

  Exemple d'appel

  {"name": "get_calculator", "arguments": {"slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_example≈ 894 tokens

  Returns one worked construction estimate from the site, identified by its slug: the measurements, the steps in order with the calculator each uses, the figure each step pins and the waste chosen.

  Paramètres, retour & exemple (2)

  Paramètres

  • slug · string · requis
    A worked example's slug, such as bathroom-gutted-and-retiled.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.

  Exemple d'appel

  {"name": "get_example", "arguments": {"slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_planner≈ 745 tokens

  Returns the room planner's fields for one kind of space: its figures, surfaces and finish ids, scope questions and rows, with their ids.

  Paramètres, retour & exemple (2)

  Paramètres

  • kind · string · requis · room | bathroom | slab | deck | driveway | fence | loft | retaining-wall
    The kind of space: a room or a bathroom (from its size, doors and windows), or a slab, deck, driveway, fence, loft, retaining wall, exterior wall or stair.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.

  Exemple d'appel

  {"name": "get_planner", "arguments": {"kind": "room"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_sources≈ 1062 tokens

  Where does a figure come from, and how is it cited? Returns a calculator's sources as it cites them, the codes and standards they name, the site's standards pages, and a citation in plain, APA, Harvard and BibTeX. It adds no source the calculator does not cite.

  Paramètres, retour & exemple (2)

  Paramètres

  • slug · string · requis
    The calculator's slug, such as concrete-calculator.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.

  Exemple d'appel

  {"name": "get_sources", "arguments": {"slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_takeoff≈ 1029 tokens

  Returns the measurements one whole-job takeoff needs, identified by its id: each measurement's id, unit and opening figure, its build-up choices, the calculators it runs and what it leaves out.

  Paramètres, retour & exemple (2)

  Paramètres

  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • takeoff · string · requis
    A takeoff id, such as concrete-slab.

  Exemple d'appel

  {"name": "get_takeoff", "arguments": {"takeoff": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• import_quote≈ 821 tokens

  Turns a supplier's or builder's quote the reader has, prices and all, into a My Project file, as the site's Quote to Estimate does, and checks its own arithmetic. The prices are the reader's figures from their document, not the site's.

  Paramètres, retour & exemple (6)

  Paramètres

  • name · string · optionnel
  • quote · string · requis
    The quote's text, one item to a line, with its prices.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • currency · string · optionnel
    The quote's currency symbol, where the quote does not show it.
  • supplier · string · optionnel

  Exemple d'appel

  {"name": "import_quote", "arguments": {"quote": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• layout_reinforcement≈ 2244 tokens

  Lays out reinforcing bars in a rectangular slab or footing from the bar size, spacing and cover the engineer gives: bars each way, bar lengths, total length with lap, stock sticks, weight where the site's calculator carries the size, and the layout as SVG and DXF. A quantity layout, not a design: it does not size structure or check a code.

  Paramètres, retour & exemple (15)

  Paramètres

  • mats · enum · optionnel · 1 | 2
    One mat, or two (top and bottom) laid out alike.
  • cover · ? · requis
    The cover to the bars on plan, as the engineer gives it.
  • width · ? · requis
    Along y, with its unit.
  • chairs · object · optionnel
    Count the bar supports too, from the supplier's support spacing.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • length · ? · requis
    Along x, with its unit.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • barSize · string · requis
    As the engineer gives it: #4, 15M, N12, H12, T12 or 12 mm.
  • element · enum · optionnel · slab | footing
    A slab, or a pad or strip footing, as a rectangle on plan.
  • formats · array · optionnel
    The drawing's files: svg, dxf or both (the default).
  • spacing · ? · optionnel
    The spacing both ways, as the engineer gives it.
  • widthwise · object · optionnel
    The bars running along the width (spaced along the length): a spacing of their own, or a count.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.
  • lapPercent · number · optionnel
    The lap-splice allowance on the total; left out, the Rebar Calculator's own default.
  • lengthwise · object · optionnel
    The bars running along the length (spaced across the width): a spacing of their own, or a count.

  Exemple d'appel

  {"name": "layout_reinforcement", "arguments": {"cover": "texte", "width": "texte", "length": "texte", "barSize": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• market_documents≈ 1244 tokens

  Finds which family of building codes or standards governs one kind of work in one market (US, Canada, UK or Australia, or a country mapped to one), who publishes it and the site's standards page. It does not say which edition is in force: adoption is local, and the answer names who decides.

  Paramètres, retour & exemple (4)

  Paramètres

  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · requis
    US, CA, UK, AU or INTL — or a country's name ("England", "Canada"); a country the site has no market for answers as INTL.
  • subject · string · optionnel
    The work, in words: "kitchen wiring", "stair handrails", "gas boiler flue".
  • calculator · string · optionnel
    Or a calculator's slug: the subjects its own sources name.

  Exemple d'appel

  {"name": "market_documents", "arguments": {"market": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• measure_sketch≈ 2690 tokens

  Measures areas, perimeters and lengths from points read off a floor plan, sketch or photo (pixel coordinates) and one known reference (a figured dimension, an ID-1 card or an A4 or Letter sheet): scaled figures in metric and US units with an uncertainty band, closure and crossing checks, and a canvas link. It receives no image.

  Paramètres, retour & exemple (6)

  Paramètres

  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • shapes · array · requis
    The outlines and lines read off the image, in its pixels.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • reference · object · requis
    ONE known size in the same image: a figured dimension, or an object of known size by its four corners.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.
  • pixelError · number · optionnel
    How far any point may be off, in pixels: it sets the band.

  Exemple d'appel

  {"name": "measure_sketch", "arguments": {"shapes": [], "reference": {}}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• open_in_site_link≈ 1045 tokens

  Returns a link that opens a construction calculator's page on craftquantities.com with the reader's figures filled in and their unit system, so a person can see or change the working on the page.

  Paramètres, retour & exemple (6)

  Paramètres

  • slug · string · requis
    The calculator's slug, such as concrete-calculator.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • inputs · object · optionnel
    The calculator's input values, by input id (an unknown id is refused with the accepted ids). A length, area, volume or other measured input takes "12 ft", "3.5 m", "8' 3 1/2\"" or {"value": 12, "unit": "ft"}; a count or percentage takes a number; a select takes one of its option values. Inputs left out take the value the calculator's page opens on.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.

  Exemple d'appel

  {"name": "open_in_site_link", "arguments": {"slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• optimise_cuts≈ 3307 tokens

  Optimises a cut list: pieces of given lengths cut from the stock lengths a merchant sells (timber, studs, joists, rafters, rebar, trim), or rectangles nested on sheets (plasterboard, drywall, plywood, OSB, tiles) in straight edge-to-edge cuts. Gives the stock or sheets to buy, a cutting plan per bar or sheet, the real waste and a lower bound. Quantities only: no prices, no structural design.

  Paramètres, retour & exemple (11)

  Paramètres

  • kerf · ? · optionnel
    The saw's kerf, charged on every piece (both ways on a sheet). Left out, the material's: 3 mm or 1/8 in for a saw, none for a bar shear or a board knife.
  • kind · enum · requis · linear | sheet
    linear: lengths cut from stock lengths (studs, plates, joists, rafters, bars, trim, boards). sheet: rectangles nested on sheets (plasterboard or drywall, plywood, OSB, tiles).
  • stock · array · optionnel
    linear: the stock lengths on offer, each in any number, with units ("4.8 m", "16 ft"). Left out, the market's usual lengths for the material in the system asked for.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • pieces · array · requis
    The cut list: up to 200 lines and 3000 pieces (1500 for sheets) in all.
  • rotate · boolean · optionnel
    sheet: whether pieces may turn a quarter (no grain or strength axis to keep). Left out: yes for plasterboard and tiles, no for plywood and OSB.
  • sheets · array · optionnel
    sheet: the sheet sizes on offer (the plan takes the one that buys the least area). Left out, the market's usual size for the material.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • material · enum · optionnel · timber | rebar | casing | plasterboard | plywood | osb | tile
    What is cut, for the market's stock lengths or sheet sizes, saw kerf and grain when they are left out: timber (the default for linear), rebar or casing; plasterboard (the default for sheet), plywood, OSB or tile.
  • minOffcut · ? · optionnel
    linear: the shortest offcut worth keeping; shorter ones count as waste.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.

  Exemple d'appel

  {"name": "optimise_cuts", "arguments": {"kind": "linear", "pieces": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• plan_programme≈ 7798 tokens

  Builds a construction programme (build schedule, Gantt) from a project's labour hours: tasks by trade, stage and level in the usual order of work, each its hours over the crew and working day given, with totals, a CSV and, with a start date, an iCalendar file. Reads a project state token, a My Project file, takeoffs or a drawing. Weather, inspections and lead times are not modelled. No prices.

  Paramètres, retour & exemple (14)

  Paramètres

  • crew · integer · optionnel
    People in each trade's crew, unless named in crews.
  • file · object · optionnel
    A My Project file (the backup a project-file answer returns, or one the reader exported): its active project's lines and any hours typed on them.
  • name · string · optionnel
    The project's name, for the files.
  • crews · object · optionnel
    People in a trade's crew, by trade id (carpentry, drywall, electrical, roofing …).
  • token · string · optionnel
    A project state token (cqp1.…) from a project-file answer or an update: the project whose lines are put in order.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • daysOff · array · optionnel
    Dates not worked (holidays, a shutdown), YYYY-MM-DD.
  • drawing · object · optionnel
    A Construction Canvas drawing (a template, a house form, shapes, drawing commands or a canvas document), as a project file takes it; its levels set the level-by-level order.
  • takeoffs · array · optionnel
    Whole-job takeoffs, each an id and its measurements, as a project file takes them.
  • workDays · array · optionnel
    The days of the week worked, 1 Monday to 7 Sunday.
  • startDate · string · optionnel
    Optional first day (YYYY-MM-DD): the working days are then given dates and a calendar file is returned. No date is assumed without it.
  • hoursPerDay · number · optionnel
    Working hours in a crew's day.

  Exemple d'appel

  {"name": "plan_programme", "arguments": {"crew": 1, "file": {}, "name": "texte", "crews": {}, "token": "texte", "detail": "full"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• plan_project≈ 2125 tokens

  Plans several spaces together, with an optional roof over them, as one project in the site's room planner, and returns each space's rows, every line together, labour hours and the plan. Quantities only; it does not size structure.

  Paramètres, retour & exemple (5)

  Paramètres

  • roof · object · optionnel
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • spaces · array · requis
    The spaces, in order, each one planned space.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.

  Exemple d'appel

  {"name": "plan_project", "arguments": {"spaces": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• plan_room≈ 1772 tokens

  Plans one space, such as a room or a bathroom, from its size, openings and the finishes chosen, as the site's room planner does, and returns its materials list: each row with its quantity, what it still needs, what is not built and why, and labour hours. Quantities only; it does not size structure.

  Paramètres, retour & exemple (13)

  Paramètres

  • kind · string · requis · room | bathroom | slab | deck | driveway | fence | loft | retaining-wall
    The kind of space: a room or a bathroom (from its size, doors and windows), or a slab, deck, driveway, fence, loft, retaining wall, exterior wall or stair.
  • name · string · optionnel
  • doors · object · optionnel
  • scope · object · optionnel
    Scope question name → answer value, by the planner's ids.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • inputs · object · optionnel
    Branch id → { calculator input id: value in its base unit }.
  • intent · string · optionnel
    A trade, or everything.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • figures · object · requis
    The space's figures, by the planner's ids, each a length with its unit (a room: length, width, height, wallThickness; a fence: length, height; a stair: totalRise, width …).
  • windows · object · optionnel
  • finishes · object · optionnel
    Surface role → finish id, by the planner's ids.
  • leaveOut · array · optionnel
    Branch ids to leave out.
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.

  Exemple d'appel

  {"name": "plan_room", "arguments": {"kind": "room", "figures": {}}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• resolve_id≈ 844 tokens

  Resolves a permanent Craft Quantities id (such as cq-c0412), a current or earlier slug, or a craftquantities.com address to the page as it is today: its kind, current slug, slug history, page link and permanent /id/ link. Ids are assigned once and kept when a page is renamed or moved; a removed page names its replacement.

  Paramètres, retour & exemple (3)

  Paramètres

  • ref · string · requis
    A permanent id (cq-c0412), a current or earlier slug, or a craftquantities.com address.
  • kind · enum · optionnel · calculator | takeoff | guide | example | term | diagnosis
    Only pages of this kind.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.

  Exemple d'appel

  {"name": "resolve_id", "arguments": {"ref": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• run_example≈ 972 tokens

  Re-runs every pinned step of a worked construction estimate now, in both unit systems, and returns whether each still meets the published figure.

  Paramètres, retour & exemple (2)

  Paramètres

  • slug · string · requis
    A worked example's slug, such as bathroom-gutted-and-retiled.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.

  Exemple d'appel

  {"name": "run_example", "arguments": {"slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• run_takeoff≈ 2852 tokens

  Works one whole-job takeoff, identified by its id, from the measurements given: the materials list of a job such as a slab or a deck, each line from its own calculator, with what to order, waste allowances, metric and US units, labour hours (not a price), what is not counted, a citation and the page link. It does not size structure.

  Paramètres, retour & exemple (9)

  Paramètres

  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • market · string · optionnel · US | CA | UK | AU | INTL
    Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  • system · string · optionnel · metric | imperial
    The unit system inputs left out open in, and the one the page link opens in. The answer comes in both.
  • takeoff · string · requis
    A takeoff id, such as concrete-slab.
  • leaveOut · array · optionnel
    Rows the reader leaves out of the job: still worked and shown, not put in the project or counted in labour.
  • selection · object · optionnel
    Build-up choice id → option id, the takeoff's own (a stud size, an insulation, a cladding). Choices left out take the page's own for the system.
  • allowances · object · optionnel
    Row → an allowance the reader sets: a percentage (cutting waste, overlap), or the option an allowance follows (a lay pattern). Row names are the takeoff's steps (the calculator slug, or the step key where one runs twice).
  • inputUnits · string · optionnel · base
    Send "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.
  • measurements · object · optionnel
    Measurement id → value, each length, area or volume with its unit ("12 ft", {"value": 3.6, "unit": "m"}); counts as numbers. Ids are those of the takeoff; any left out opens at the page's own figure.

  Exemple d'appel

  {"name": "run_takeoff", "arguments": {"takeoff": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search≈ 385 tokens

  Searches the site's construction pages for a question in everyday words, such as how much concrete or tile a job needs, and returns the matching pages: id, kind, title, link, description and slug. It finds; it computes nothing.

  Paramètres, retour & exemple (3)

  Paramètres

  • kinds · array · optionnel
    Only these kinds of result; every kind when left out.
  • limit · integer · optionnel
  • query · string · requis
    What to find, such as "concrete slab" or "skirting board".

  Exemple d'appel

  {"name": "search", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"results": []}}

• solve_backwards≈ 1452 tokens

  Works out how far one amount of material goes, such as 40 bags of concrete or 24 gallons of paint: the area it covers and the size of slab, room, deck or wall that is, as the site's Solve Backwards page works it, waste taken off. It does not size structure.

  Paramètres, retour & exemple (6)

  Paramètres

  • have · ? · requis
    How much the reader has: a count for counted things (20, "20 sheets"); a measure with its unit for paint, concrete, soil ("24 gal", "2 m3", {"value": 90, "unit": "L"}).
  • page · string · optionnel
    A Solve Backwards page's slug, such as wall-paint, drywall-sheets, bricks, concrete-bags, ready-mix-concrete.
  • query · string · optionnel
    Or what the reader has, in words ("sheets of drywall", "bags of concrete"), when the slug is not known.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • system · string · optionnel · metric | imperial
    The page's system; it sets the market's product (a 4 × 8 ft sheet in imperial). Left out: the unit's system, else metric.
  • settings · object · optionnel
    Optional: another calculator input, with its unit (a slab's thickness "4 in", coats 3). The inputs the page grows cannot be set.

  Exemple d'appel

  {"name": "solve_backwards", "arguments": {"have": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• translate_term≈ 1850 tokens

  Says one building-trade word in US, Canadian, UK and Australian usage, such as plasterboard (drywall in the US) or skirting (baseboard): each market's word, how close each is, false-friend warnings, unit traps such as US and imperial gallons or short and metric tons with their conversions, and the market's document family. Brand names, plurals and misspellings match too.

  Paramètres, retour & exemple (4)

  Paramètres

  • to · string · optionnel · US | CA | UK | AU
    The market to say it in.
  • from · string · optionnel · US | CA | UK | AU
    The market whose word it is, where known.
  • term · string · requis
    A trade word or phrase as one market says it, a brand name said for the product, or a misspelling: "plasterboard", "gyprock", "casing", "skirting", "eavestrough", "a yard of concrete".
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.

  Exemple d'appel

  {"name": "translate_term", "arguments": {"term": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_project≈ 2680 tokens

  Changes a My Project project carried in a state token (cqp1.…, from a project file answer): add or remove a room or space, change a dimension, add or remove a takeoff or calculator line, change a roof pitch, rename. Rebuilds every line and returns the new token, a short diff, the totals and a site link. The token is compressed, not encrypted; nothing is stored. No prices.

  Paramètres, retour & exemple (4)

  Paramètres

  • file · boolean · optionnel
    true: the updated My Project file as well.
  • token · string · requis
    A project state token from a project-file answer or an earlier update.
  • detail · string · optionnel · full | summary
    full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
  • operations · array · optionnel
    The changes, applied in order (0 to 20); none returns the project as the token holds it.

  Exemple d'appel

  {"name": "update_project", "arguments": {"token": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://api.craftquantities.com/mcp