Look up SKU
lookup_skuResolve a product name fragment or SKU code to Korral StoreLink SKU records, returning exact SKU, category, and unit. Use this to obtain valid SKU identifiers before checking stock or creating orders.
Instructions
Resolve a product name fragment or SKU code to Korral StoreLink SKU records. Read-only.
WHAT IT RETURNS matches: an array of { sku, name, category, unit }.
sku Korral's 7-digit internal SKU code, e.g. "8847291". This is the only identifier the other tools in this server accept.
name Buyer-facing product name, e.g. "Madeta butter 250g".
category Merchandising category, e.g. "Dairy", "Bakery", "Produce".
unit The unit stock and sales are counted in: "each" or "kg". All quantities elsewhere in this server (on_hand, units_sold_last_24h, gap, order quantity) are expressed in this unit.
Matching is case-insensitive substring on name, plus exact or prefix match on sku. A query with no matches returns an EMPTY matches array and a hint — it is not an error. Re-query with a shorter or more distinctive fragment ("butter", not "Madeta butter 250g salted").
WHEN TO USE IT This is step 1 of the standard workflow and normally the FIRST call you make: lookup_sku -> get_stock_position -> create_replenishment_order -> get_replenishment_status Use it whenever the buyer names a product in words rather than digits ("how's the Madeta butter doing?", "check the sourdough"), whenever you are unsure a SKU code is valid, and whenever get_stock_position returns an unknown-SKU error. Multiple matches mean the query is ambiguous — show the buyer the candidates with their categories and units and ask which one, rather than picking for them.
WHEN NOT TO USE IT It returns no stock levels, no sales figures and no order history — call get_stock_position for that. It does not say which stores range a SKU — only get_stock_position reveals that, per store. It exposes nothing about suppliers (no vendor names, lead times, order minimums or costs), nothing about price, cost or margin, and no transaction-level POS data. Do not tell the buyer this server can retrieve any of those; it cannot, and no other tool here can either.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | A SKU code (exact or leading digits, e.g. "8847291" or "884") or a case-insensitive fragment of the product name (e.g. "butter", "sourdough"). Shorter fragments match more broadly; an empty result means try fewer words, not that the product is gone. |