AI / Agent access (MCP)

AI / Agent access lets you connect your own AI assistant — Claude (desktop, web, or CLI), ChatGPT, or a custom agent — to your Assemblified data over MCP (the Model Context Protocol). Once connected, you can ask your assistant about your bills of materialsBill of MaterialsA bill of materials tells Assemblified how to build one unit of a finished good. When a customer orders the finished-good variant, Assemblified deducts the right component quantities from inventory automatically. Read more → , assembly billsAssembly billThe recipe for an intermediate component you build and then use inside other bills — a lid, a wick assembly, a pre-wired harness. It keeps its own pre-assembled stock and can be a work order item in its own right. Read more → (the app’s newer name for sub-assemblies), raw materialsRaw materialThe atomic component of a bill of materials or an assembly bill. Two flavours: a Shopify-linked variant, whose inventory Shopify tracks, or a virtual material, which Assemblified tracks on its own and Shopify never sees. Both sit in the same component picker and are consumed the same way. Read more → , work ordersWork OrderA planned production run: pick materials, build the items, do QC, and complete — all tracked together. Use work orders when you're building stock ahead of demand or running a multi-day project. Read more → and reports in plain language — and, if you allow it, have the assistant do the work for you.

In the Assemblified admin this is Settings → Connections → API & agent access. (The page itself is still headed “LLM / API access” — same page, older name.)

Open beta

API & agent access is currently in open beta. It requires an active Assemblified subscription, and access may move to the Enhanced plan in the future. Open Settings → API & agent access to create API keys or connect a web chat.

On this page

• What you can do with it
• How it works (code mode)
• What the API covers
• Read-only by default
• Where to next

What you can do with it

Connect an AI assistant and ask things like:

• “Which of my finished goods can I build right now, and what’s the limiting component?”
• “List every raw material that isn’t used in any bill yet.”
• “Register these Shopify variants as raw materials and build a bill for the Gift Box Deluxe.”
• “Set the pre-assembled count for this assembly bill to 12 at my main location — I just counted them.”
• “Plan a work order for 40 Oak Tables and tell me what I’m short of.”
• “Run the top-selling finished goods report for last month.”

The assistant reads live data from your store — and, with write access, makes the changes for you — so there’s no copy-pasting product IDs or exporting spreadsheets.

How it works (code mode)

Assemblified exposes a single, powerful tool to your assistant called run. Instead of the assistant chaining dozens of small requests, it writes a short program against a typed app API and Assemblified runs it once, safely, in an isolated sandbox:

run("return await app.rawMaterials.list({});")

This “code mode” approach lets the assistant search, filter, join, and summarise your data in one step — for example, finding the right Shopify variants, registering them as raw materials, and composing a bill from them — without you writing any code yourself. You just ask in plain language; the assistant writes the program.

Three more tools sit beside run:

• describe_api — the live, typed definition of everything the connection can reach. The whole surface is large, so a capable assistant asks for the areas it needs ({ namespaces: ['billOfMaterials','rawMaterials'] }) rather than the lot. If your chat client struggles, telling it which area you mean is the single most useful hint you can give it.
• list_docs and get_doc — this very documentation site, so the assistant can ground its answers in how Assemblified actually works instead of guessing.

What the API covers

The app API is organised into named areas. These are the ones a connection can reach:

• Bills and recipes — billOfMaterials and assemblyBills (your finished goods and your reusable assembly bills, with their composition, per-location rules, pre-assembled stockPre-Assembled InventoryStock of finished goods and assembly bills already built and on the shelf, counted per location. A work order draws assembly bills from the shelf first, building fresh only if it runs short; an order consumes a finished good's shelf before its components. Read more → and a buildable calculator that matches the app’s Max Buildable column), billVersions (a bill’s saved history and the way back to it) and bulkBomRules (the saved rules the bulk bill builder replays).
• Materials and stock — rawMaterials (Shopify-linked and virtualVirtual MaterialA material tracked entirely inside Assemblified — not a Shopify variant. Useful for shop-floor consumables (glue, packaging, labour units) where you need quantity tracking but don't want a Shopify product on your storefront. Read more → ), metafields (stored values on a material), inventory (real per-location levels, pre-assembled and residual figures, what is committed, what is allocated, and restocking) and inventoryGuard (the check that finds lines Shopify would reject before a stock push).
• Manufacturing — workOrders (the whole work-order surface: plan, edit, transition, build runs, QC, documents, purchase orders and the work-order catalogues) and assembleTasks (the lighter task list).
• Your Shopify store — shopify (search products and variants, list locations) and orders (the per-order bill breakdown a warehouse packs from).
• Catalogues — costFactors (additional costs), units and unitConversions, materialTags, metafieldDefinitions, importTemplates, assignees (the people a work order can be assigned to) and entityGroups.
• Insight and admin — reporting (the report catalogue, running a report, and the order-history sync), dashboard (the home summary), search (the app’s own cross-entity search), executionLogs (what the app did and whether it worked) and settings (read, explain, preflight and change your shop settings).

Read-only by default

By default, AI / Agent access is read-only: your assistant can look at your data but cannot change anything. Actions it isn’t allowed to take aren’t even visible to it.

If you explicitly grant write access (a write-scope API key, or a web-chat connection granted write when it’s linked), the connection unlocks a large surface. In outline, a write key can:

• build and maintain bills, assembly bills, raw materials and their per-location rules;
• adjust pre-assembled stock, set virtual stock levels and restock any material at any location — including pushing stock to Shopify;
• run work orders end to end, including starting a build run, which moves real Shopify inventory (Enhanced plan);
• save and restore a bill’s versions (Enhanced plan), and push a computed cost to Shopify;
• maintain your catalogues — units, tags, metafield definitions, import templates, assignees, groups and the bulk-builder rules;
• change your shop settings, and refresh or restart the reporting sync.

Write access is broader than it used to be

A write-scope key is not limited to editing recipes. It can move real stock and change how your store behaves. Grant it deliberately, prefer a read key for anything exploratory, and read Managing access & security before you hand one out. The operating pages below describe each write surface in detail.

Note

A read-only connection is safe to experiment with: the worst it can do is read data it’s allowed to read, scoped to your single store. Write access is opt-in per key or connection and can be revoked at any time.

Where to next

Create an API key Issue a key for a desktop or command-line client.

Connect a desktop / CLI client Claude Desktop, Claude Code, Codex, custom agents.

Connect claude.ai or ChatGPT The web-chat connector flow with a one-time code.

What the assistant can read The full read-only data surface.

Managing access & security Revoke keys and connections; the security model.

The operating pages

Each one describes a write surface in detail: what it can do, what it refuses, and what needs a plan.

BOMs & assembly bills Build, compose, stock and configure finished goods and assembly bills.

Raw materials & stock Register materials, set virtual levels, restock and reconcile.

Work orders Plan a build, run it, review it, and order what is missing.

Bill versions Snapshot a recipe, compare two versions, and restore one.

Reports The report catalogue and running a report over a period.

The reporting sync Check, refresh and restart the order-history copy reports are built on.

Settings Read, explain and change your shop settings safely.

Groups & saved views Group bills, assembly bills and materials; what the assistant sees of saved views.

Bulk bill-builder rules The saved rules the bulk builder replays over a grid.

Units & conversions The unit catalogue and the conversions between units.

Material tags Maintain and apply your material tag list.

Metafield definitions The custom fields your materials carry.

Import templates The saved column mappings your imports use.