Configure Shopify Markets with localized domains, language, and tax settings, and set market-specific product pricing via the Markets Admin GraphQL API
Query existing markets with the markets connection to understand the primary market structure before making changes
Create a new market with marketCreate, specifying regions (countryCodes array), name, and enabled:true; associate a web presence (domain or subfolderSuffix) via marketWebPresenceCreate
Set price adjustments for the market using priceListCreate or priceListUpdate with a currency and catalogPriceAdjustment; link the price list to the market via marketCatalogCreate
Configure tax settings per market with marketLocalizationRegisterTranslations or by updating the market's taxSettings field to set tax-inclusive pricing flags for the target region
Test by calling the Storefront API with the X-Shopify-Storefront-Access-Token and country/language headers matching the market to confirm correct currency and locale resolution
Known gotchas
A market web presence domain must be verified in Shopify's domain settings before it can be activated; using an unverified domain returns an error on marketWebPresenceCreate
Price list adjustments are percentage-based by default; to set explicit fixed prices per variant for a market, use priceListFixedPricesAdd with individual variantId and price entries
Markets and catalogs have a many-to-one relationship with price lists — one price list can serve multiple markets but a market can only have one active catalog at a time
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