@anton.andrusenko/shopify-mcp-admin 0.4.0 → 0.5.0

package/dist/index.js

@@ -2451,7 +2451,7 @@ function wrapToolHandler(toolName, schema, handler) {
   };
 }
 function registerTool(definition, handler, options = {}) {
-  const { name, title, description, inputSchema: inputSchema46, annotations } = definition;
+  const { name, title, description, inputSchema: inputSchema55, annotations } = definition;
   try {
     if (!options.skipNameValidation) {
       validateToolName(name);
@@ -2459,8 +2459,8 @@ function registerTool(definition, handler, options = {}) {
     if (registeredTools.has(name)) {
       throw new Error(`Tool "${name}" is already registered. Tool names must be unique.`);
     }
-    const jsonSchema = convertZodToJsonSchema(inputSchema46);
-    const wrappedHandler = wrapToolHandler(name, inputSchema46, handler);
+    const jsonSchema = convertZodToJsonSchema(inputSchema55);
+    const wrappedHandler = wrapToolHandler(name, inputSchema55, handler);
     const finalAnnotations = {
       ...deriveDefaultAnnotations(name),
       ...annotations,
@@ -2472,7 +2472,7 @@ function registerTool(definition, handler, options = {}) {
       title,
       description,
       inputSchema: jsonSchema,
-      zodSchema: inputSchema46,
+      zodSchema: inputSchema55,
       handler: wrappedHandler,
       annotations: finalAnnotations
     };
@@ -3173,6 +3173,12 @@ var redirectIdSchema = gidSchema("UrlRedirect");
 var inventoryItemIdSchema = gidSchema("InventoryItem");
 var locationIdSchema = gidSchema("Location");
 var marketIdSchema = gidSchema("Market");
+var webPresenceIdSchema = gidSchema("MarketWebPresence");
+var LOCALE_CODE_PATTERN = /^[a-z]{2}(-[A-Za-z]{2})?$/;
+var localeCodeSchema = z2.string().regex(
+  LOCALE_CODE_PATTERN,
+  'Must be a valid locale code (e.g., "en", "fr", "de", "fr-CA", "pt-BR"). Use lowercase 2-letter language code, optionally followed by hyphen and region code.'
+).describe('Locale code (e.g., "en", "fr", "de", "fr-CA", "pt-BR")');
 
 // src/tools/add-product-image.ts
 var inputSchema = z3.object({
@@ -4533,6 +4539,19 @@ query Markets($first: Int!, $after: String) {
       enabled
       status
       type
+      conditions {
+        regionsCondition {
+          regions(first: 50) {
+            nodes {
+              id
+              name
+              ... on MarketRegionCountry {
+                countryCode: code
+              }
+            }
+          }
+        }
+      }
       currencySettings {
         baseCurrency { currencyCode }
         localCurrencies
@@ -4554,6 +4573,19 @@ query Market($id: ID!) {
     enabled
     status
     type
+    conditions {
+      regionsCondition {
+        regions(first: 50) {
+          nodes {
+            id
+            name
+            ... on MarketRegionCountry {
+              countryCode: code
+            }
+          }
+        }
+      }
+    }
     currencySettings {
       baseCurrency { currencyCode currencyName }
       localCurrencies
@@ -4595,6 +4627,60 @@ mutation MarketDelete($id: ID!) {
   }
 }
 `;
+var LIST_WEB_PRESENCES_QUERY = `
+query WebPresences($first: Int!, $after: String) {
+  webPresences(first: $first, after: $after) {
+    nodes {
+      id
+      defaultLocale { locale name }
+      alternateLocales { locale name }
+      subfolderSuffix
+      domain { host }
+      rootUrls { locale url }
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+  }
+}
+`;
+var WEB_PRESENCE_CREATE_MUTATION = `
+mutation WebPresenceCreate($input: WebPresenceCreateInput!) {
+  webPresenceCreate(input: $input) {
+    webPresence {
+      id
+      defaultLocale { locale name }
+      alternateLocales { locale name }
+      subfolderSuffix
+      domain { host }
+    }
+    userErrors { field message }
+  }
+}
+`;
+var WEB_PRESENCE_UPDATE_MUTATION = `
+mutation WebPresenceUpdate($id: ID!, $input: WebPresenceUpdateInput!) {
+  webPresenceUpdate(id: $id, input: $input) {
+    webPresence {
+      id
+      defaultLocale { locale name }
+      alternateLocales { locale name }
+      subfolderSuffix
+      domain { host }
+    }
+    userErrors { field message }
+  }
+}
+`;
+var WEB_PRESENCE_DELETE_MUTATION = `
+mutation WebPresenceDelete($id: ID!) {
+  webPresenceDelete(id: $id) {
+    deletedId
+    userErrors { field message }
+  }
+}
+`;
 async function listMarkets(first = 50, after) {
   const client = await getShopifyClient();
   log.debug(`Listing markets: first=${first}, after=${after}`);
@@ -4619,6 +4705,13 @@ async function listMarkets(first = 50, after) {
     enabled: node.enabled,
     status: node.status,
     type: node.type,
+    regions: node.conditions?.regionsCondition?.regions?.nodes?.map(
+      (region) => ({
+        id: region.id,
+        name: region.name,
+        countryCode: region.countryCode
+      })
+    ),
     currencySettings: node.currencySettings ? {
       baseCurrency: {
         currencyCode: node.currencySettings.baseCurrency.currencyCode
@@ -4660,6 +4753,13 @@ async function getMarket(marketId) {
     enabled: market.enabled,
     status: market.status,
     type: market.type,
+    regions: market.conditions?.regionsCondition?.regions?.nodes?.map(
+      (region) => ({
+        id: region.id,
+        name: region.name,
+        countryCode: region.countryCode
+      })
+    ),
     currencySettings: market.currencySettings ? {
       baseCurrency: {
         currencyCode: market.currencySettings.baseCurrency.currencyCode,
@@ -4695,11 +4795,27 @@ async function createMarket(input) {
   if (input.handle !== void 0) {
     graphqlInput.handle = input.handle;
   }
-  if (input.regions !== void 0) {
-    graphqlInput.regions = input.regions;
+  if (input.countryCodes !== void 0 && input.countryCodes.length > 0) {
+    graphqlInput.conditions = {
+      regionsCondition: {
+        regions: input.countryCodes.map((code) => ({ countryCode: code }))
+      }
+    };
   }
   if (input.enabled !== void 0) {
-    graphqlInput.enabled = input.enabled;
+    graphqlInput.status = input.enabled ? "ACTIVE" : "INACTIVE";
+  }
+  if (input.currencySettings) {
+    const currencyInput = {};
+    if (input.currencySettings.baseCurrency !== void 0) {
+      currencyInput.baseCurrency = input.currencySettings.baseCurrency;
+    }
+    if (input.currencySettings.localCurrencies !== void 0) {
+      currencyInput.localCurrencies = input.currencySettings.localCurrencies;
+    }
+    if (Object.keys(currencyInput).length > 0) {
+      graphqlInput.currencySettings = currencyInput;
+    }
   }
   const response = await withRateLimit(
     () => client.graphql.request(MARKET_CREATE_MUTATION, {
@@ -4735,7 +4851,35 @@ async function updateMarket(marketId, input) {
     graphqlInput.handle = input.handle;
   }
   if (input.enabled !== void 0) {
-    graphqlInput.enabled = input.enabled;
+    graphqlInput.status = input.enabled ? "ACTIVE" : "INACTIVE";
+  }
+  if (input.countryCodesToAdd && input.countryCodesToAdd.length > 0) {
+    graphqlInput.conditions = graphqlInput.conditions || {};
+    graphqlInput.conditions.regionsCondition = {
+      regionsToAdd: input.countryCodesToAdd.map((code) => ({ countryCode: code }))
+    };
+  }
+  if (input.countryCodesToRemove && input.countryCodesToRemove.length > 0) {
+    graphqlInput.conditions = graphqlInput.conditions || {};
+    const regionsCondition = graphqlInput.conditions.regionsCondition || {};
+    regionsCondition.regionsToRemove = input.countryCodesToRemove.map((code) => ({
+      countryCode: code
+    }));
+    graphqlInput.conditions.regionsCondition = regionsCondition;
+  }
+  if (input.removeCurrencySettings) {
+    graphqlInput.removeCurrencySettings = true;
+  } else if (input.currencySettings) {
+    const currencyInput = {};
+    if (input.currencySettings.baseCurrency !== void 0) {
+      currencyInput.baseCurrency = input.currencySettings.baseCurrency;
+    }
+    if (input.currencySettings.localCurrencies !== void 0) {
+      currencyInput.localCurrencies = input.currencySettings.localCurrencies;
+    }
+    if (Object.keys(currencyInput).length > 0) {
+      graphqlInput.currencySettings = currencyInput;
+    }
   }
   const response = await withRateLimit(
     () => client.graphql.request(MARKET_UPDATE_MUTATION, {
@@ -4786,6 +4930,152 @@ async function deleteMarket(marketId) {
   log.debug(`Deleted market: ${result.deletedId}`);
   return result.deletedId;
 }
+function transformWebPresenceNode(node) {
+  return {
+    id: node.id,
+    defaultLocale: {
+      locale: node.defaultLocale.locale,
+      name: node.defaultLocale.name
+    },
+    alternateLocales: node.alternateLocales?.map((al) => ({
+      locale: al.locale,
+      name: al.name
+    })),
+    subfolderSuffix: node.subfolderSuffix ?? void 0,
+    domain: node.domain ? { host: node.domain.host } : void 0,
+    rootUrls: node.rootUrls?.map((ru) => ({
+      locale: ru.locale,
+      url: ru.url
+    }))
+  };
+}
+async function listWebPresences(first = 50, after) {
+  const client = await getShopifyClient();
+  log.debug(`Listing web presences: first=${first}, after=${after}`);
+  const response = await withRateLimit(
+    () => client.graphql.request(LIST_WEB_PRESENCES_QUERY, {
+      variables: { first, after }
+    }),
+    "list-web-presences"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const webPresencesData = response.data?.webPresences;
+  if (!webPresencesData) {
+    throw new Error("No response data from webPresences query");
+  }
+  const webPresences = webPresencesData.nodes.map(transformWebPresenceNode);
+  log.debug(`Listed ${webPresences.length} web presences`);
+  return {
+    webPresences,
+    pageInfo: {
+      hasNextPage: webPresencesData.pageInfo.hasNextPage,
+      endCursor: webPresencesData.pageInfo.endCursor
+    }
+  };
+}
+async function createWebPresence(input) {
+  const client = await getShopifyClient();
+  log.debug(`Creating web presence with defaultLocale: ${input.defaultLocale}`);
+  const graphqlInput = {
+    defaultLocale: input.defaultLocale
+  };
+  if (input.domainId !== void 0) {
+    graphqlInput.domainId = input.domainId;
+  }
+  if (input.subfolderSuffix !== void 0) {
+    graphqlInput.subfolderSuffix = input.subfolderSuffix;
+  }
+  if (input.alternateLocales !== void 0) {
+    graphqlInput.alternateLocales = input.alternateLocales;
+  }
+  const response = await withRateLimit(
+    () => client.graphql.request(WEB_PRESENCE_CREATE_MUTATION, {
+      variables: { input: graphqlInput }
+    }),
+    "create-web-presence"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const result = response.data?.webPresenceCreate;
+  if (!result) {
+    throw new Error("No response data from webPresenceCreate mutation");
+  }
+  if (result.userErrors && result.userErrors.length > 0) {
+    throw new ShopifyUserErrorException(result.userErrors);
+  }
+  if (!result.webPresence) {
+    throw new Error("Web presence creation succeeded but no web presence was returned");
+  }
+  log.debug(`Created web presence: ${result.webPresence.id}`);
+  return transformWebPresenceNode(result.webPresence);
+}
+async function updateWebPresence(webPresenceId, input) {
+  const client = await getShopifyClient();
+  log.debug(`Updating web presence: ${webPresenceId}`);
+  const graphqlInput = {};
+  if (input.defaultLocale !== void 0) {
+    graphqlInput.defaultLocale = input.defaultLocale;
+  }
+  if (input.alternateLocales !== void 0) {
+    graphqlInput.alternateLocales = input.alternateLocales;
+  }
+  if (input.subfolderSuffix !== void 0) {
+    graphqlInput.subfolderSuffix = input.subfolderSuffix;
+  }
+  const response = await withRateLimit(
+    () => client.graphql.request(WEB_PRESENCE_UPDATE_MUTATION, {
+      variables: { id: webPresenceId, input: graphqlInput }
+    }),
+    "update-web-presence"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const result = response.data?.webPresenceUpdate;
+  if (!result) {
+    throw new Error("No response data from webPresenceUpdate mutation");
+  }
+  if (result.userErrors && result.userErrors.length > 0) {
+    throw new ShopifyUserErrorException(result.userErrors);
+  }
+  if (!result.webPresence) {
+    throw new Error("Web presence update succeeded but no web presence was returned");
+  }
+  log.debug(`Updated web presence: ${result.webPresence.id}`);
+  return transformWebPresenceNode(result.webPresence);
+}
+async function deleteWebPresence(webPresenceId) {
+  const client = await getShopifyClient();
+  log.debug(`Deleting web presence: ${webPresenceId}`);
+  const response = await withRateLimit(
+    () => client.graphql.request(WEB_PRESENCE_DELETE_MUTATION, {
+      variables: { id: webPresenceId }
+    }),
+    "delete-web-presence"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const result = response.data?.webPresenceDelete;
+  if (!result) {
+    throw new Error("No response data from webPresenceDelete mutation");
+  }
+  if (result.userErrors && result.userErrors.length > 0) {
+    throw new ShopifyUserErrorException(result.userErrors);
+  }
+  if (!result.deletedId) {
+    throw new Error("Web presence deletion succeeded but no deletedId was returned");
+  }
+  log.debug(`Deleted web presence: ${result.deletedId}`);
+  return result.deletedId;
+}
 
 // src/tools/create-market.ts
 var inputSchema6 = z8.object({
@@ -4796,7 +5086,15 @@ var inputSchema6 = z8.object({
   countryCodes: z8.array(z8.string().length(2)).optional().describe(
     'Array of ISO 3166-1 alpha-2 country codes to include in this market. Example: ["CA"] for Canada, ["FR", "DE", "IT"] for multiple European countries'
   ),
-  enabled: z8.boolean().optional().default(true).describe("Whether the market should be enabled. Default: true")
+  enabled: z8.boolean().optional().default(false).describe(
+    "Whether the market should be enabled (status: ACTIVE). Default: false (creates market as INACTIVE/draft). Set to true only when ready to make the market live. \u26A0\uFE0F ACTIVE markets are immediately visible to customers in those regions."
+  ),
+  baseCurrency: z8.string().length(3).optional().describe(
+    'Base currency code for the market (ISO 4217). Example: "USD", "EUR", "CAD", "GBP". If not set, uses store default currency.'
+  ),
+  localCurrencies: z8.boolean().optional().describe(
+    "Whether to enable local currencies for better customer experience. When true, prices are converted to customer local currency. When false, all customers see prices in baseCurrency."
+  )
 });
 var outputSchema6 = z8.object({
   id: z8.string().describe("Created market GID"),
@@ -4813,11 +5111,20 @@ var handleCreateMarket = async (context, params) => {
     input.handle = params.handle;
   }
   if (params.countryCodes !== void 0 && params.countryCodes.length > 0) {
-    input.regions = { countryCodes: params.countryCodes };
+    input.countryCodes = params.countryCodes;
   }
   if (params.enabled !== void 0) {
     input.enabled = params.enabled;
   }
+  if (params.baseCurrency !== void 0 || params.localCurrencies !== void 0) {
+    input.currencySettings = {};
+    if (params.baseCurrency !== void 0) {
+      input.currencySettings.baseCurrency = params.baseCurrency;
+    }
+    if (params.localCurrencies !== void 0) {
+      input.currencySettings.localCurrencies = params.localCurrencies;
+    }
+  }
   const market = await createMarket(input);
   log.debug(`Created market: ${market.id}`);
   return market;
@@ -4827,7 +5134,7 @@ function registerCreateMarketTool() {
     {
       name: "create-market",
       title: "Create Market",
-      description: "Create a new market for regional targeting. Markets group one or more regions (countries) for localized shopping experiences. Provide a name (required) and optionally: handle, country codes, and enabled status. **Typical workflow:** create-market \u2192 create-web-presence (configure SEO URLs) \u2192 enable-shop-locale (add languages). **Prerequisites:** None. Store must have Markets feature enabled on their plan. **Follow-ups:** get-market, create-web-presence, update-market.",
+      description: 'Create a new market for regional targeting. Markets group one or more regions (countries) for localized shopping experiences. Provide a name (required) and optionally: handle, country codes, currency settings, and enabled status. \u26A0\uFE0F **Note:** Markets are created as INACTIVE by default (enabled=false). Use update-market to activate when ready, or set enabled=true if you want it live immediately. **Currency:** Set baseCurrency (e.g., "CAD") and localCurrencies for multi-currency support. **Typical workflow:** create-market \u2192 create-web-presence (configure SEO URLs) \u2192 enable-shop-locale (add languages) \u2192 update-market (enable when ready). **Prerequisites:** None. Store must have Markets feature enabled on their plan. **Follow-ups:** get-market, update-market, create-web-presence.',
       inputSchema: inputSchema6,
       outputSchema: outputSchema6,
       // AI Agent Optimization
@@ -7209,6 +7516,13 @@ var outputSchema22 = z24.object({
   enabled: z24.boolean().describe("Whether the market is enabled"),
   status: z24.enum(["ACTIVE", "INACTIVE"]).describe("Market status"),
   type: z24.string().describe("Market type (PRIMARY, SINGLE_COUNTRY, MULTI_COUNTRY, CONTINENT)"),
+  regions: z24.array(
+    z24.object({
+      id: z24.string().describe("Region GID"),
+      name: z24.string().describe('Region name (e.g., "Canada", "France")'),
+      countryCode: z24.string().optional().describe("ISO 3166-1 alpha-2 country code")
+    })
+  ).optional().describe("Countries/regions included in this market"),
   currencySettings: z24.object({
     baseCurrency: z24.object({
       currencyCode: z24.string().describe("Base currency code (e.g., USD, EUR)"),
@@ -7865,6 +8179,13 @@ var outputSchema30 = z32.object({
       enabled: z32.boolean().describe("Whether the market is enabled"),
       status: z32.enum(["ACTIVE", "INACTIVE"]).describe("Market status"),
       type: z32.string().describe("Market type (PRIMARY, SINGLE_COUNTRY, MULTI_COUNTRY, CONTINENT)"),
+      regions: z32.array(
+        z32.object({
+          id: z32.string().describe("Region GID"),
+          name: z32.string().describe("Region name"),
+          countryCode: z32.string().optional().describe("ISO country code")
+        })
+      ).optional().describe("Countries in this market"),
       currencySettings: z32.object({
         baseCurrency: z32.object({
           currencyCode: z32.string().describe("Base currency code (e.g., USD, EUR)")
@@ -8901,7 +9222,22 @@ var inputSchema41 = z43.object({
   ),
   name: z43.string().min(1).optional().describe("New market name"),
   handle: z43.string().optional().describe("New URL handle/slug for the market"),
-  enabled: z43.boolean().optional().describe("Whether the market should be enabled")
+  enabled: z43.boolean().optional().describe(
+    "Whether the market should be enabled (status: ACTIVE). Set to true to activate the market, false to deactivate."
+  ),
+  countryCodesToAdd: z43.array(z43.string().length(2)).optional().describe(
+    'Country codes to ADD to this market (ISO 3166-1 alpha-2). Example: ["CA", "MX"] to add Canada and Mexico'
+  ),
+  countryCodesToRemove: z43.array(z43.string().length(2)).optional().describe(
+    'Country codes to REMOVE from this market (ISO 3166-1 alpha-2). Example: ["US"] to remove United States'
+  ),
+  baseCurrency: z43.string().length(3).optional().describe(
+    'Base currency code for the market (ISO 4217). Example: "USD", "EUR", "CAD", "GBP".'
+  ),
+  localCurrencies: z43.boolean().optional().describe(
+    "Whether to enable local currencies for better customer experience. When true, prices are converted to customer local currency."
+  ),
+  removeCurrencySettings: z43.boolean().optional().describe("Set to true to remove currency settings and use store defaults.")
 });
 var outputSchema41 = z43.object({
   id: z43.string().describe("Updated market GID"),
@@ -8921,6 +9257,23 @@ var handleUpdateMarket = async (context, params) => {
   if (params.enabled !== void 0) {
     input.enabled = params.enabled;
   }
+  if (params.countryCodesToAdd !== void 0 && params.countryCodesToAdd.length > 0) {
+    input.countryCodesToAdd = params.countryCodesToAdd;
+  }
+  if (params.countryCodesToRemove !== void 0 && params.countryCodesToRemove.length > 0) {
+    input.countryCodesToRemove = params.countryCodesToRemove;
+  }
+  if (params.removeCurrencySettings) {
+    input.removeCurrencySettings = true;
+  } else if (params.baseCurrency !== void 0 || params.localCurrencies !== void 0) {
+    input.currencySettings = {};
+    if (params.baseCurrency !== void 0) {
+      input.currencySettings.baseCurrency = params.baseCurrency;
+    }
+    if (params.localCurrencies !== void 0) {
+      input.currencySettings.localCurrencies = params.localCurrencies;
+    }
+  }
   const market = await updateMarket(params.id, input);
   log.debug(`Updated market: ${market.id}`);
   return market;
@@ -8930,7 +9283,7 @@ function registerUpdateMarketTool() {
     {
       name: "update-market",
       title: "Update Market",
-      description: "Update an existing market's properties. Only provided fields are updated; omitted fields remain unchanged. Can update: name, handle, enabled status. **Prerequisites:** get-market to view current values before updating. **Follow-ups:** get-market (to verify), delete-market.",
+      description: "Update an existing market's properties. Only provided fields are updated; omitted fields remain unchanged. Can update: name, handle, enabled status, regions (add/remove countries), and currency settings. **Regions:** Use countryCodesToAdd/countryCodesToRemove to manage countries. **Currency:** Set baseCurrency and localCurrencies, or use removeCurrencySettings to reset. **Prerequisites:** get-market to view current values before updating. **Follow-ups:** get-market (to verify), delete-market.",
       inputSchema: inputSchema41,
       outputSchema: outputSchema41,
       // AI Agent Optimization
@@ -9347,6 +9700,790 @@ function registerUpdateProductTool() {
   );
 }
 
+// src/tools/create-web-presence.ts
+import { z as z48 } from "zod";
+var inputSchema46 = z48.object({
+  defaultLocale: z48.string().min(1).describe(
+    'Default locale for the web presence (required). Use locale codes like "en-CA", "fr-FR", "de-DE". This locale will be served when the domain root or subfolder is accessed.'
+  ),
+  domainId: z48.string().optional().describe(
+    'Domain GID for custom domain configuration (e.g., "gid://shopify/Domain/123"). Mutually exclusive with subfolderSuffix - provide one or the other, not both. Use get-market to find available domains.'
+  ),
+  subfolderSuffix: z48.string().optional().describe(
+    'Subfolder suffix for URL structure (e.g., "ca" for /en-ca, "us" for /en-us). Only ASCII characters allowed. Mutually exclusive with domainId - provide one or the other, not both.'
+  ),
+  alternateLocales: z48.array(z48.string()).optional().describe(
+    'Additional locales for this web presence. Example: ["fr-CA", "es-CA"] for Canadian French and Spanish support. These will be available as language-specific subfolders.'
+  )
+});
+var outputSchema46 = z48.object({
+  id: z48.string().describe("Created web presence GID"),
+  defaultLocale: z48.object({
+    locale: z48.string().describe("Locale code"),
+    name: z48.string().describe("Locale display name")
+  }),
+  alternateLocales: z48.array(
+    z48.object({
+      locale: z48.string(),
+      name: z48.string()
+    })
+  ).optional(),
+  subfolderSuffix: z48.string().optional().describe("Subfolder suffix if configured"),
+  domain: z48.object({
+    host: z48.string().describe("Domain hostname")
+  }).optional().describe("Domain if configured")
+});
+var handleCreateWebPresence = async (context, params) => {
+  log.debug(`Creating web presence on shop: ${context.shopDomain}`);
+  const input = {
+    defaultLocale: params.defaultLocale
+  };
+  if (params.domainId !== void 0) {
+    input.domainId = params.domainId;
+  }
+  if (params.subfolderSuffix !== void 0) {
+    input.subfolderSuffix = params.subfolderSuffix;
+  }
+  if (params.alternateLocales !== void 0) {
+    input.alternateLocales = params.alternateLocales;
+  }
+  const webPresence = await createWebPresence(input);
+  log.debug(`Created web presence: ${webPresence.id}`);
+  return webPresence;
+};
+function registerCreateWebPresenceTool() {
+  registerContextAwareTool(
+    {
+      name: "create-web-presence",
+      title: "Create Web Presence",
+      description: "Create a new web presence for SEO URL configuration. Web presences define how URLs are structured for markets and locales. Provide defaultLocale (required) and either domainId (for custom domains like example.ca) OR subfolderSuffix (for subfolders like /en-ca) - these are mutually exclusive. Optionally add alternateLocales for multi-language support. **Typical workflow:** create-market \u2192 create-web-presence \u2192 enable-shop-locale. **Prerequisites:** Store must have Markets feature enabled. Locale must be enabled in shop settings. **Follow-ups:** list-web-presences, update-web-presence, get-market.",
+      inputSchema: inputSchema46,
+      outputSchema: outputSchema46,
+      // AI Agent Optimization
+      category: "market",
+      relationships: {
+        relatedTools: ["list-web-presences", "create-market", "get-market"],
+        followUps: ["update-web-presence", "list-web-presences", "get-market"]
+      },
+      // MCP Tool Annotations (Epic 9.5 - MCP Best Practices)
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        // Creating web presences is not idempotent
+        openWorldHint: true
+      }
+    },
+    handleCreateWebPresence
+  );
+}
+
+// src/tools/delete-web-presence.ts
+import { z as z49 } from "zod";
+var inputSchema47 = z49.object({
+  id: webPresenceIdSchema.describe(
+    'Web presence GID to delete (e.g., "gid://shopify/MarketWebPresence/123"). Use list-web-presences or get-market to find web presence IDs.'
+  )
+});
+var outputSchema47 = z49.object({
+  deletedId: z49.string().describe("The GID of the deleted web presence"),
+  success: z49.boolean().describe("Whether the deletion was successful"),
+  message: z49.string().describe("Confirmation message")
+});
+var handleDeleteWebPresence = async (context, params) => {
+  log.debug(`Deleting web presence ${params.id} on shop: ${context.shopDomain}`);
+  const deletedId = await deleteWebPresence(params.id);
+  log.debug(`Deleted web presence: ${deletedId}`);
+  return {
+    deletedId,
+    success: true,
+    message: `Web presence ${deletedId} has been deleted. Note: URLs previously served by this web presence may no longer resolve correctly. Consider setting up URL redirects if needed.`
+  };
+};
+function registerDeleteWebPresenceTool() {
+  registerContextAwareTool(
+    {
+      name: "delete-web-presence",
+      title: "Delete Web Presence",
+      description: "\u26A0\uFE0F **WARNING: SEO IMPACT** - Delete a web presence (SEO URL configuration). Deleting a web presence removes the URL structure for a market. URLs that were previously served by this web presence will no longer resolve, which can negatively impact SEO and break existing links. Consider setting up URL redirects before or after deletion to preserve SEO value. **Prerequisites:** list-web-presences or get-market to find web presence IDs. **Follow-ups:** create-redirect (to preserve SEO), list-web-presences.",
+      inputSchema: inputSchema47,
+      outputSchema: outputSchema47,
+      // AI Agent Optimization
+      category: "market",
+      relationships: {
+        relatedTools: ["list-web-presences", "get-market", "create-redirect"],
+        followUps: ["create-redirect", "list-web-presences"]
+      },
+      // MCP Tool Annotations (Epic 9.5 - MCP Best Practices)
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        // This is a destructive operation
+        idempotentHint: false,
+        // Deleting twice fails on second attempt
+        openWorldHint: true
+      }
+    },
+    handleDeleteWebPresence
+  );
+}
+
+// src/tools/list-web-presences.ts
+import { z as z50 } from "zod";
+var inputSchema48 = z50.object({
+  first: z50.number().int().min(1).max(50).optional().default(10).describe("Number of web presences to return (1-50). Default: 10"),
+  after: z50.string().optional().describe(
+    "Pagination cursor from previous response. Use the endCursor value from the previous page to get the next page of results."
+  )
+});
+var outputSchema48 = z50.object({
+  webPresences: z50.array(
+    z50.object({
+      id: z50.string().describe("Web presence GID"),
+      defaultLocale: z50.object({
+        locale: z50.string().describe("Locale code (e.g., en-CA)"),
+        name: z50.string().describe("Locale display name")
+      }),
+      alternateLocales: z50.array(
+        z50.object({
+          locale: z50.string().describe("Locale code"),
+          name: z50.string().describe("Locale display name")
+        })
+      ).optional().describe("Additional locales supported by this web presence"),
+      subfolderSuffix: z50.string().optional().describe('Subfolder suffix (e.g., "ca" for /en-ca). Null if using a domain.'),
+      domain: z50.object({
+        host: z50.string().describe("Custom domain hostname")
+      }).optional().describe("Custom domain configuration. Null if using subfolders."),
+      rootUrls: z50.array(
+        z50.object({
+          locale: z50.string().describe("Locale code"),
+          url: z50.string().describe("Full URL for this locale")
+        })
+      ).optional().describe("Root URLs for each locale")
+    })
+  ),
+  pageInfo: z50.object({
+    hasNextPage: z50.boolean().describe("Whether more pages exist"),
+    endCursor: z50.string().nullable().describe("Cursor for next page")
+  }),
+  summary: z50.object({
+    totalReturned: z50.number().describe("Number of web presences in this response"),
+    hasMore: z50.boolean().describe("Whether more web presences are available"),
+    hint: z50.string().describe("Suggestion for next action")
+  }).describe("AI-friendly summary for context management")
+});
+var handleListWebPresences = async (context, params) => {
+  log.debug(`Listing web presences on shop: ${context.shopDomain}`);
+  const result = await listWebPresences(params.first, params.after);
+  log.debug(`Listed ${result.webPresences.length} web presences via tool`);
+  return {
+    ...result,
+    summary: {
+      totalReturned: result.webPresences.length,
+      hasMore: result.pageInfo.hasNextPage,
+      hint: result.pageInfo.hasNextPage ? `Use "after" parameter with value "${result.pageInfo.endCursor}" to fetch next page` : "All web presences returned"
+    }
+  };
+};
+function registerListWebPresencesTool() {
+  registerContextAwareTool(
+    {
+      name: "list-web-presences",
+      title: "List Web Presences",
+      description: 'List all web presences (SEO URL configurations) in the Shopify store with pagination. Web presences define how URLs are structured for different markets and locales. Each web presence can use either a custom domain (e.g., example.ca) or subfolders (e.g., /en-ca). Returns id, defaultLocale, alternateLocales, subfolderSuffix, domain, and rootUrls. Response includes summary with totalReturned, hasMore, and pagination hint. **Pagination:** Use "after" cursor from pageInfo.endCursor to get next page. **Prerequisites:** Store must have Markets feature enabled. **Follow-ups:** create-web-presence, update-web-presence, get-market (to see web presences by market).',
+      inputSchema: inputSchema48,
+      outputSchema: outputSchema48,
+      // AI Agent Optimization
+      category: "market",
+      relationships: {
+        relatedTools: ["list-markets", "get-market"],
+        followUps: ["create-web-presence", "update-web-presence", "delete-web-presence"]
+      },
+      // MCP Tool Annotations (Epic 9.5 - MCP Best Practices)
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
+    },
+    handleListWebPresences
+  );
+}
+
+// src/tools/update-web-presence.ts
+import { z as z51 } from "zod";
+var inputSchema49 = z51.object({
+  id: webPresenceIdSchema.describe(
+    'Web presence GID to update (e.g., "gid://shopify/MarketWebPresence/123"). Use list-web-presences or get-market to find web presence IDs.'
+  ),
+  defaultLocale: z51.string().optional().describe(
+    'New default locale for the web presence. Use locale codes like "en-CA", "fr-FR", "de-DE". The locale must be enabled in shop settings.'
+  ),
+  alternateLocales: z51.array(z51.string()).optional().describe(
+    'New alternate locales (replaces existing). Example: ["fr-CA", "es-CA"]. Pass an empty array [] to remove all alternate locales. All locales must be enabled in shop settings.'
+  ),
+  subfolderSuffix: z51.string().optional().describe(
+    'New subfolder suffix (e.g., "canada" to change from /en-ca to /en-canada). Only ASCII characters allowed. Can only be changed for subfolder-based web presences, not domain-based.'
+  )
+});
+var outputSchema49 = z51.object({
+  id: z51.string().describe("Updated web presence GID"),
+  defaultLocale: z51.object({
+    locale: z51.string().describe("Locale code"),
+    name: z51.string().describe("Locale display name")
+  }),
+  alternateLocales: z51.array(
+    z51.object({
+      locale: z51.string(),
+      name: z51.string()
+    })
+  ).optional(),
+  subfolderSuffix: z51.string().optional().describe("Subfolder suffix if configured"),
+  domain: z51.object({
+    host: z51.string().describe("Domain hostname")
+  }).optional().describe("Domain if configured")
+});
+var handleUpdateWebPresence = async (context, params) => {
+  log.debug(`Updating web presence ${params.id} on shop: ${context.shopDomain}`);
+  const input = {};
+  if (params.defaultLocale !== void 0) {
+    input.defaultLocale = params.defaultLocale;
+  }
+  if (params.alternateLocales !== void 0) {
+    input.alternateLocales = params.alternateLocales;
+  }
+  if (params.subfolderSuffix !== void 0) {
+    input.subfolderSuffix = params.subfolderSuffix;
+  }
+  const webPresence = await updateWebPresence(params.id, input);
+  log.debug(`Updated web presence: ${webPresence.id}`);
+  return webPresence;
+};
+function registerUpdateWebPresenceTool() {
+  registerContextAwareTool(
+    {
+      name: "update-web-presence",
+      title: "Update Web Presence",
+      description: "Update an existing web presence configuration. Allows changing defaultLocale, alternateLocales (replaces existing), and subfolderSuffix. Only provided fields are updated; others remain unchanged. Note: subfolderSuffix can only be changed for subfolder-based web presences. **Prerequisites:** list-web-presences or get-market to find web presence IDs. **Follow-ups:** list-web-presences, get-market.",
+      inputSchema: inputSchema49,
+      outputSchema: outputSchema49,
+      // AI Agent Optimization
+      category: "market",
+      relationships: {
+        relatedTools: ["list-web-presences", "get-market"],
+        followUps: ["list-web-presences", "get-market"]
+      },
+      // MCP Tool Annotations (Epic 9.5 - MCP Best Practices)
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        // Same update with same params produces same result
+        openWorldHint: true
+      }
+    },
+    handleUpdateWebPresence
+  );
+}
+
+// src/tools/disable-shop-locale.ts
+import { z as z52 } from "zod";
+
+// src/shopify/translations.ts
+var LIST_SHOP_LOCALES_QUERY = `
+query ShopLocales($published: Boolean) {
+  shopLocales(published: $published) {
+    locale
+    name
+    primary
+    published
+  }
+}
+`;
+var SHOP_LOCALE_ENABLE_MUTATION = `
+mutation ShopLocaleEnable($locale: String!, $marketWebPresenceIds: [ID!]) {
+  shopLocaleEnable(locale: $locale, marketWebPresenceIds: $marketWebPresenceIds) {
+    shopLocale {
+      locale
+      name
+      published
+    }
+    userErrors { field message }
+  }
+}
+`;
+var SHOP_LOCALE_DISABLE_MUTATION = `
+mutation ShopLocaleDisable($locale: String!) {
+  shopLocaleDisable(locale: $locale) {
+    locale
+    userErrors { field message }
+  }
+}
+`;
+var TRANSLATIONS_REGISTER_MUTATION = `
+mutation TranslationsRegister($resourceId: ID!, $translations: [TranslationInput!]!) {
+  translationsRegister(resourceId: $resourceId, translations: $translations) {
+    translations {
+      key
+      value
+      locale
+    }
+    userErrors { field message }
+  }
+}
+`;
+var TRANSLATIONS_REMOVE_MUTATION = `
+mutation TranslationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {
+  translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {
+    translations { key locale }
+    userErrors { field message }
+  }
+}
+`;
+async function listShopLocales(options = {}) {
+  const client = await getShopifyClient();
+  log.debug(`Listing shop locales: published=${options.published}`);
+  const response = await withRateLimit(
+    () => client.graphql.request(LIST_SHOP_LOCALES_QUERY, {
+      variables: { published: options.published }
+    }),
+    "list-shop-locales"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const locales = response.data?.shopLocales;
+  if (!locales) {
+    throw new Error("No response data from shopLocales query");
+  }
+  log.debug(`Listed ${locales.length} shop locales`);
+  return locales;
+}
+async function enableShopLocale(locale, marketWebPresenceIds) {
+  const client = await getShopifyClient();
+  log.debug(`Enabling shop locale: ${locale}`);
+  const variables = { locale };
+  if (marketWebPresenceIds && marketWebPresenceIds.length > 0) {
+    variables.marketWebPresenceIds = marketWebPresenceIds;
+  }
+  const response = await withRateLimit(
+    () => client.graphql.request(SHOP_LOCALE_ENABLE_MUTATION, {
+      variables
+    }),
+    "enable-shop-locale"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const result = response.data?.shopLocaleEnable;
+  if (!result) {
+    throw new Error("No response data from shopLocaleEnable mutation");
+  }
+  if (result.userErrors && result.userErrors.length > 0) {
+    throw new ShopifyUserErrorException(result.userErrors);
+  }
+  if (!result.shopLocale) {
+    throw new Error("Shop locale enable succeeded but no locale was returned");
+  }
+  log.debug(`Enabled shop locale: ${result.shopLocale.locale}`);
+  return result.shopLocale;
+}
+async function disableShopLocale(locale) {
+  const client = await getShopifyClient();
+  log.debug(`Disabling shop locale: ${locale}`);
+  const response = await withRateLimit(
+    () => client.graphql.request(SHOP_LOCALE_DISABLE_MUTATION, {
+      variables: { locale }
+    }),
+    "disable-shop-locale"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const result = response.data?.shopLocaleDisable;
+  if (!result) {
+    throw new Error("No response data from shopLocaleDisable mutation");
+  }
+  if (result.userErrors && result.userErrors.length > 0) {
+    throw new ShopifyUserErrorException(result.userErrors);
+  }
+  if (!result.locale) {
+    throw new Error("Shop locale disable succeeded but no locale was returned");
+  }
+  log.debug(`Disabled shop locale: ${result.locale}`);
+  return result.locale;
+}
+async function registerTranslations(resourceId, translations) {
+  const client = await getShopifyClient();
+  log.debug(`Registering ${translations.length} translations for resource: ${resourceId}`);
+  const response = await withRateLimit(
+    () => client.graphql.request(TRANSLATIONS_REGISTER_MUTATION, {
+      variables: { resourceId, translations }
+    }),
+    "register-translations"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const result = response.data?.translationsRegister;
+  if (!result) {
+    throw new Error("No response data from translationsRegister mutation");
+  }
+  if (result.userErrors && result.userErrors.length > 0) {
+    throw new ShopifyUserErrorException(result.userErrors);
+  }
+  log.debug(`Registered ${result.translations.length} translations`);
+  return result.translations;
+}
+async function removeTranslations(resourceId, translationKeys, locales) {
+  const client = await getShopifyClient();
+  log.debug(
+    `Removing translations for resource: ${resourceId}, keys: ${translationKeys.join(", ")}, locales: ${locales.join(", ")}`
+  );
+  const response = await withRateLimit(
+    () => client.graphql.request(TRANSLATIONS_REMOVE_MUTATION, {
+      variables: { resourceId, translationKeys, locales }
+    }),
+    "remove-translations"
+  );
+  if (response.errors && response.errors.length > 0) {
+    const errorMessage = response.errors.map((e) => e.message).join(", ");
+    throw new Error(`GraphQL error: ${errorMessage}`);
+  }
+  const result = response.data?.translationsRemove;
+  if (!result) {
+    throw new Error("No response data from translationsRemove mutation");
+  }
+  if (result.userErrors && result.userErrors.length > 0) {
+    throw new ShopifyUserErrorException(result.userErrors);
+  }
+  log.debug(`Removed ${result.translations.length} translations`);
+  return result.translations;
+}
+
+// src/tools/disable-shop-locale.ts
+var inputSchema50 = z52.object({
+  locale: localeCodeSchema.describe(
+    'Locale code to disable (required). Use ISO 639-1 format (e.g., "fr", "de", "es") or with region (e.g., "fr-CA", "pt-BR"). \u26A0\uFE0F WARNING: Cannot disable the primary locale. Attempting to do so will result in an error.'
+  )
+});
+var outputSchema50 = z52.object({
+  disabledLocale: z52.string().describe("The locale code that was disabled"),
+  warning: z52.string().describe("Warning about translation removal")
+});
+var handleDisableShopLocale = async (context, params) => {
+  log.debug(`Disabling shop locale "${params.locale}" on shop: ${context.shopDomain}`);
+  const disabledLocale = await disableShopLocale(params.locale);
+  log.debug(`Disabled shop locale: ${disabledLocale}`);
+  return {
+    disabledLocale,
+    warning: `Locale "${disabledLocale}" has been disabled. All translations for this locale have been removed.`
+  };
+};
+function registerDisableShopLocaleTool() {
+  registerContextAwareTool(
+    {
+      name: "disable-shop-locale",
+      title: "Disable Shop Locale",
+      description: 'Disable a shop locale (language) for the Shopify store. Provide a locale code (e.g., "fr", "de", "es") to disable that language. \u26A0\uFE0F **WARNING:** Disabling a locale will permanently remove ALL translations for that language. \u26A0\uFE0F **Cannot disable the primary locale.** Use list-shop-locales to see which locale is primary. Returns the disabled locale code with a warning about translation removal. **Prerequisites:** list-shop-locales to verify the locale exists and is not primary. **Follow-ups:** list-shop-locales to confirm removal.',
+      inputSchema: inputSchema50,
+      outputSchema: outputSchema50,
+      // AI Agent Optimization
+      category: "translation",
+      relationships: {
+        relatedTools: ["list-shop-locales", "enable-shop-locale"],
+        prerequisites: ["list-shop-locales"],
+        followUps: ["list-shop-locales"]
+      },
+      // MCP Tool Annotations (Epic 9.5 - MCP Best Practices)
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        // Removes all translations for the locale
+        idempotentHint: false,
+        // Disabling twice will error
+        openWorldHint: true
+      }
+    },
+    handleDisableShopLocale
+  );
+}
+
+// src/tools/enable-shop-locale.ts
+import { z as z53 } from "zod";
+var inputSchema51 = z53.object({
+  locale: localeCodeSchema.describe(
+    'Locale code to enable (required). Use ISO 639-1 format (e.g., "fr", "de", "es") or with region (e.g., "fr-CA", "pt-BR"). Common codes: fr (French), de (German), es (Spanish), it (Italian), ja (Japanese), zh (Chinese).'
+  ),
+  marketWebPresenceIds: z53.array(webPresenceIdSchema).optional().describe(
+    'Optional array of MarketWebPresence GIDs to associate this locale with. Use list-web-presences to get available web presence IDs. Example: ["gid://shopify/MarketWebPresence/123"]'
+  )
+});
+var outputSchema51 = z53.object({
+  locale: z53.string().describe("Enabled locale code"),
+  name: z53.string().describe("Display name of the locale"),
+  published: z53.boolean().describe("Whether the locale is published")
+});
+var handleEnableShopLocale = async (context, params) => {
+  log.debug(`Enabling shop locale "${params.locale}" on shop: ${context.shopDomain}`);
+  const result = await enableShopLocale(params.locale, params.marketWebPresenceIds);
+  log.debug(`Enabled shop locale: ${result.locale}`);
+  return result;
+};
+function registerEnableShopLocaleTool() {
+  registerContextAwareTool(
+    {
+      name: "enable-shop-locale",
+      title: "Enable Shop Locale",
+      description: 'Enable a new shop locale (language) for the Shopify store. Provide a locale code (e.g., "fr", "de", "es", "fr-CA") to enable that language. Optionally associate with specific web presences for market-specific localization. Returns the enabled locale with locale code, name, and published status. **Note:** Enabling a locale makes it available for translations, but content still needs to be translated. **Typical workflow:** list-shop-locales \u2192 enable-shop-locale \u2192 register-translations. **Prerequisites:** list-shop-locales to see current locales. **Follow-ups:** register-translations to add translated content.',
+      inputSchema: inputSchema51,
+      outputSchema: outputSchema51,
+      // AI Agent Optimization
+      category: "translation",
+      relationships: {
+        relatedTools: ["list-shop-locales", "disable-shop-locale"],
+        prerequisites: ["list-shop-locales"],
+        followUps: ["register-translations"]
+      },
+      // MCP Tool Annotations (Epic 9.5 - MCP Best Practices)
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        // Enabling same locale twice is idempotent
+        openWorldHint: true
+      }
+    },
+    handleEnableShopLocale
+  );
+}
+
+// src/tools/list-shop-locales.ts
+import { z as z54 } from "zod";
+var inputSchema52 = z54.object({
+  published: z54.boolean().optional().describe(
+    "If true, only return published locales (visible to customers). If false or omitted, returns all enabled locales including unpublished ones."
+  )
+});
+var outputSchema52 = z54.object({
+  locales: z54.array(
+    z54.object({
+      locale: z54.string().describe('Locale code (e.g., "en", "fr", "de", "fr-CA")'),
+      name: z54.string().describe('Display name (e.g., "English", "French", "German")'),
+      primary: z54.boolean().describe("Whether this is the primary locale"),
+      published: z54.boolean().describe("Whether this locale is published (visible to customers)")
+    })
+  ),
+  summary: z54.object({
+    totalLocales: z54.number().describe("Total number of locales returned"),
+    primaryLocale: z54.string().describe("The primary locale code"),
+    publishedCount: z54.number().describe("Number of published locales"),
+    hint: z54.string().describe("Suggestion for next action")
+  }).describe("AI-friendly summary for context management")
+});
+var handleListShopLocales = async (context, params) => {
+  log.debug(`Listing shop locales on shop: ${context.shopDomain}`);
+  const locales = await listShopLocales({ published: params.published });
+  log.debug(`Listed ${locales.length} shop locales via tool`);
+  const primaryLocale = locales.find((l) => l.primary)?.locale || "unknown";
+  const publishedCount = locales.filter((l) => l.published).length;
+  return {
+    locales,
+    summary: {
+      totalLocales: locales.length,
+      primaryLocale,
+      publishedCount,
+      hint: locales.length === 0 ? "No locales found. Shop may not have multi-language enabled." : locales.length === 1 ? "Only primary locale enabled. Use enable-shop-locale to add more languages." : `Shop has ${locales.length} locales (${publishedCount} published). Use enable-shop-locale to add more, or register-translations to add content.`
+    }
+  };
+};
+function registerListShopLocalesTool() {
+  registerContextAwareTool(
+    {
+      name: "list-shop-locales",
+      title: "List Shop Locales",
+      description: "List all enabled shop locales (languages) for the Shopify store. Returns locale code, name, primary flag, and published flag for each locale. Use published=true to filter to only customer-visible locales. Response includes summary with totalLocales, primaryLocale, publishedCount. **Typical workflow:** list-shop-locales \u2192 enable-shop-locale (add language) \u2192 register-translations (add content). **Prerequisites:** Store must have multi-language feature enabled. **Follow-ups:** enable-shop-locale, register-translations.",
+      inputSchema: inputSchema52,
+      outputSchema: outputSchema52,
+      // AI Agent Optimization
+      category: "translation",
+      relationships: {
+        relatedTools: ["enable-shop-locale", "disable-shop-locale"],
+        followUps: ["enable-shop-locale", "register-translations"]
+      },
+      // MCP Tool Annotations (Epic 9.5 - MCP Best Practices)
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
+    },
+    handleListShopLocales
+  );
+}
+
+// src/tools/register-translations.ts
+import { z as z55 } from "zod";
+var translationInputSchema = z55.object({
+  locale: localeCodeSchema.describe('Target locale code (e.g., "fr", "de", "fr-CA")'),
+  key: z55.string().min(1).describe(
+    'Translation key (field identifier). Common keys: "title", "body_html", "description", "meta_title", "meta_description", "handle". Query the resource to see available translatable fields.'
+  ),
+  value: z55.string().describe("Translated value for this field"),
+  translatableContentDigest: z55.string().min(1).describe(
+    "Content digest hash from the translatable resource (required). This ensures the translation is linked to the correct version of the source content. Query the resource's translatableContent to get this value."
+  ),
+  marketId: z55.string().optional().describe(
+    'Optional market GID for market-specific translations. Use list-markets to get market IDs. Example: "gid://shopify/Market/123"'
+  )
+});
+var inputSchema53 = z55.object({
+  resourceId: gidSchema().describe(
+    'GID of the translatable resource (required). Examples: "gid://shopify/Product/123", "gid://shopify/Collection/456", "gid://shopify/Page/789", "gid://shopify/Article/321"'
+  ),
+  translations: z55.array(translationInputSchema).min(1).max(100).describe(
+    "Array of translations to register (1-100 items). Each translation must include locale, key, value, and translatableContentDigest."
+  )
+});
+var outputSchema53 = z55.object({
+  translations: z55.array(
+    z55.object({
+      key: z55.string().describe("Translation key"),
+      value: z55.string().describe("Translated value"),
+      locale: z55.string().describe("Target locale")
+    })
+  ),
+  summary: z55.object({
+    registered: z55.number().describe("Number of translations registered"),
+    resourceId: z55.string().describe("Resource that was translated"),
+    locales: z55.array(z55.string()).describe("Unique locales translated")
+  }).describe("AI-friendly summary")
+});
+var handleRegisterTranslations = async (context, params) => {
+  log.debug(
+    `Registering ${params.translations.length} translations for resource: ${params.resourceId} on shop: ${context.shopDomain}`
+  );
+  const translations = await registerTranslations(params.resourceId, params.translations);
+  log.debug(`Registered ${translations.length} translations`);
+  const locales = [...new Set(translations.map((t) => t.locale))];
+  return {
+    translations,
+    summary: {
+      registered: translations.length,
+      resourceId: params.resourceId,
+      locales
+    }
+  };
+};
+function registerRegisterTranslationsTool() {
+  registerContextAwareTool(
+    {
+      name: "register-translations",
+      title: "Register Translations",
+      description: "Register translations for a translatable Shopify resource. Creates or updates translations for products, collections, pages, articles, etc. Requires resourceId (GID) and array of translations with locale, key, value, and translatableContentDigest. \u26A0\uFE0F **Important:** The translatableContentDigest is required. This hash ensures translations match the source content version. Query the resource's translatableContent field to get digests for each translatable field. **Common keys:** title, body_html, description, meta_title, meta_description, handle. **Typical workflow:** get-product \u2192 query translatableResource \u2192 register-translations. **Prerequisites:** enable-shop-locale (ensure target locale is enabled), get-product/get-page (get resource and content digests). **Follow-ups:** Query resource to verify translations.",
+      inputSchema: inputSchema53,
+      outputSchema: outputSchema53,
+      // AI Agent Optimization
+      category: "translation",
+      relationships: {
+        relatedTools: ["remove-translations", "list-shop-locales"],
+        prerequisites: ["enable-shop-locale", "get-product"],
+        followUps: ["get-product"]
+      },
+      // MCP Tool Annotations (Epic 9.5 - MCP Best Practices)
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        // Registering same translation twice updates it
+        openWorldHint: true
+      }
+    },
+    handleRegisterTranslations
+  );
+}
+
+// src/tools/remove-translations.ts
+import { z as z56 } from "zod";
+var inputSchema54 = z56.object({
+  resourceId: gidSchema().describe(
+    'GID of the translatable resource (required). Examples: "gid://shopify/Product/123", "gid://shopify/Collection/456", "gid://shopify/Page/789", "gid://shopify/Article/321"'
+  ),
+  translationKeys: z56.array(z56.string().min(1)).min(1).describe(
+    'Array of translation keys to remove (required). Common keys: "title", "body_html", "description", "meta_title", "meta_description". Example: ["title", "body_html"]'
+  ),
+  locales: z56.array(localeCodeSchema).min(1).describe(
+    'Array of locale codes to remove translations for (required). Example: ["fr", "de"] to remove French and German translations.'
+  )
+});
+var outputSchema54 = z56.object({
+  removed: z56.array(
+    z56.object({
+      key: z56.string().describe("Removed translation key"),
+      locale: z56.string().describe("Removed locale")
+    })
+  ),
+  summary: z56.object({
+    removedCount: z56.number().describe("Number of translations removed"),
+    resourceId: z56.string().describe("Resource that was updated"),
+    locales: z56.array(z56.string()).describe("Locales affected"),
+    keys: z56.array(z56.string()).describe("Keys removed")
+  }).describe("AI-friendly summary")
+});
+var handleRemoveTranslations = async (context, params) => {
+  log.debug(
+    `Removing translations for resource: ${params.resourceId}, keys: ${params.translationKeys.join(", ")}, locales: ${params.locales.join(", ")} on shop: ${context.shopDomain}`
+  );
+  const removed = await removeTranslations(
+    params.resourceId,
+    params.translationKeys,
+    params.locales
+  );
+  log.debug(`Removed ${removed.length} translations`);
+  return {
+    removed,
+    summary: {
+      removedCount: removed.length,
+      resourceId: params.resourceId,
+      locales: params.locales,
+      keys: params.translationKeys
+    }
+  };
+};
+function registerRemoveTranslationsTool() {
+  registerContextAwareTool(
+    {
+      name: "remove-translations",
+      title: "Remove Translations",
+      description: 'Remove translations from a translatable Shopify resource. Deletes specified translations by key and locale from products, collections, pages, articles, etc. Requires resourceId (GID), translationKeys array, and locales array. \u26A0\uFE0F **Warning:** This permanently deletes the specified translations. This action cannot be undone. Returns array of removed translations (key + locale pairs). **Example:** Remove French and German translations for title and description: translationKeys=["title", "body_html"], locales=["fr", "de"]. **Prerequisites:** Query resource to verify which translations exist. **Follow-ups:** Query resource to confirm removal.',
+      inputSchema: inputSchema54,
+      outputSchema: outputSchema54,
+      // AI Agent Optimization
+      category: "translation",
+      relationships: {
+        relatedTools: ["register-translations", "list-shop-locales"],
+        followUps: ["get-product"]
+      },
+      // MCP Tool Annotations (Epic 9.5 - MCP Best Practices)
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        // Permanently removes translations
+        idempotentHint: false,
+        // Removing twice may error or behave differently
+        openWorldHint: true
+      }
+    },
+    handleRemoveTranslations
+  );
+}
+
 // src/tools/index.ts
 function setupToolHandlers(server) {
   server.server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -9448,6 +10585,15 @@ function registerAllTools(server) {
   registerGetMarketTool();
   registerListMarketsTool();
   registerUpdateMarketTool();
+  registerCreateWebPresenceTool();
+  registerDeleteWebPresenceTool();
+  registerListWebPresencesTool();
+  registerUpdateWebPresenceTool();
+  registerDisableShopLocaleTool();
+  registerEnableShopLocaleTool();
+  registerListShopLocalesTool();
+  registerRegisterTranslationsTool();
+  registerRemoveTranslationsTool();
   const toolCount = getRegisteredTools().length;
   log.debug(`Tool registration complete: ${toolCount} tools registered`);
 }