Food Wholesale System MCP tools support wholesale customers, customer-specific price lists, food products, batch and expiry tracking, cold-chain rules, sellable stock, cut-off windows, order validation, FEFO lot allocation, backorders, pick lists, delivery routes, delivery execution, invoice batches, collections, returns and claims, recall traceability, margin and wastage reporting, and audit logs.
food_wholesale.config.get
readRead tenant-level food wholesale settings for temperature bands, cut-offs, payment, approval, delivery, and recall rules.
Read first
-
Governance
No approval required; read-only configuration lookup.
Safety
Return tenant-scoped configuration only; hide integration secrets and internal credential values.
food_wholesale.customers.list
readList wholesale customers by status, customer group, delivery district, payment terms, or sales owner.
Read first
food_wholesale.config.get
Governance
No approval required; read-only customer lookup.
Safety
Restrict to permitted customer accounts and redact private contacts when caller lacks permission.
food_wholesale.customer.get
readRead one customer profile, terms, credit limit, delivery preferences, price lists, and outstanding balance summary.
Read first
food_wholesale.customers.list
Governance
No approval required; read-only customer detail.
Safety
Do not expose credit, balance, or personal contact fields across tenant or permission boundaries.
food_wholesale.customer_price_lists.list
readList customer-specific price lists, discounts, MOQ, effective dates, and pending price changes.
Read first
food_wholesale.customer.get
Governance
No approval required; read-only pricing lookup.
Safety
Pricing is commercially sensitive; scope by customer and caller role.
food_wholesale.products.list
readList food products by category, supplier, temperature band, sellable status, pack size, or shelf-life rule.
Read first
food_wholesale.config.get
Governance
No approval required; read-only product lookup.
Safety
Return public product and operational fields only unless caller can view costing.
food_wholesale.product.get
readRead one food SKU, pack size, unit conversion, handling requirements, allergen/handling notes, and cost visibility summary.
Read first
food_wholesale.products.list
Governance
No approval required; read-only product detail.
Safety
Cost, supplier, and allergen data must follow role permissions and audit read access where required.
food_wholesale.batches_expiry.list
readList batch stock by product, warehouse, lot, expiry date, quarantine state, or recall state.
Read first
food_wholesale.product.get
Governance
No approval required; read-only lot and expiry lookup.
Safety
Separate sellable, reserved, quarantined, expired, damaged, and recalled quantities clearly.
food_wholesale.cold_chain_rules.list
readList temperature bands, delivery ranges, allowed deviations, and exception handling rules.
Read first
food_wholesale.config.get
Governance
No approval required; read-only cold-chain rule lookup.
Safety
Do not treat missing temperature rules as safe; surface incomplete setup explicitly.
food_wholesale.stock_levels.list
readRead sellable, reserved, backordered, and quarantined quantities by product, warehouse, lot, and expiry date.
Read first
food_wholesale.products.list, food_wholesale.batches_expiry.list
Governance
No approval required; read-only stock lookup.
Safety
Stock figures must be time-stamped to prevent stale allocation decisions.
food_wholesale.cutoff_windows.list
readList order cut-off windows by delivery date, district, customer group, and temperature band.
Read first
food_wholesale.config.get, food_wholesale.customer.get
Governance
No approval required; read-only cut-off lookup.
Safety
Flag orders outside cut-off instead of silently accepting late operational changes.
food_wholesale.orders.list
readList orders by customer, delivery date, cut-off batch, state, temperature band, or backorder condition.
Read first
food_wholesale.customers.list
Governance
No approval required; read-only order lookup.
Safety
Respect customer/account permissions and avoid exposing unrelated customer order values.
food_wholesale.order.get
readRead order lines, customer pricing, lot allocation, backorders, delivery requirements, invoice, and collection links.
Read first
food_wholesale.orders.list
Governance
No approval required; read-only order detail.
Safety
Show price source, stock timestamp, and allocation state to prevent hidden order drift.
food_wholesale.backorders.list
readList backordered lines by customer, product, lot, replenishment date, substitute, and pending confirmation.
Read first
food_wholesale.orders.list, food_wholesale.stock_levels.list
Governance
No approval required; read-only backorder lookup.
Safety
Do not promise replenishment dates unless source status is confirmed.
food_wholesale.allocation_plan.get
readRead FEFO lot allocation suggestions and alternatives for an order or cut-off batch.
Read first
food_wholesale.order.get, food_wholesale.stock_levels.list
Governance
No approval required; read-only allocation plan.
Safety
Mark any manual lot override, short shelf-life risk, or recall/quarantine conflict.
food_wholesale.pick_lists.list
readList pick lists by delivery date, route, temperature band, warehouse, or status.
Read first
food_wholesale.orders.list, food_wholesale.allocation_plan.get
Governance
No approval required; read-only pick list lookup.
Safety
Pick lists must include lot and expiry data when food traceability is required.
food_wholesale.delivery_routes.list
readList delivery routes, districts, vehicle capacity, temperature capability, drivers, and time windows.
Read first
food_wholesale.config.get
Governance
No approval required; read-only route lookup.
Safety
Route capacity and temperature capability must be validated before route assignment writes.
food_wholesale.delivery_runs.list
readList delivery runs by date, route, driver, vehicle, state, or temperature exception.
Read first
food_wholesale.delivery_routes.list
Governance
No approval required; read-only delivery run lookup.
Safety
Do not expose driver private details beyond operational need.
food_wholesale.invoices.list
readList invoices by customer, order, delivery date, statement cycle, payment state, or overdue state.
Read first
food_wholesale.customer.get, food_wholesale.orders.list
Governance
No approval required; read-only invoice lookup.
Safety
Invoice visibility must follow finance permissions and customer account scope.
food_wholesale.collections.list
readList collections, partial payments, reconciliations, overdue reminders, and unapplied receipts.
Read first
food_wholesale.invoices.list
Governance
No approval required; read-only collection lookup.
Safety
Payment references and bank data must be redacted unless finance role permits access.
food_wholesale.returns_claims.list
readList claims for short delivery, wrong item, damage, expiry, temperature breach, or returned goods.
Read first
food_wholesale.orders.list, food_wholesale.delivery_runs.list
Governance
No approval required; read-only claim lookup.
Safety
Keep claim evidence files scoped to the related customer, delivery, and finance roles.
food_wholesale.recall_trace.get
readTrace affected orders, customers, deliveries, invoices, returns, and notification state by product lot.
Read first
food_wholesale.batches_expiry.list, food_wholesale.orders.list
Governance
No approval required for preview trace; recall action writes require approval.
Safety
Recall trace must include confidence/source timestamps and never omit quarantined or returned quantities.
food_wholesale.margin_report.get
readRead margin, wastage, expiry risk, and shortage summary by customer, product, lot, route, or period.
Read first
food_wholesale.orders.list, food_wholesale.collections.list
Governance
No approval required; read-only report.
Safety
Cost and margin fields require management or finance permissions.
food_wholesale.audit_logs.list
readList audit logs for pricing, orders, lots, delivery, collections, returns, recalls, and notifications.
Read first
food_wholesale.config.get
Governance
No approval required for authorized auditors; read-only audit lookup.
Safety
Audit logs are immutable and must include actor, source, approval id, before/after, and execution result.
food_wholesale.order_check.preview
previewPreview whether a new or updated order violates pricing, MOQ, credit limit, cut-off, stock, or delivery rules.
Read first
food_wholesale.customer.get, food_wholesale.customer_price_lists.list, food_wholesale.stock_levels.list, food_wholesale.cutoff_windows.list
Governance
No approval required; preview only and does not persist the order.
Safety
Return blocking reasons and warnings separately so operators do not treat risky orders as approved.
food_wholesale.allocation.preview
previewPreview FEFO allocation, shortage, substitutions, short shelf-life risks, and quarantine conflicts for orders or batches.
Read first
food_wholesale.order.get, food_wholesale.batches_expiry.list, food_wholesale.stock_levels.list
Governance
No approval required; preview only and does not reserve stock.
Safety
Do not reduce stock or reserve lots during preview; include stock timestamp.
food_wholesale.route_plan.preview
previewPreview route capacity, time windows, temperature compatibility, cost, and late-delivery risk.
Read first
food_wholesale.delivery_routes.list, food_wholesale.orders.list, food_wholesale.pick_lists.list
Governance
No approval required; preview only and does not assign routes.
Safety
Flag vehicle capacity and temperature mismatches as blockers, not soft notes.
food_wholesale.invoice_batch.preview
previewPreview invoice batch amounts, tax, discounts, and exceptions by delivery, order, or statement cycle.
Read first
food_wholesale.orders.list, food_wholesale.invoices.list, food_wholesale.collections.list
Governance
No approval required; preview only and does not create invoices.
Safety
Show already-invoiced lines and missing delivery completion before invoice creation.
food_wholesale.price_change.preview
previewPreview price change impact on customers, unconfirmed orders, margin, MOQ, and effective dates.
Read first
food_wholesale.customer_price_lists.list, food_wholesale.orders.list, food_wholesale.margin_report.get
Governance
No approval required for preview; applying price changes requires approval.
Safety
Do not alter active prices during preview; report affected customers and orders explicitly.
food_wholesale.recall_impact.preview
previewPreview affected stock, orders, customers, deliveries, invoices, notifications, and substitute handling for a lot recall.
Read first
food_wholesale.recall_trace.get, food_wholesale.stock_levels.list, food_wholesale.delivery_runs.list
Governance
No approval required for preview; recall case creation requires approval.
Safety
Include confidence and completeness indicators; never auto-notify customers from preview.
food_wholesale.action_request.status
statusCheck approval, execution, failure, rollback, or partial-completion state for food wholesale write actions.
Read first
action_request_id
Governance
No approval required; status lookup for submitted actions.
Safety
Return only action requests visible to the caller and keep immutable execution logs.
food_wholesale.customer.upsert
writeCreate or update wholesale customer, payment terms, credit limit, delivery preferences, contacts, and account state.
Read first
food_wholesale.customer.get, food_wholesale.customers.list
Governance
Approval required when changing credit limit, account status, payment terms, or primary contacts.
Safety
Validate duplicate customers and keep before/after audit for credit and contact changes.
food_wholesale.price_list.upsert
writeCreate or update customer-specific pricing, discounts, MOQ, effective dates, and end dates.
Read first
food_wholesale.customer_price_lists.list, food_wholesale.price_change.preview
Governance
Approval required before price lists become active.
Safety
Prevent retroactive price changes unless explicitly approved and audited.
food_wholesale.product.upsert
writeCreate or update food SKU, pack size, unit, temperature band, handling requirements, barcode, and handling notes.
Read first
food_wholesale.product.get, food_wholesale.products.list
Governance
Approval required when changing sellable status, handling rules, or cost-sensitive fields.
Safety
Validate unit conversion and cold-chain requirements before making products sellable.
food_wholesale.batch.upsert
writeCreate or update food lot, expiry date, received quantity, sellable state, and quarantine notes.
Read first
food_wholesale.product.get, food_wholesale.batches_expiry.list
Governance
Approval required when changing expiry date, quantity, quarantine, or recall-related state.
Safety
Expiry date and lot identity changes must be immutable or corrected through audited adjustment records.
food_wholesale.order.create
writeCreate a food wholesale order using customer price, MOQ, cut-off, credit, delivery, and temperature rules.
Read first
food_wholesale.order_check.preview, food_wholesale.customer.get, food_wholesale.stock_levels.list
Governance
Approval required when preview returns warnings or when order exceeds credit/cut-off rules.
Safety
Reject blocked preview results unless an approved override is attached.
food_wholesale.order.update
writeUpdate unlocked order lines, quantities, price source, delivery date, special requirements, or notes.
Read first
food_wholesale.order.get, food_wholesale.order_check.preview
Governance
Approval required for post-cut-off, price override, credit-risk, or already-picked order changes.
Safety
Do not update picked, invoiced, or dispatched orders without explicit controlled reversal flow.
food_wholesale.order.confirm
writeConfirm an order and lock pricing, cut-off batch, delivery requirements, and downstream lot allocation flow.
Read first
food_wholesale.order.get, food_wholesale.order_check.preview
Governance
Approval required if confirmation includes warnings, overrides, or credit/cut-off exceptions.
Safety
Confirmation must be idempotent and must not double-reserve or double-invoice lines.
food_wholesale.backorder.create
writeCreate backorder, partial fulfilment, substitute, or customer-pending arrangements for shortage lines.
Read first
food_wholesale.backorders.list, food_wholesale.allocation.preview
Governance
Approval required when substituting products or changing promised delivery dates.
Safety
Record customer acceptance status and never treat substitutes as accepted automatically.
food_wholesale.allocation.apply
writeApply previewed FEFO or selected-lot allocation to orders and reserve stock.
Read first
food_wholesale.allocation.preview, food_wholesale.order.get
Governance
Approval required for manual lot override, short shelf-life allocation, or allocation under shortage.
Safety
Use optimistic locking against stock timestamp to prevent over-allocation.
food_wholesale.pick_list.create
writeCreate pick lists by delivery date, route, temperature band, and warehouse with lot and expiry data.
Read first
food_wholesale.allocation_plan.get, food_wholesale.pick_lists.list
Governance
Approval required when generating pick lists for unconfirmed or partially allocated orders.
Safety
Prevent duplicate active pick lists for the same order lines.
food_wholesale.route_plan.create
writeCreate a delivery route plan with orders, time windows, vehicle, driver, and temperature capacity.
Read first
food_wholesale.route_plan.preview, food_wholesale.delivery_routes.list
Governance
Approval required before committing route plans that affect warehouse or driver workload.
Safety
Block incompatible temperature bands, over-capacity vehicles, and missing customer delivery windows.
food_wholesale.delivery_run.dispatch
writeDispatch a delivery run and lock orders, pick lists, vehicle, driver, and temperature checks.
Read first
food_wholesale.delivery_runs.list, food_wholesale.pick_lists.list
Governance
Approval required for dispatch; operationally locks delivery resources.
Safety
Do not dispatch runs with incomplete pick lists, unresolved temperature checks, or missing driver assignment.
food_wholesale.delivery_run.complete
writeComplete a delivery run with proof of delivery, failure reason, redelivery, short delivery, and temperature exceptions.
Read first
food_wholesale.delivery_runs.list, food_wholesale.returns_claims.list
Governance
Approval required when completion creates claims, redelivery, or temperature exception records.
Safety
Completion must not auto-invoice failed or disputed deliveries unless policy allows and records exception.
food_wholesale.invoice_batch.create
writeCreate invoice batches from completed deliveries, orders, or statement cycles.
Read first
food_wholesale.invoice_batch.preview, food_wholesale.invoices.list
Governance
Finance approval required before invoice batch creation or release.
Safety
Prevent duplicate invoicing and exclude disputed, failed, or uncompleted delivery lines unless approved.
food_wholesale.collection.record
writeRecord collection, partial payment, reconciliation, unapplied receipt, or overdue follow-up state.
Read first
food_wholesale.collections.list, food_wholesale.invoices.list
Governance
Finance approval required for payment application, reversal, or write-off.
Safety
Keep payment references auditable and avoid exposing bank details outside finance roles.
food_wholesale.return_claim.create
writeCreate return or claim case linked to order, delivery, product, lot, photo evidence, and finance handling.
Read first
food_wholesale.returns_claims.list, food_wholesale.order.get, food_wholesale.delivery_runs.list
Governance
Approval required when claim affects invoice, stock, refund, credit note, or replacement delivery.
Safety
Evidence uploads and claim reasons must be immutable after approval except through audited amendments.
food_wholesale.recall_case.create
writeCreate a food recall case with locked lot, affected customers, notification list, returns, and substitute arrangements.
Read first
food_wholesale.recall_impact.preview, food_wholesale.recall_trace.get
Governance
Senior approval required before creating recall case or sending customer-facing actions.
Safety
Recall writes must quarantine affected stock and preserve traceability evidence before notifications.
food_wholesale.notification.send
writeSend customer notifications for order confirmation, backorder, price change, delivery, collection, claim, or recall.
Read first
food_wholesale.customer.get, food_wholesale.order.get, food_wholesale.recall_trace.get
Governance
Approval required for bulk, finance, price-change, claim, or recall notifications.
Safety
Respect consent, channel rules, template approval, and suppress duplicate or unapproved recall notices.