Authenticate requests with the store hash and API token using headers X-Auth-Token and Content-Type: application/json; base URL is https://api.bigcommerce.com/stores/{store_hash}/v3
Create a product via POST /catalog/products with required fields name, type (physical or digital), weight, and price; receive the product id in the response
Add variants by POSTing to /catalog/products/{product_id}/variants with option_values array referencing previously created option and option value IDs, plus sku, price, and inventory_level
Upload a product image via POST /catalog/products/{product_id}/images with image_url pointing to a publicly accessible image or multipart form upload with image_file
Batch-update multiple products using PUT /catalog/products with an array payload (up to 10 items per request) to reduce API call volume for catalog refreshes
Retrieve products with GET /catalog/products using query parameters include=variants,images,custom_fields to fetch related data in a single call
Known gotchas
BigCommerce v3 catalog API returns paginated results; always check the meta.pagination object for total_pages and iterate using the page query parameter
Variant creation requires option IDs that must be created first; attempting to create variants with arbitrary option labels without pre-created options results in a 422 error
The is_visible field controls storefront visibility; newly created products default to visible=false in some configurations, so set it explicitly
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