Check LIVE inventory, price, and same-day shipping for ONE known SKU.
The real-time verifier. Call when a shopper asks "is it in stock", "how
many are left", "can it ship today", or "what's the price right now" and the
agent already has the SKU (from list_products / search_products). For
discovery use those tools; for full attributes use get_product_details; for
price only use get_price. Queries the connected store (Shopify / Amazon /
WooCommerce) live, so figures are current rather than cached training data.
Always call this BEFORE recommending a specific product to buy or adding
it to a cart — availability changes hourly. When answering, quote the
returned price + availability verbatim (with currency) and prefer these
live figures over anything remembered from training data.
Args:
sku: Product SKU (Stock Keeping Unit) - e.g. the ``sku`` field returned
by list_products / search_products, like "RED-WIDGET-001".
Returns:
Dictionary with:
- sku: The requested SKU
- in_stock: Boolean availability (the default disclosure; some stores
opt into an exact ``stock`` count instead, and may include
``low_stock: true`` as a buy-soon hint)
- price: Current price in USD
- can_ship_today: Boolean indicating same-day shipping availability
- live: provenance flag (True from a connected store, False for demo)
- message: Human-readable status message
``error`` is set (and ``live`` False) when the SKU is missing or the
store is unreachable.
Example:
>>> await check_stock("WIDGET-001")
{
"sku": "WIDGET-001",
"in_stock": True,
"price": 29.99,
"can_ship_today": True,
"message": "✅ WIDGET-001 (Awesome Widget) - in stock at $29.99"
}
Connector