POS System MCP tools follow a retail operations workflow across stores, registers, hardware, staff permissions, product pricing, promotions, member points, inventory sync, O2O pickup, sales payments, refunds and exchanges, shifts, offline queues, daily Z-Reports, sales analytics, and operation audit logs.
pos.config.get
readRead POS settings, timezone, tax, currency, supported payment methods, offline mode, and sync strategy.
Read first
-
Governance
Read-only; no approval required.
Safety
Never returns payment keys, terminal secrets, or staff passwords.
pos.stores.list
readList stores, operating state, branch warehouse, O2O pickup capability, and current sync state.
Read first
pos.config.get
Governance
Read-only.
Safety
Shows authorized stores only.
pos.store.get
readRead one store's register settings, hours, payment devices, stock location, and daily close state.
Read first
pos.stores.list
Governance
Read-only.
Safety
Does not expose device credentials or payment secrets.
pos.registers.list
readList registers, cash drawers, tablet login state, current shifts, and last sync time.
Read first
pos.store.get
Governance
Read-only.
Safety
Does not return device login tokens.
pos.devices.list
readList printers, scanners, cash drawers, card terminals, label printers, and connectivity.
Read first
pos.registers.list
Governance
Read-only.
Safety
Shows device state and model, not pairing secrets.
pos.staff_sessions.list
readList staff logins, current shifts, register activity, and unfinished transactions.
Read first
pos.registers.list
Governance
Read-only.
Safety
Staff personal data is role-masked.
pos.permission_rules.get
readRead permission rules for refunds, price changes, voids, cash drawer open, daily close, and offline sync.
Read first
pos.config.get
Governance
Read-only.
Safety
AI must follow permission rules and cannot replace manager approval.
pos.products.search
readSearch POS products by barcode, SKU, category, store, price, stock, or promotion state.
Read first
pos.store.get
Governance
Read-only.
Safety
Paginated; supplier cost is not exposed.
pos.product.get
readRead product barcode, price, tax, promotions, stock, eligible stores, and register sync state.
Read first
pos.products.search
Governance
Read-only.
Safety
Reads product master and POS-saleable data only.
pos.prices.get
readRead global, store, weekend, member prices, and active periods.
Read first
pos.product.get
Governance
Read-only.
Safety
No price changes; for preview comparison only.
pos.promotion_rules.list
readList bundle, add-on, discount, member offer, and cashier note rules.
Read first
pos.prices.get
Governance
Read-only.
Safety
Does not enable or disable promotions.
pos.members.search
readSearch members by phone, member ID, or email for checkout lookup, registration, or point redemption.
Read first
pos.permission_rules.get
Governance
Read-only.
Safety
Member data is masked by cashier permissions.
pos.member.get
readRead member state, points, tier, ecommerce purchase summary, and available offers.
Read first
pos.members.search
Governance
Read-only.
Safety
Avoids unnecessary personal data and full ecommerce order details.
pos.inventory_status.list
readRead sellable stock, reservations, and sync differences across stores, ecommerce, and warehouses.
Read first
pos.products.search
Governance
Read-only.
Safety
Shows authorized store and warehouse stock only.
pos.online_pickup_orders.list
readList ecommerce orders for in-store pickup, pending verification, partial pickup, and exception states.
Read first
pos.store.get
Governance
Read-only.
Safety
Customer data is minimized for pickup workflow.
pos.sales.list
readList sales by store, date, staff, member, payment method, or state.
Read first
pos.store.get
Governance
Read-only.
Safety
Transactions are paginated and permission-filtered.
pos.sale.get
readRead sale lines, payments, discounts, member, invoice, refunds, and stock deduction state.
Read first
pos.sales.list
Governance
Read-only.
Safety
Card and payment-sensitive fields must be masked.
pos.payments.list
readList cash, card, FPS, PayMe, QR code payments and reconciliation state.
Read first
pos.sales.list
Governance
Read-only.
Safety
No card number, full transaction secret, or gateway credential.
pos.shifts.list
readList open/close shifts, cash counts, staff, registers, and variance records.
Read first
pos.registers.list
Governance
Read-only.
Safety
Shows authorized staff and store shifts only.
pos.offline_queue.list
readList offline-stored transactions, payments, member updates, and sync conflicts.
Read first
pos.registers.list
Governance
Read-only.
Safety
Does not replay the queue; reads state and conflicts only.
pos.daily_close.get
readRead store daily close, Z-Report, payment totals, refunds, discounts, cash variance, and open items.
Read first
pos.shifts.list, pos.payments.list
Governance
Read-only.
Safety
Does not submit daily close; report only.
pos.sales_analytics.get
readRead branch revenue, best sellers, payment mix, refund rate, time performance, and member sales.
Read first
pos.daily_close.get
Governance
Read-only.
Safety
Analytics are aggregated by management permission.
pos.audit_logs.list
readList audit logs for price changes, refunds, voids, daily close, offline sync, and permission actions.
Read first
pos.permission_rules.get
Governance
Read-only.
Safety
Audit logs cannot be edited or deleted by AI.
pos.promotion_update.preview
previewPreview weekend offers, bundles, add-ons, member discounts, and cashier note impact by product and store.
Read first
pos.promotion_rules.list, pos.products.search
Governance
Preview only; approval required before apply.
Safety
Shows products, periods, discounts, stacking rules, and rollback path.
pos.price_update.preview
previewPreview POS product price, member price, store price, and active period changes.
Read first
pos.prices.get
Governance
Preview only; price changes need approval.
Safety
High-volume price changes need second confirmation.
pos.checkout_cart.preview
previewPreview scanned cart price, discounts, tax, member points, split payments, and stock deduction.
Read first
pos.product.get, pos.member.get, pos.promotion_rules.list
Governance
Preview only; confirm before sale.create.
Safety
Prevents wrong price, out-of-stock, or incorrect member offer.
pos.refund_exchange.preview
previewPreview refunds, returns, exchanges, e-receipt verification, payment reversal, and stock restock impact.
Read first
pos.sale.get
Governance
Preview only; refund or exchange needs permission approval.
Safety
Cannot refund unverified or already fully refunded sales again.
pos.stock_sync.preview
previewPreview stock differences after store sales, ecommerce stock, transfers, and offline transaction sync.
Read first
pos.inventory_status.list, pos.offline_queue.list
Governance
Preview only; differences require confirmation before sync.
Safety
Labels source timestamp to avoid stale stock overwrites.
pos.daily_close.preview
previewPreview sales, payments, refunds, cash variance, unsynced transactions, and Z-Report before daily close.
Read first
pos.daily_close.get, pos.offline_queue.list
Governance
Preview only; manager or finance approval required before submit.
Safety
Cannot auto-close when unsynced transactions or payment variances exist.
pos.sale.create
writeCreate sale, lock price and discounts, calculate tax, deduct stock, and generate receipt data.
Read first
pos.checkout_cart.preview
Governance
Cashier may execute by permission; high-risk discounts require manager approval.
Safety
Checks price, stock, member, and payment state before write.
pos.sale.void
writeVoid eligible sales with reason, staff, manager approval, and stock reversal.
Read first
pos.sale.get, pos.permission_rules.get
Governance
Usually requires manager approval.
Safety
Paid or closed-day transactions use refund flow, not direct void.
pos.refund.create
writeCreate approved refund with payment reversal, stock restock, point reversal, and e-receipt record.
Read first
pos.refund_exchange.preview
Governance
Requires authorized staff or manager approval.
Safety
Prevents duplicate refunds and amounts exceeding original sale.
pos.exchange.create
writeCreate exchange record with returned item, replacement item, price difference, and stock adjustment.
Read first
pos.refund_exchange.preview
Governance
Approval follows return/exchange policy.
Safety
No exchange for policy-ineligible or unverified receipts.
pos.payment.capture
writeRecord or initiate payment capture for cash, card, FPS, PayMe, QR code, and related methods.
Read first
pos.checkout_cart.preview
Governance
Executed by cashier payment permission.
Safety
Does not store full card data; result must be reconcilable.
pos.payment_reconciliation.record
writeRecord payment batch reconciliation result, variance reason, finance note, and handling state.
Read first
pos.payments.list, pos.daily_close.preview
Governance
Finance or manager approval depends on variance size.
Safety
Does not rewrite original payment transactions; appends reconciliation record.
pos.member.upsert
writeCreate or update member profile during checkout and sync CRM/ecommerce membership.
Read first
pos.members.search
Governance
Follows member data permission; important changes need confirmation.
Safety
Collects necessary data only and keeps consent record.
pos.member_points.adjust
writeAdjust, redeem, reverse, or grant member points with reason and linked sale.
Read first
pos.member.get, pos.permission_rules.get
Governance
Manual point adjustment requires authorized approval.
Safety
Prevents duplicate grants or unauthorized deductions.
pos.price_update.apply
writeApply approved POS prices, store prices, member prices, or time-window prices.
Read first
pos.price_update.preview
Governance
Requires human approval; bulk price changes need second confirmation.
Safety
Writes by diff and keeps rollback version.
pos.promotion_rule.upsert
writeCreate or update approved promotion rules, discount windows, cashier notes, and store scope.
Read first
pos.promotion_update.preview
Governance
Requires approval covering products, period, stores, and stacking rules.
Safety
Cannot enable unapproved or conflicting promotions.
pos.product_sync_to_registers.run
writeSync products, barcodes, prices, promotions, tax, and cashier notes to selected registers.
Read first
pos.price_update.preview, pos.promotion_update.preview
Governance
Requires approval by store scope.
Safety
Checks register online state and version before sync.
pos.inventory_deduction.sync
writeSync stock deduction or restock from store sales, refunds, exchanges, and offline transactions to ecommerce and warehouses.
Read first
pos.stock_sync.preview
Governance
Difference sync requires source and timestamp confirmation.
Safety
Prevents stale transactions overwriting newer stock and keeps sync batch record.
pos.online_pickup.fulfil
writeFulfil ecommerce pickup orders, updating pickup state, stock, member record, and receipt.
Read first
pos.online_pickup_orders.list
Governance
Executed by store staff with pickup permission.
Safety
Requires order, customer proof, and unfulfilled state checks.
pos.shift.open
writeOpen a shift for staff, register, and cash drawer with opening cash and device state.
Read first
pos.registers.list, pos.staff_sessions.list
Governance
Follows staff shift permission.
Safety
A register cannot have duplicate open shifts.
pos.shift.close
writeClose shift with cash count, payment summary, variance, unfinished transactions, and staff confirmation.
Read first
pos.shifts.list, pos.payments.list
Governance
Variance above threshold requires manager approval.
Safety
Cannot silently close with unsynced transactions.
pos.cash_movement.record
writeRecord cash in/out, change, petty cash, or drawer adjustment reason.
Read first
pos.shifts.list
Governance
Follows cash permission; large movements require approval.
Safety
Logs staff, time, amount, and reason audit.
pos.device_pairing.update
writeUpdate register pairing with printer, scanner, cash drawer, or payment terminal.
Read first
pos.devices.list
Governance
Requires admin approval or device-pairing permission.
Safety
Does not return or store plaintext pairing secrets.
pos.store_status.update
writeUpdate store open, paused, maintenance, temporary pop-up, or O2O pickup state.
Read first
pos.store.get
Governance
Requires store management permission.
Safety
State changes log reason and impacted channels.
pos.offline_queue.sync
writeSync offline transactions, payments, member updates, and stock deductions to cloud, resolving conflicts.
Read first
pos.offline_queue.list, pos.stock_sync.preview
Governance
Conflicts or high-value transactions require human confirmation.
Safety
Runs by queue order and idempotency to avoid duplicate transactions.
pos.daily_close.submit
writeSubmit store daily Z-Report and lock sales, payments, refunds, cash variance, and report version.
Read first
pos.daily_close.preview, pos.shift.close
Governance
Requires manager or finance approval.
Safety
Requires no unresolved offline queue or material reconciliation variance.
pos.action_request.status
statusCheck approval and execution state for POS writes, syncs, price changes, refunds, daily close, or device pairing requests.
Read first
related write endpoint
Governance
Status checks do not require approval.
Safety
Checks state only and never re-runs transactions or sync.