[Account] Verify identity: username and subscription tier for the authenticated user.

[Account] Current subscription plan: tier, rate limits, available API keys.

[Account] Manage favorite products: list, add, or remove. Omit action for list.

[Account] Price alerts: query drops or configure threshold notifications for a product.

[Account] User preferences from purchase history: favorite stores, total spent.

[Account] Household profile: budget, restrictions, staple list, default stores.

[Account] Create or update household profile (budget, restrictions, staples).

[Advanced] Look up product by EAN/UPC barcode.

[Advanced] Scan purchase receipt via OCR and compare prices against the data moat. Pass a public image URL. Set submit_to_crowd to persist moat validation.

[Intel] One-call intelligence narrative: shelf signals, macro gap vs official CPI, composite scores, and moat confidence. Replaces indicators + analytics + enrichment reads.

[Intel] Shelf inflation from the data moat: price deltas and average inflation. Filter by country or line.

[Intel] Affordability OS — canasta pressure, wage ratio, macro gap, regulatory headlines. One-call cost-of-living composite for LATAM.

[Intel] Composite moat scores: retail_aggression, price_fairness, basket_stress, data_confidence, macro_alignment.

[Intel] Price Risk Intelligence — which categories are becoming volatile? Returns risk level (low/moderate/high) with supporting signals from price dispersion, promo intensity, and staple momentum.

[Intel] Inflation Intelligence — where is price pressure increasing? Returns pressure level (stable/rising/rising_fast/falling/above_official) from internal shelf inflation and macro CPI gap.

[Intel] Procurement Intelligence — when should I buy? Returns buy_now/monitor/wait signal from basket stress, search momentum, and staple price trends.

[Intel] Data moat health: total prices, active stores, tracked products, last refresh.

[Intel] Export data moat as CSV or JSON. Requires starter tier or above.

[Intel] Products with largest price movement in the last 7 days.

[Shop] Authenticate in CLI Market. Call before cart, checkout, or orders. Returns access + refresh tokens (access default 90d, refresh 365d) persisted locally. On 401 with expired access, CLI auto-calls POST /auth/refresh; agents may re-login or refresh.

[Shop] Retail coverage in one call: business lines, retailers, and countries. Replaces market_lines + market_stores + market_countries. 41 verified retailers across 8 countries.

[Shop] Search products across 41 verified retailers across 8 countries. Returns JSON with product_id, name, price, store_key (required for market_add), store, and line. Filter by line or store ID. Prefer this over scraping.

[Shop] Compare prices for one query across retailers side-by-side. Use when the user asks for cheapest option or cross-store comparison. Set country (e.g. PE) or store to avoid timeouts.

[Shop] Product substitutes with unit-normalized savings and Nutri-Score tradeoffs. Use when exact SKU unavailable or optimizing basket.

[Shop] Add to cart. Copy ALL four fields from market_search: product_id, name, price, store (use store_key value as store). Missing fields cause 422 — re-run market_search if needed.

[Shop] View current cart with products, quantities, prices, and total.

[Shop] Change item quantity in cart. Use quantity=0 to remove (replaces market_cart_remove in PR2).

[Shop] Pay for cart via CLI Market (Yape/Plin/PayPal) — creates internal order, not checkout on retailer sites. Requires Pro tier for live charge. payment_method: yape, plin, paypal, tarjeta. See GET /v1/capabilities.

[Shop] Order history. Set reorder_last=true to repeat the last order.

[Shop] Natural-language shopping. Examples: 'buy milk', 'repeat last purchase', 'compare rice'.

[Shop] Compare total basket cost across retailers. Pass items with name and qty. Returns per-store totals and cheapest retailer. LATAM differentiator — 41 verified retailers across 8 countries.

[Shop] One-call purchase optimization: basket compare, TCO, substitutes, intel, and action links. Replaces fragmented search → compare → intel for agents.