Inventory Management System MCP tools support products/SKUs, barcodes, warehouses and locations, Excel/CSV opening imports, real-time stock, stock movement ledgers, batch and expiry tracking, safety stock, low-stock alerts, sales velocity, replenishment suggestions, suppliers, purchase orders, receiving, warehouse transfers, mobile/offline stocktakes, returns and damaged goods, valuation, and audit logs.
inventory.config.get
readRead inventory units, costing method, barcode, offline sync, approval, warehouse permissions, and audit settings.
-
Read-only; returns settings by inventory/purchasing permission.
Must not expose costing permissions, warehouse permissions, or integration secrets.
inventory.warehouses.list
readList warehouses, stores, active state, owners, multi-warehouse sync, and permission scope.
inventory.config.get
Read-only; only returns warehouses visible to the user.
Prevents unauthorised cross-warehouse stock visibility.
inventory.locations.list
readRead warehouse locations, zones, put-away rules, pick paths, and availability.
inventory.warehouses.list
Read-only; warehouse staff permissions are scoped by warehouse.
Location permissions must prevent unauthorised transfers or stocktakes.
inventory.products.list
readList products by category, SKU, barcode, supplier, state, and batch-tracking flag.
inventory.config.get
Read-only; cost fields are masked by permission.
Do not show cost to users without purchasing/finance permission.
inventory.product.get
readRead one product, SKU, barcode, suppliers, cost, stock rules, batch and expiry settings.
inventory.products.list
Read-only; cost and supplier terms are role-scoped.
SKU, barcode and batch rules must remain consistent.
inventory.categories.list
readList product categories, stock attributes, default safety stock, and stocktake grouping.
inventory.config.get
Read-only; used for product setup and reporting.
Category changes must not distort historical reporting.
inventory.suppliers.list
readList suppliers, contacts, currencies, lead times, MOQ, status, and default payment terms.
inventory.config.get
Read-only; sensitive commercial terms may be masked.
Supplier prices and terms require purchasing permissions.
inventory.supplier_terms.list
readRead SKU supplier pricing, currency, exchange rate, lead time, MOQ, pack size, and quote history.
inventory.suppliers.list, inventory.products.list
Read-only; purchasing and management can see full terms.
Avoid leaking supplier cost into sales or customer workflows.
inventory.barcodes.list
readList SKUs, barcodes, alternate barcodes, carton codes, scanner compatibility, and duplicate risks.
inventory.products.list
Read-only; used for barcode stock movements and stocktakes.
Barcodes must be unique to prevent scanning the wrong item.
inventory.stock_levels.list
readList on-hand, available, reserved, in-transit, and safety stock by warehouse, location, SKU, and batch.
inventory.warehouses.list, inventory.products.list
Read-only; scoped by warehouse permission.
Available stock must deduct reservations and open transfers.
inventory.stock_ledger.list
readList ledgers for receiving, dispatch, transfers, stocktake variances, returns, damage, reservations, and releases.
inventory.stock_levels.list
Read-only; ledger cannot be directly edited.
Ledger should be immutable and corrected only through reversal movements.
inventory.batches_expiry.list
readList batches, receiving date, expiry date, location, quantity, expiry alerts, and traceability state.
inventory.product.get, inventory.stock_levels.list
Read-only; food/expiry-sensitive goods require batch tracking.
Must not ignore expiring batches or wrong FIFO/FEFO handling.
inventory.safety_stock_rules.list
readRead SKU/warehouse safety stock, reorder points, max stock, supplier lead time, and alert channels.
inventory.products.list, inventory.warehouses.list
Read-only; used for low-stock alerts and replenishment suggestions.
Wrong safety stock rules can cause stockouts or overstock.
inventory.low_stock_alerts.list
readList low stock, shortage risk, expiry risk, WhatsApp/email alerts, and handling state.
inventory.stock_levels.list, inventory.safety_stock_rules.list
Read-only; alerts do not equal automatic purchasing.
AI may suggest replenishment but cannot create purchases without approval.
inventory.sales_velocity.get
readRead SKU sales velocity, consumption rate, seasonality, average daily sales, and days of cover.
inventory.stock_levels.list
Read-only; used for replenishment calculation.
Must state data source and analysis period to avoid bad forecasts.
inventory.reorder_suggestions.list
readList suggested reorder SKUs, quantities, suppliers, estimated amount, lead time, stockout date, and rationale.
inventory.sales_velocity.get, inventory.supplier_terms.list
Read-only; purchase creation needs preview and approval.
Suggestions must show calculation basis and cannot create black-box purchases.
inventory.purchase_orders.list
readList purchase orders, supplier, currency, amount, approval, sending, receiving, and ETA.
inventory.suppliers.list
Read-only; amount and cost are scoped by purchasing permission.
Purchase amounts and supplier terms are sensitive data.
inventory.goods_receipts.list
readList goods receipts, purchase link, receiving variance, batch, expiry, location, and stock-in state.
inventory.purchase_orders.list
Read-only; used for receiving and variance approval.
Unapproved variances must not directly close purchase orders.
inventory.transfers.list
readList transfers, source/destination warehouse, in-transit quantity, shipment, receipt, variance, and state.
inventory.warehouses.list, inventory.stock_levels.list
Read-only; scoped by source and destination warehouse permissions.
In-transit stock must not be counted as available twice.
inventory.stocktakes.list
readList stocktake tasks, warehouse, locations, scan progress, offline sync, variances, and approval state.
inventory.warehouses.list
Read-only; stocktake results affect stock only after submission.
Stocktake variances must not write ledger without approval.
inventory.adjustments.list
readList stock adjustments, reasons, evidence, valuation impact, approver, and ledger.
inventory.stock_ledger.list
Read-only; high-value or large variances need management visibility.
Adjustment reasons and evidence must be audit-retained.
inventory.reservations.list
readList stock reservations for orders or internal workflows, expiry, release, and availability impact.
inventory.stock_levels.list
Read-only; reservation source must be traceable.
Reservations must not lock stock forever and need expiry/release.
inventory.returns_damage.list
readList returns, damage, write-offs, restock, quarantine locations, reasons, and approval state.
inventory.stock_ledger.list
Read-only; write-off and restock need approval.
Damaged/expired goods must not return to sellable stock without review.
inventory.import_jobs.list
readList Excel/CSV product, SKU, supplier, and opening stock import jobs, errors, and completion state.
inventory.config.get
Read-only; used for setup and bulk update tracking.
Imports must prevent duplicate SKUs, barcodes, and wrong opening stock.
inventory.valuation_report.get
readRead inventory valuation, cost, multi-currency conversion, slow-moving, dead stock, expiry, and variance summary.
inventory.stock_levels.list, inventory.supplier_terms.list
Read-only; cost and valuation are limited to purchasing/finance/management.
Costing method changes must not silently affect financial reports.
inventory.audit_logs.list
readList audit logs for products, purchasing, receiving, movements, transfers, stocktakes, adjustments, offline sync, and costing.
inventory.config.get
Read-only; audit cannot be edited by normal users.
Every stock-changing action must be traceable.
inventory.import.preview
previewPreview imported products, SKUs, barcodes, suppliers, opening stock, duplicates, and error rows.
inventory.import_jobs.list, inventory.barcodes.list
Preview only; mapping must be confirmed before bulk import.
Prevents bad Excel rows from overwriting real SKUs or stock.
inventory.purchase_order.preview
previewPreview PO SKUs, supplier, MOQ, currency, amount, lead time, low-stock rationale, and approval chain.
inventory.reorder_suggestions.list, inventory.supplier_terms.list
Purchasing owner must confirm before PO creation.
Prevents AI from placing orders without approval.
inventory.receiving.preview
previewPreview receiving variance, batch, expiry, location, cost, in-transit conversion, and stock-in ledger.
inventory.purchase_orders.list, inventory.goods_receipts.list
Variance or cost changes require approval.
Prevents wrong receiving from corrupting stock and cost.
inventory.transfer.preview
previewPreview transfer source, destination, availability, in-transit state, shipment batches, and variance handling.
inventory.stock_levels.list, inventory.transfers.list
Transfer needs source and destination warehouse permission confirmation.
Avoid wrong source deduction or duplicate destination receipt.
inventory.stocktake_variance.preview
previewPreview stocktake variances, missed scans, offline conflicts, suggested adjustments, value impact, and approval needs.
inventory.stocktakes.list, inventory.stock_levels.list
Warehouse lead approval required before submitting variances.
Stocktake variance must not auto-change ledger.
inventory.adjustment.preview
previewPreview adjustment reason, quantity, location, batch, cost impact, evidence, and approval chain.
inventory.adjustments.list, inventory.stock_levels.list
Final adjustment requires approval by value/quantity threshold.
High-risk adjustments require evidence and dual review.
inventory.reorder_plan.preview
previewPreview reorder plan, suggested quantity, supplier, amount, stockout date, warehouse allocation, and overstock risk.
inventory.reorder_suggestions.list
Human approval required before official purchasing.
Avoid over-purchasing based only on sales velocity.
inventory.offline_sync.preview
previewPreview offline mobile scan movements, stocktakes, transfers, conflicts, duplicate submissions, and time gaps.
inventory.stock_ledger.list, inventory.stocktakes.list
Conflicting records require warehouse lead confirmation before writing.
Prevents duplicate offline sync from doubling or deducting stock wrongly.
inventory.product.upsert
writeCreate or update products, SKUs, categories, suppliers, cost, batch/expiry, and stock rules.
inventory.product.get, inventory.import.preview
Cost, batch rules, or bulk product updates require approval.
SKU and barcode must be unique; cost is permission-scoped.
inventory.import_job.create
writeCreate Excel/CSV import jobs for products, SKUs, suppliers, and opening stock.
inventory.import.preview
Requires confirmed import preview.
Imports must not overwrite live stock without review.
inventory.supplier.upsert
writeCreate or update suppliers, contacts, currency, lead time, MOQ, pricing, and payment terms.
inventory.suppliers.list, inventory.supplier_terms.list
Price or payment term changes require purchasing/management approval.
Supplier terms are commercially sensitive.
inventory.warehouse.upsert
writeCreate or update warehouses, stores, permissions, sync state, and stock movement eligibility.
inventory.warehouses.list
New or disabled warehouses require admin approval.
Before disabling a warehouse, check stock and open documents.
inventory.location.upsert
writeCreate or update locations, zones, pick/put-away rules, capacity, and quarantine flag.
inventory.locations.list
Location changes affecting existing stock require warehouse lead approval.
Avoid mixing sellable goods with quarantine/damaged goods.
inventory.barcode.assign
writeAssign, update, or disable barcodes for SKUs or carton units.
inventory.barcodes.list, inventory.product.get
Reusing or changing existing barcodes requires approval.
Prevents barcode collision and wrong-item scans.
inventory.safety_stock_rule.upsert
writeCreate or update SKU/warehouse safety stock, reorder point, max stock, alert channels, and supplier lead time.
inventory.safety_stock_rules.list, inventory.reorder_plan.preview
Bulk or high-value SKU rule changes require purchasing/inventory lead approval.
Wrong rules can cause stockout or overstock.
inventory.purchase_order.create
writeCreate purchase order drafts from reorder plans or manual input.
inventory.purchase_order.preview
Created POs still require approval by amount.
Must not send to suppliers without approval.
inventory.purchase_order.approve
writeApprove PO amount, supplier, SKUs, quantities, currency, and lead time.
inventory.purchase_order.preview, inventory.purchase_orders.list
Only designated purchasing/management approvers may approve.
Prevents over-authority or wrong-price purchasing.
inventory.purchase_order.send
writeSend approved purchase orders to suppliers and record channel and version.
inventory.purchase_orders.list
Only approved versions may be sent.
Prevents sending wrong version, wrong supplier, or wrong currency.
inventory.goods_receipt.record
writeRecord receiving, batch, expiry, location, variance, cost, and stock-in ledger.
inventory.receiving.preview
Variance or cost change requires approval.
Receiving changes stock and valuation and needs complete audit.
inventory.transfer.create
writeCreate transfer drafts with source, destination, SKUs, batches, and quantities.
inventory.transfer.preview
Requires source warehouse availability and permission confirmation.
Prevents transferring more than available stock.
inventory.transfer.ship
writeMark transfer as shipped, deduct source warehouse, and create in-transit stock.
inventory.transfers.list, inventory.transfer.preview
Shipment requires warehouse permission or lead approval.
Must prevent duplicate shipment for the same transfer.
inventory.transfer.receive
writeReceive at destination, handle variance, damage, batch, location, and complete transfer ledger.
inventory.transfers.list, inventory.transfer.preview
Variance receiving requires lead approval.
Prevents duplicate destination receipt or ignored variance.
inventory.stocktake.create
writeCreate stocktake tasks with warehouse, locations, SKU scope, assignees, and offline permission.
inventory.stocktakes.list, inventory.locations.list
Large or stock-freeze stocktakes require lead approval.
During stocktake, stock movement freeze or conflicts need clear handling.
inventory.stocktake.submit
writeSubmit count results, scan records, offline sync and variances, pending approval before adjustment.
inventory.stocktake_variance.preview
Variances require warehouse lead or management approval.
Submission should not immediately change stock unless approval rules allow.
inventory.adjustment.create
writeCreate adjustment ledgers for overage, shortage, damage, write-off, or management adjustment.
inventory.adjustment.preview
Approval is based on quantity, value, and reason.
All adjustments need reason, evidence, approval, and audit.
inventory.reservation.create
writeCreate stock reservations for orders, transfers, or internal workflows and update availability.
inventory.stock_levels.list, inventory.reservations.list
Requires source document and expiry.
Prevents stock being locked indefinitely without source.
inventory.reservation.release
writeRelease stock reservations, restore availability, and retain source and reason.
inventory.reservations.list
Can be triggered by source document completion/cancellation; manual release needs permission.
Prevents releasing wrong reservations and causing oversell.
inventory.return_damage.record
writeRecord returns, damage, quarantine, restock, write-off, and related stock ledgers.
inventory.returns_damage.list, inventory.adjustment.preview
Write-off, restock, or high-value damage needs approval.
Damaged/expired goods must not directly become sellable.
inventory.action_request.status
statusCheck preview, approval, execution, failure, rollback, and audit state for inventory writes.
inventory.audit_logs.list
Read-only status; cannot force approval through this endpoint.
Inventory and purchasing approvals must be traceable and cannot be self-edited by requesters.