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
Known 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
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp