texas-grocery

Add an item to the shopping cart with verification. Without confirm=true, returns a preview of the action. With confirm=true, executes the action and VERIFIES it worked. IMPORTANT: Use both product_id and sku_id from product_search results: - product_id: shorter ID (e.g., '127074') - sku_id: longer ID (e.g., '4122071073') Returns error if item wasn't actually added to cart.

Add multiple items to cart with a single confirmation. This is more efficient than calling cart_add multiple times and provides a single confirmation gate for the entire batch. IMPORTANT: This operation uses STRICT success semantics. If ANY item fails to add, the entire operation is reported as a FAILURE. Items that were successfully added will remain in the cart, but you'll receive a clear list of which items failed.

Add item to cart with automatic ID correction. If the initial add fails due to ID format issues and auto_correct_ids=True, this will search for the product and retry with the correct IDs. This is a more resilient version of cart_add that can recover from incorrect ID formats by looking up the product.

Check if authenticated for cart operations. Returns authentication status and instructions if not authenticated. Use this before attempting cart operations.

Get current cart contents. Returns all items in the cart with quantities and prices.

Remove an item from the shopping cart. Without confirm=true, returns a preview of the action. With confirm=true, executes the action.

Get available coupon categories/departments. Returns a list of categories with the number of coupons in each. Use category names with coupon_list to filter coupons.

Clip a coupon to your HEB account. Without confirm=true, returns a preview of the action. With confirm=true, clips the coupon (requires authentication). Clipped coupons automatically apply at checkout when you buy eligible items.

List your clipped coupons. Returns all coupons you've clipped to your HEB account. Clipped coupons automatically apply at checkout when you buy eligible items.

List available HEB digital coupons. Returns coupons with discount details, descriptions, and expiration dates. Filter by category to find coupons in specific departments.

Search for HEB coupons by keyword. Search for coupons by product name, brand, or discount type.

Liveness probe - is the process running? Returns a simple alive status. Use for Kubernetes liveness probes.

Readiness probe - can the server handle requests? Returns detailed component health. Use for Kubernetes readiness probes.

Get comprehensive details for a single product. Returns detailed product information including: - Full description - Complete ingredients text - Safety/allergen warnings - Nutritional information (full FDA panel for packaged food) - Storage and preparation instructions - Dietary attributes (Gluten-Free, Organic, Vegan, etc.) - Store location (aisle or section) Use this when you need more information than product_search provides, such as checking ingredients for dietary restrictions or allergens.

Search for products at an HEB store. Returns products matching the query with pricing and availability for the specified store.

Search for multiple products at once. More efficient than calling product_search multiple times. Handles throttling internally to prevent rate limiting. Returns results for each query, with availability at the specified store.

Clear saved session cookies. Use this to log out or clear invalid session data. After clearing, you will need to run session_refresh again. Note: This does NOT clear saved credentials. Use session_clear_credentials() to remove stored login credentials.

Remove stored HEB login credentials. After clearing, session_refresh will fall back to manual browser login when your session expires.

Refresh HEB session cookies and tokens. Uses embedded browser when available (fast: ~10-15 seconds). If credentials are saved and login is required, attempts automatic login. Falls back to returning Playwright MCP commands if browser dependencies aren't installed.

Save HEB login credentials for automatic login. Credentials are stored securely using: - OS keyring (macOS Keychain, Windows Credential Manager, Linux Secret Service) - Encrypted file fallback when keyring is unavailable After saving, session_refresh will automatically use these credentials when your session expires, eliminating manual browser login.

Get instructions for saving browser session cookies. Call this to get step-by-step instructions for authenticating via Playwright MCP and saving the session for fast API access. For automatic session extraction, use session_refresh instead.

Get current session status including token lifecycle and credential storage. Returns comprehensive session information: - authenticated: Whether session is valid - needs_refresh: Whether refresh is required now (token expired) - refresh_recommended: Whether proactive refresh is advised (< 4 hours remaining) - time_remaining_hours: Hours until token expires - expires_at: ISO timestamp of expiration - message: Human-readable status - credentials_stored: Whether HEB credentials are saved for auto-login Use this to check session health before operations or to decide when to proactively refresh.

Change the active store for HEB operations. When authenticated: Changes the store on HEB.com via their API with verification. When not authenticated: Sets a local default for product searches. The store change is VERIFIED by checking the cart's actual store after the mutation. This ensures we never return success when the store didn't actually change (e.g., due to cart conflicts).

Get the currently set default store. Returns the default store ID if set, otherwise indicates no default.

Search for HEB stores near an address. Returns stores sorted by distance, including store ID, name, address, and distance from the search location.