Katana Manufacturing Orders & BOMs
What is on the shop floor today, and what is blocked? For makers on Katana MRP: open manufacturing orders (or make-to-order ones from a sales order row), check ingredient rows and BOMs, tick off operation steps and record partial productions as batches come off the line.
Connect this API to an AI agent Browse all specs
What you can do with Katana Manufacturing Orders & BOMs via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /manufacturing_orders |
listManufacturingOrders | List manufacturing orders by status, order number or location |
| POST | /manufacturing_orders |
createManufacturingOrder | Create a manufacturing order to make a product variant |
| GET | /manufacturing_orders/{id} |
getManufacturingOrder | Get one manufacturing order with quantities, deadline and costs |
| PATCH | /manufacturing_orders/{id} |
updateManufacturingOrder | Update a manufacturing order (status, quantity, deadline, notes) |
| POST | /manufacturing_order_make_to_order |
createMakeToOrderManufacturingOrder | Create a make-to-order manufacturing order from a sales order row |
| GET | /manufacturing_order_recipe_rows |
listManufacturingOrderIngredients | List the ingredient rows of manufacturing orders |
| PATCH | /manufacturing_order_recipe_rows/{id} |
updateManufacturingOrderIngredient | Update an ingredient row (quantity, notes, batch) |
| GET | /manufacturing_order_operation_rows |
listManufacturingOrderOperations | List the operation steps of manufacturing orders |
| PATCH | /manufacturing_order_operation_rows/{id} |
updateManufacturingOrderOperation | Update an operation step (status, time, operator) |
| GET | /manufacturing_order_productions |
listManufacturingOrderProductions | List productions recorded against manufacturing orders |
| POST | /manufacturing_order_productions |
createManufacturingOrderProduction | Record a partial production (finished quantity) on a manufacturing order |
| GET | /bom_rows |
listBomRows | List bill-of-materials rows (ingredients per product variant) |
| GET | /variants |
listVariants | Find product and material variants by SKU or other filters |
| GET | /locations |
listLocations | List warehouses and factory locations |
Authentication
katanaApiKey
Bearer token — sent as Authorization: Bearer <token>
Katana uses a live API key sent as Authorization: Bearer <key>.
How to get a credential
- Log in to Katana as an admin (API access needs the Professional plan or higher).
- Go to Settings > API.
- Select Add new API key and copy the key; it is shown once.
Permissions used
Katana API keys have no scopes: a key can read and write everything in the factory account.
| Access | Operations |
|---|---|
| Read | listManufacturingOrders, getManufacturingOrder, listManufacturingOrderIngredients, listManufacturingOrderOperations, listManufacturingOrderProductions, listBomRows, listVariants, listLocations |
| Write | createManufacturingOrder, updateManufacturingOrder, createMakeToOrderManufacturingOrder, updateManufacturingOrderIngredient, updateManufacturingOrderOperation, createManufacturingOrderProduction |
Common errors
| Code | Meaning | Fix |
|---|---|---|
| 401 | Missing, mistyped or deleted key | Create a new key under Settings > API and update the credential. |
| 403 | Plan without API access | Upgrade to a plan that includes the API. |
| 422 / 400 | Body failed validation (unknown variant_id or location_id, quantity above what is left) | Look up ids with listVariants and listLocations, and read the order with getManufacturingOrder first. |
| 429 | More than 60 requests per 60 seconds | Wait for the Retry-After seconds, then retry. |
Store the key as a VX Agents credential (bearer token) so it is never pasted into chat.
Usage guide
Setup
Add your Katana API key as a bearer credential (Katana Settings > API > Add new API key; Professional plan or higher). If you make everything in one factory, pin its location_id (from listLocations with manufacturing_allowed=true) so new orders always land there.
Run a production day
listManufacturingOrderswithstatus(NOT_STARTED,BLOCKED,IN_PROGRESS,PARTIALLY_COMPLETED,DONE) andlocation_idto see the queue;getManufacturingOrderfor one order's planned vs actual quantity andproduction_deadline_date.listManufacturingOrderIngredientswithmanufacturing_order_id;ingredient_availabilityshows which materials are missing (the usual reason an order isBLOCKED).listManufacturingOrderOperationswithmanufacturing_order_idlists the steps;updateManufacturingOrderOperationsets a step'sstatus,total_actual_timeor operators.- When a batch is finished,
createManufacturingOrderProductionwithmanufacturing_order_idandcompleted_quantity(is_final: truecloses the order). Confirm the quantity with the user first: it moves stock. listManufacturingOrderProductionswithmanufacturing_order_idsshows what was already recorded.
Plan new work
listVariantswithskuturns a SKU into avariant_id;listBomRowswithproduct_variant_idshows its ingredients per unit.createManufacturingOrderwithvariant_id,planned_quantityandlocation_id(optionalproduction_deadline_date,additional_info).createMakeToOrderManufacturingOrderwith asales_order_row_idbuilds an order linked to that sales line (create_subassembliesfor nested products).updateManufacturingOrderchanges status, quantity, deadline or notes;updateManufacturingOrderIngredientchanges one ingredient's quantity. Confirm every create or update with the user before calling it: they change stock plans and costs.
Good to know
- Ids are integers. Dates are ISO 8601 UTC (
2026-10-24T09:00:00.000Z); filter lists withcreated_at_min/updated_at_min. - Lists paginate with
page(from 1) andlimit(default 50, max 250). - Rate limit: 60 requests per 60 seconds; on 429 wait for
Retry-Afterseconds. - Keys have no scopes, so a key can write everything: keep writes to what the user asked for.
Source: Katana API reference (https://developer.katanamrp.com/reference/getallmanufacturingorders), checked 2026-10-24.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Katana Manufacturing Orders & BOMs” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.