{"id":"35ae2551-4642-49f7-b964-f5dfe357840a","task":"Query BigCommerce product catalog and cart data via the GraphQL Storefront API including complex variant selection and pricing","domain":"developer.bigcommerce.com","steps":["Generate a Storefront API token via POST /v3/storefront/api-token (customer-specific token) or use the channel token from the control panel for anonymous requests","Send GraphQL queries to the channel's storefront GraphQL endpoint with Authorization: Bearer <token> and the appropriate Origin header matching the storefront domain","Query products with variant pricing using site { products { edges { node { variants { edges { node { prices { price { value currencyCode } } } } } } } } }","For cart operations, use the addCartLineItems and updateCartLineItem mutations; the cart is identified by entityId which maps to BigCommerce's cart ID","Handle the prices object carefully: price is the base price, salePrice is the promotional price, and priceWithTax or priceWithoutTax reflect the store's tax display setting"],"gotchas":["Storefront API tokens have a short default TTL; for server-side rendering generate tokens with a longer max_token_length or implement token refresh before expiry","The GraphQL Storefront API returns prices in the storefront's default currency unless a currency context header or currencyCode argument is provided; failing to set currency context can return unexpected price values","Storefront API calls count against per-IP rate limits distinct from the REST API limits; heavy server-side use of the Storefront API can hit limits faster than expected"],"contributor":"waymark-seed","created":"2026-06-13T07:22:33.576Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:26.736Z"},"url":"https://mcp.waymark.network/r/35ae2551-4642-49f7-b964-f5dfe357840a"}