What the assistant can read

A connected assistant can read across your Assemblified data and your live Shopify catalog. With a read-only connection it cannot change anything — see Read-only by default. A write-scope connection reaches a much larger surface: bills, assembly bills and raw materials, but also work orders and build runs, stock restocking, bill versions, your catalogues, entity groups, the reporting sync and your shop settings. The operating pages describe each one. This page lists the read surface so you know what you can ask about.

The data it can reach

The assistant can read across these areas, scoped to your single store:

Area	What it can see
Bills of materials	Your finished goods and their full composition — component materials, nested assembly bills, quantities, settings, and per-row usage. Search, filter (used / unused, by vendor), and sort just like the app’s list.
Buildable quantities	For any BOM, how many units you can build right now, per location — the same number the app’s Max Buildable column shows — including the sellable split and which components are the limiting factor.
Assembly bills	Your reusable assembly bills (the app’s newer name for sub-assemblies) and their hydrated component trees, with usage counts.
Per-location bill rules	What you have configured a bill to do at each location — the execution mode there, and the materials that are added, changed or removed at that location. Separately, the assistant can read the bill as seen from a location: the same recipe with that location’s rule already applied.
Bill history	The versions saved for a bill, newest first, what changed between any two of them, and how one compares with the recipe as it stands today. Reading history is open on every plan; saving and restoring need Enhanced. See Operating bill versions.
Raw materials	Every raw material — Shopify-linked and virtual — with its per-BOM and per-assembly-bill usage, vendor, SKU, and (optionally) the BOMs and assembly bills that reference it.
Material search	The same search, filters and sorting the Raw materials page uses, as a single call — plus the four counts above that table, and the names of the recipes that consume any material.
Shopify catalog	Your live Shopify products and variants, searchable with Shopify’s own filter syntax, plus lookups by id — so the assistant can find the right variant before registering it as a material.
Locations	Your Shopify locations, so the assistant can resolve location names and ids.
Inventory levels	Real per-location stock for any material — live Shopify levels for Shopify-linked materials, app-tracked levels for virtual ones.
Committed stock	How much of a material is already spoken for at each location: what open orders hold, and what your safety-stock reservations hold. Neither is available stock.
Allocated stock (shelf)	How much of a material is already built into finished items sitting on the shelf at each location, with the list of what those items are.
Allocated stock (work orders)	A different number: how many units of a material your open work orders have already picked and still have to pick, per location, with the work orders behind it. Demand from a work order with no location is reported separately. Neither figure may be subtracted from availability.
Stock history	A material’s movement history — what changed, when, and what caused it — for both Shopify-linked and virtual materials, newest first.
Material metafields	Every stored metafield value for a slice of materials in one read, including whether a value has been overridden locally.
Pre-assembled stock	Per-location pre-assembled quantities for your finished goods and assembly bills.
Additional costs	Your catalogue of cost factors — labour and overhead rates — plus which factors each BOM and assembly bill references, and at what per-unit quantity.
Your catalogues	The lists the rest of the app draws from: units and the conversions between them, material tags, metafield definitions, import templates, the assignees a work order can be assigned to, and the work-order export, QC and tag lists.
Groups	Your entity groups — the named sets of bills, assembly bills or raw materials — with their member counts and, for one group, its members.
Bulk builder rules	The saved rules the bulk bill builder replays over a grid: what each one matches and what it puts in.
Cost breakdown	For any finished good or assembly bill, what it costs right now against the figure stored on the record, with the additional-costs portion reported separately so the difference between the two can be explained rather than mistaken for an error. Up to 25 at a time. It reads; it never rewrites a cost.
Work orders	Your work orders: the list with its own filters and the counts beside them, one whole work order (its items, materials, the merged consumption plan, build runs, QC reviews, rework items, documents, conversation and activity), the material plan on its own, the build-run history, what a transition would allow, and the purchase-order view of what is missing.
Assemble tasks	Your task list — title, status, priority, label, due date and quantity, plus the assemble flow or Shopify order a task came from, the work order linked to it (name, short ID, status and whether it is a material-list-only one), and whether the app raised it or a person did. Filter by status, priority or label and search by text, the same way the Assemble tasks page does.
Your home dashboard	The same summary the app’s home page shows, in one call: how many finished goods, assembly bills and raw materials you have, how many bills are inactive or unlinked or thin on margin, your most recent runs, and how far through setup you are.
Search	The same search the app’s search field runs, across finished goods, assembly bills, raw materials, work orders, saved views and groups at once. Three characters minimum. This is how an assistant works out which thing you meant before it goes and reads it.
Execution history	Every run the app recorded — the orders and assemble flows it processed, whether each one succeeded, failed or is still pending, and for any single run the full picture: the bills it processed, the ones it skipped and why, the materials it moved and by how much, and where in the pipeline an error came from. Plus the over-consumption report, which lists orders whose components were drawn down more than the order allows.
Reports	The report catalogue — every report the app can answer, across sales, bills of materials and manufacturing — and the report itself: a page of rows over a period you name, with its metric figures, optionally split by day, week or month and narrowed to locations.
Reporting freshness	How current the order history your sales reports are built on actually is, and whether its refresh is behind or has stopped. See Operating the reporting sync.
Your settings	Every setting of your store, and what each one does in plain language — the fallback location, whether order reservations hold stock, whether Logistified is connected, what the packing slip shows. This is how an assistant explains why a number looks the way it does instead of guessing.

How it explores the API

The assistant doesn’t have to guess what’s available. Alongside run, it can call describe_api, which returns the live, typed definition of everything it can reach — every area above, the inputs each accepts, and the shape of what comes back. This is how a capable assistant figures out, on its own, how to answer a question like “which BOMs am I about to run out of components for?”

Ask for one area at a time. The full definition is very large — big enough to fill a chat model’s working memory on its own — so describe_api takes an optional list of areas and returns only those: describe_api({ namespaces: ['billOfMaterials', 'inventory'] }). The tool itself lists the area names your connection can use. If an assistant keeps losing the thread of a long conversation, or claims it cannot find a method you know exists, telling it which area to look in usually fixes it.

Reading the documentation

The assistant can also read this documentation site through two tools:

list_docs — the index of every documentation page.
get_doc — the full text of one page.

This lets it ground its answers in how Assemblified actually works — what a BOM is, how pre-assembled stock works, what the buildable calculation includes — instead of guessing.

What’s not included

Writing without write access. A read-only connection can’t create or change anything, and the actions it isn’t allowed to take aren’t even visible to it. What a write-scope connection adds is covered on the operating pages.
Editing your Shopify catalog. Products, variants, prices and titles in Shopify are read-only through this surface — the assistant reads them to find and reference variants, but it never edits a Shopify product.
Running an assemble flow. Flows stay in the app. An assistant can see which flow a task or a work order came from, but it cannot run, create or edit one.
Reaching another store. A connection is scoped to the single store it was created in.