Inventory Management System MCP Tools

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.

Back to MCP Menu View Product Page

inventory.config.get

read

Read inventory units, costing method, barcode, offline sync, approval, warehouse permissions, and audit settings.

Read first

Governance

Read-only; returns settings by inventory/purchasing permission.

Safety

Must not expose costing permissions, warehouse permissions, or integration secrets.

inventory.warehouses.list

read

List warehouses, stores, active state, owners, multi-warehouse sync, and permission scope.

Read first

inventory.config.get

Governance

Read-only; only returns warehouses visible to the user.

Safety

Prevents unauthorised cross-warehouse stock visibility.

inventory.locations.list

read

Read warehouse locations, zones, put-away rules, pick paths, and availability.

Read first

inventory.warehouses.list

Governance

Read-only; warehouse staff permissions are scoped by warehouse.

Safety

Location permissions must prevent unauthorised transfers or stocktakes.

inventory.products.list

read

List products by category, SKU, barcode, supplier, state, and batch-tracking flag.

Read first

inventory.config.get

Governance

Read-only; cost fields are masked by permission.

Safety

Do not show cost to users without purchasing/finance permission.

inventory.product.get

read

Read one product, SKU, barcode, suppliers, cost, stock rules, batch and expiry settings.

Read first

inventory.products.list

Governance

Read-only; cost and supplier terms are role-scoped.

Safety

SKU, barcode and batch rules must remain consistent.

inventory.categories.list

read

List product categories, stock attributes, default safety stock, and stocktake grouping.

Read first

inventory.config.get

Governance

Read-only; used for product setup and reporting.

Safety

Category changes must not distort historical reporting.

inventory.suppliers.list

read

List suppliers, contacts, currencies, lead times, MOQ, status, and default payment terms.

Read first

inventory.config.get

Governance

Read-only; sensitive commercial terms may be masked.

Safety

Supplier prices and terms require purchasing permissions.

inventory.supplier_terms.list

read

Read SKU supplier pricing, currency, exchange rate, lead time, MOQ, pack size, and quote history.

Read first

inventory.suppliers.list, inventory.products.list

Governance

Read-only; purchasing and management can see full terms.

Safety

Avoid leaking supplier cost into sales or customer workflows.

inventory.barcodes.list

read

List SKUs, barcodes, alternate barcodes, carton codes, scanner compatibility, and duplicate risks.

Read first

inventory.products.list

Governance

Read-only; used for barcode stock movements and stocktakes.

Safety

Barcodes must be unique to prevent scanning the wrong item.

inventory.stock_levels.list

read

List on-hand, available, reserved, in-transit, and safety stock by warehouse, location, SKU, and batch.

Read first

inventory.warehouses.list, inventory.products.list

Governance

Read-only; scoped by warehouse permission.

Safety

Available stock must deduct reservations and open transfers.

inventory.stock_ledger.list

read

List ledgers for receiving, dispatch, transfers, stocktake variances, returns, damage, reservations, and releases.

Read first

inventory.stock_levels.list

Governance

Read-only; ledger cannot be directly edited.

Safety

Ledger should be immutable and corrected only through reversal movements.

inventory.batches_expiry.list

read

List batches, receiving date, expiry date, location, quantity, expiry alerts, and traceability state.

Read first

inventory.product.get, inventory.stock_levels.list

Governance

Read-only; food/expiry-sensitive goods require batch tracking.

Safety

Must not ignore expiring batches or wrong FIFO/FEFO handling.

inventory.safety_stock_rules.list

read

Read SKU/warehouse safety stock, reorder points, max stock, supplier lead time, and alert channels.

Read first

inventory.products.list, inventory.warehouses.list

Governance

Read-only; used for low-stock alerts and replenishment suggestions.

Safety

Wrong safety stock rules can cause stockouts or overstock.

inventory.low_stock_alerts.list

read

List low stock, shortage risk, expiry risk, WhatsApp/email alerts, and handling state.

Read first

inventory.stock_levels.list, inventory.safety_stock_rules.list

Governance

Read-only; alerts do not equal automatic purchasing.

Safety

AI may suggest replenishment but cannot create purchases without approval.

inventory.sales_velocity.get

read

Read SKU sales velocity, consumption rate, seasonality, average daily sales, and days of cover.

Read first

inventory.stock_levels.list

Governance

Read-only; used for replenishment calculation.

Safety

Must state data source and analysis period to avoid bad forecasts.

inventory.reorder_suggestions.list

read

List suggested reorder SKUs, quantities, suppliers, estimated amount, lead time, stockout date, and rationale.

Read first

inventory.sales_velocity.get, inventory.supplier_terms.list

Governance

Read-only; purchase creation needs preview and approval.

Safety

Suggestions must show calculation basis and cannot create black-box purchases.

inventory.purchase_orders.list

read

List purchase orders, supplier, currency, amount, approval, sending, receiving, and ETA.

Read first

inventory.suppliers.list

Governance

Read-only; amount and cost are scoped by purchasing permission.

Safety

Purchase amounts and supplier terms are sensitive data.

inventory.goods_receipts.list

read

List goods receipts, purchase link, receiving variance, batch, expiry, location, and stock-in state.

Read first

inventory.purchase_orders.list

Governance

Read-only; used for receiving and variance approval.

Safety

Unapproved variances must not directly close purchase orders.

inventory.transfers.list

read

List transfers, source/destination warehouse, in-transit quantity, shipment, receipt, variance, and state.

Read first

inventory.warehouses.list, inventory.stock_levels.list

Governance

Read-only; scoped by source and destination warehouse permissions.

Safety

In-transit stock must not be counted as available twice.

inventory.stocktakes.list

read

List stocktake tasks, warehouse, locations, scan progress, offline sync, variances, and approval state.

Read first

inventory.warehouses.list

Governance

Read-only; stocktake results affect stock only after submission.

Safety

Stocktake variances must not write ledger without approval.

inventory.adjustments.list

read

List stock adjustments, reasons, evidence, valuation impact, approver, and ledger.

Read first

inventory.stock_ledger.list

Governance

Read-only; high-value or large variances need management visibility.

Safety

Adjustment reasons and evidence must be audit-retained.

inventory.reservations.list

read

List stock reservations for orders or internal workflows, expiry, release, and availability impact.

Read first

inventory.stock_levels.list

Governance

Read-only; reservation source must be traceable.

Safety

Reservations must not lock stock forever and need expiry/release.

inventory.returns_damage.list

read

List returns, damage, write-offs, restock, quarantine locations, reasons, and approval state.

Read first

inventory.stock_ledger.list

Governance

Read-only; write-off and restock need approval.

Safety

Damaged/expired goods must not return to sellable stock without review.

inventory.import_jobs.list

read

List Excel/CSV product, SKU, supplier, and opening stock import jobs, errors, and completion state.

Read first

inventory.config.get

Governance

Read-only; used for setup and bulk update tracking.

Safety

Imports must prevent duplicate SKUs, barcodes, and wrong opening stock.

inventory.valuation_report.get

read

Read inventory valuation, cost, multi-currency conversion, slow-moving, dead stock, expiry, and variance summary.

Read first

inventory.stock_levels.list, inventory.supplier_terms.list

Governance

Read-only; cost and valuation are limited to purchasing/finance/management.

Safety

Costing method changes must not silently affect financial reports.

inventory.audit_logs.list

read

List audit logs for products, purchasing, receiving, movements, transfers, stocktakes, adjustments, offline sync, and costing.

Read first

inventory.config.get

Governance

Read-only; audit cannot be edited by normal users.

Safety

Every stock-changing action must be traceable.

inventory.import.preview

preview

Preview imported products, SKUs, barcodes, suppliers, opening stock, duplicates, and error rows.

Read first

inventory.import_jobs.list, inventory.barcodes.list

Governance

Preview only; mapping must be confirmed before bulk import.

Safety

Prevents bad Excel rows from overwriting real SKUs or stock.

inventory.purchase_order.preview

preview

Preview PO SKUs, supplier, MOQ, currency, amount, lead time, low-stock rationale, and approval chain.

Read first

inventory.reorder_suggestions.list, inventory.supplier_terms.list

Governance

Purchasing owner must confirm before PO creation.

Safety

Prevents AI from placing orders without approval.

inventory.receiving.preview

preview

Preview receiving variance, batch, expiry, location, cost, in-transit conversion, and stock-in ledger.

Read first

inventory.purchase_orders.list, inventory.goods_receipts.list

Governance

Variance or cost changes require approval.

Safety

Prevents wrong receiving from corrupting stock and cost.

inventory.transfer.preview

preview

Preview transfer source, destination, availability, in-transit state, shipment batches, and variance handling.

Read first

inventory.stock_levels.list, inventory.transfers.list

Governance

Transfer needs source and destination warehouse permission confirmation.

Safety

Avoid wrong source deduction or duplicate destination receipt.

inventory.stocktake_variance.preview

preview

Preview stocktake variances, missed scans, offline conflicts, suggested adjustments, value impact, and approval needs.

Read first

inventory.stocktakes.list, inventory.stock_levels.list

Governance

Warehouse lead approval required before submitting variances.

Safety

Stocktake variance must not auto-change ledger.

inventory.adjustment.preview

preview

Preview adjustment reason, quantity, location, batch, cost impact, evidence, and approval chain.

Read first

inventory.adjustments.list, inventory.stock_levels.list

Governance

Final adjustment requires approval by value/quantity threshold.

Safety

High-risk adjustments require evidence and dual review.

inventory.reorder_plan.preview

preview

Preview reorder plan, suggested quantity, supplier, amount, stockout date, warehouse allocation, and overstock risk.

Read first

inventory.reorder_suggestions.list

Governance

Human approval required before official purchasing.

Safety

Avoid over-purchasing based only on sales velocity.

inventory.offline_sync.preview

preview

Preview offline mobile scan movements, stocktakes, transfers, conflicts, duplicate submissions, and time gaps.

Read first

inventory.stock_ledger.list, inventory.stocktakes.list

Governance

Conflicting records require warehouse lead confirmation before writing.

Safety

Prevents duplicate offline sync from doubling or deducting stock wrongly.

inventory.product.upsert

write

Create or update products, SKUs, categories, suppliers, cost, batch/expiry, and stock rules.

Read first

inventory.product.get, inventory.import.preview

Governance

Cost, batch rules, or bulk product updates require approval.

Safety

SKU and barcode must be unique; cost is permission-scoped.

inventory.import_job.create

write

Create Excel/CSV import jobs for products, SKUs, suppliers, and opening stock.

Read first

inventory.import.preview

Governance

Requires confirmed import preview.

Safety

Imports must not overwrite live stock without review.

inventory.supplier.upsert

write

Create or update suppliers, contacts, currency, lead time, MOQ, pricing, and payment terms.

Read first

inventory.suppliers.list, inventory.supplier_terms.list

Governance

Price or payment term changes require purchasing/management approval.

Safety

Supplier terms are commercially sensitive.

inventory.warehouse.upsert

write

Create or update warehouses, stores, permissions, sync state, and stock movement eligibility.

Read first

inventory.warehouses.list

Governance

New or disabled warehouses require admin approval.

Safety

Before disabling a warehouse, check stock and open documents.

inventory.location.upsert

write

Create or update locations, zones, pick/put-away rules, capacity, and quarantine flag.

Read first

inventory.locations.list

Governance

Location changes affecting existing stock require warehouse lead approval.

Safety

Avoid mixing sellable goods with quarantine/damaged goods.

inventory.barcode.assign

write

Assign, update, or disable barcodes for SKUs or carton units.

Read first

inventory.barcodes.list, inventory.product.get

Governance

Reusing or changing existing barcodes requires approval.

Safety

Prevents barcode collision and wrong-item scans.

inventory.safety_stock_rule.upsert

write

Create or update SKU/warehouse safety stock, reorder point, max stock, alert channels, and supplier lead time.

Read first

inventory.safety_stock_rules.list, inventory.reorder_plan.preview

Governance

Bulk or high-value SKU rule changes require purchasing/inventory lead approval.

Safety

Wrong rules can cause stockout or overstock.

inventory.purchase_order.create

write

Create purchase order drafts from reorder plans or manual input.

Read first

inventory.purchase_order.preview

Governance

Created POs still require approval by amount.

Safety

Must not send to suppliers without approval.

inventory.purchase_order.approve

write

Approve PO amount, supplier, SKUs, quantities, currency, and lead time.

Read first

inventory.purchase_order.preview, inventory.purchase_orders.list

Governance

Only designated purchasing/management approvers may approve.

Safety

Prevents over-authority or wrong-price purchasing.

inventory.purchase_order.send

write

Send approved purchase orders to suppliers and record channel and version.

Read first

inventory.purchase_orders.list

Governance

Only approved versions may be sent.

Safety

Prevents sending wrong version, wrong supplier, or wrong currency.

inventory.goods_receipt.record

write

Record receiving, batch, expiry, location, variance, cost, and stock-in ledger.

Read first

inventory.receiving.preview

Governance

Variance or cost change requires approval.

Safety

Receiving changes stock and valuation and needs complete audit.

inventory.transfer.create

write

Create transfer drafts with source, destination, SKUs, batches, and quantities.

Read first

inventory.transfer.preview

Governance

Requires source warehouse availability and permission confirmation.

Safety

Prevents transferring more than available stock.

inventory.transfer.ship

write

Mark transfer as shipped, deduct source warehouse, and create in-transit stock.

Read first

inventory.transfers.list, inventory.transfer.preview

Governance

Shipment requires warehouse permission or lead approval.

Safety

Must prevent duplicate shipment for the same transfer.

inventory.transfer.receive

write

Receive at destination, handle variance, damage, batch, location, and complete transfer ledger.

Read first

inventory.transfers.list, inventory.transfer.preview

Governance

Variance receiving requires lead approval.

Safety

Prevents duplicate destination receipt or ignored variance.

inventory.stocktake.create

write

Create stocktake tasks with warehouse, locations, SKU scope, assignees, and offline permission.

Read first

inventory.stocktakes.list, inventory.locations.list

Governance

Large or stock-freeze stocktakes require lead approval.

Safety

During stocktake, stock movement freeze or conflicts need clear handling.

inventory.stocktake.submit

write

Submit count results, scan records, offline sync and variances, pending approval before adjustment.

Read first

inventory.stocktake_variance.preview

Governance

Variances require warehouse lead or management approval.

Safety

Submission should not immediately change stock unless approval rules allow.

inventory.adjustment.create

write

Create adjustment ledgers for overage, shortage, damage, write-off, or management adjustment.

Read first

inventory.adjustment.preview

Governance

Approval is based on quantity, value, and reason.

Safety

All adjustments need reason, evidence, approval, and audit.

inventory.reservation.create

write

Create stock reservations for orders, transfers, or internal workflows and update availability.

Read first

inventory.stock_levels.list, inventory.reservations.list

Governance

Requires source document and expiry.

Safety

Prevents stock being locked indefinitely without source.

inventory.reservation.release

write

Release stock reservations, restore availability, and retain source and reason.

Read first

inventory.reservations.list

Governance

Can be triggered by source document completion/cancellation; manual release needs permission.

Safety

Prevents releasing wrong reservations and causing oversell.

inventory.return_damage.record

write

Record returns, damage, quarantine, restock, write-off, and related stock ledgers.

Read first

inventory.returns_damage.list, inventory.adjustment.preview

Governance

Write-off, restock, or high-value damage needs approval.

Safety

Damaged/expired goods must not directly become sellable.

inventory.action_request.status

status

Check preview, approval, execution, failure, rollback, and audit state for inventory writes.

Read first

inventory.audit_logs.list

Governance

Read-only status; cannot force approval through this endpoint.

Safety

Inventory and purchasing approvals must be traceable and cannot be self-edited by requesters.