@brainerce/mcp-server 2.6.0 → 2.7.0

package/dist/bin/http.js

@@ -11215,7 +11215,17 @@ async function handleGetRequiredPages(args) {
 var import_zod5 = require("zod");
 
 // src/utils/fetch-store-info.ts
-async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com") {
+var KNOWN_API_URLS = {
+  production: "https://api.brainerce.com",
+  staging: "https://api-staging.brainerce.com"
+};
+var ConnectionNotFoundError = class extends Error {
+  constructor(connectionId, baseUrl) {
+    super(`Connection "${connectionId}" not found at ${baseUrl}`);
+    this.code = "NOT_FOUND";
+  }
+};
+async function fetchStoreInfo(connectionId, baseUrl = KNOWN_API_URLS.production) {
   const url = `${baseUrl}/api/vc/${connectionId}/info`;
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), 1e4);
@@ -11224,23 +11234,23 @@ async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com
     res = await fetch(url, { signal: controller.signal });
   } catch (err) {
     if (err.name === "AbortError") {
-      throw new Error("Request timed out");
+      throw new Error(`Request to ${baseUrl} timed out`);
     }
-    throw new Error(`Failed to connect to Brainerce API: ${err.message}`);
+    throw new Error(`Failed to connect to ${baseUrl}: ${err.message}`);
   } finally {
     clearTimeout(timeout);
   }
   if (res.status === 404) {
-    throw new Error(`Connection ID "${connectionId}" not found. Check your dashboard.`);
+    throw new ConnectionNotFoundError(connectionId, baseUrl);
   }
   if (!res.ok) {
-    throw new Error(`API returned status ${res.status}`);
+    throw new Error(`${baseUrl} returned status ${res.status}`);
   }
   let json;
   try {
     json = await res.json();
   } catch {
-    throw new Error("Invalid response from API");
+    throw new Error(`Invalid response from ${baseUrl}`);
   }
   return {
     name: json.name || json.storeName || "My Store",
@@ -11249,6 +11259,38 @@ async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com
     ...json.i18n ? { i18n: json.i18n } : {}
   };
 }
+async function resolveStoreInfo(connectionId, candidateUrls) {
+  const urls = candidateUrls.filter((u, i) => u && candidateUrls.indexOf(u) === i);
+  if (urls.length === 0) {
+    throw new Error("No API URLs to try");
+  }
+  let lastError;
+  let allNotFound = true;
+  for (let i = 0; i < urls.length; i++) {
+    const baseUrl = urls[i];
+    try {
+      const info = await fetchStoreInfo(connectionId, baseUrl);
+      return { info, apiBaseUrl: baseUrl, fellBack: i > 0 };
+    } catch (err) {
+      lastError = err;
+      const isNotFound = err.code === "NOT_FOUND";
+      if (!isNotFound) {
+        allNotFound = false;
+      }
+    }
+  }
+  if (allNotFound) {
+    throw new Error(
+      `Connection "${connectionId}" not found in any known environment (${urls.join(", ")}).`
+    );
+  }
+  throw lastError || new Error("Failed to resolve store info");
+}
+function getCandidateApiUrls() {
+  const explicit = (process.env.BRAINERCE_API_URL || "").replace(/\/$/, "");
+  if (explicit) return [explicit];
+  return [KNOWN_API_URLS.production, KNOWN_API_URLS.staging];
+}
 
 // src/tools/get-store-info.ts
 var GET_STORE_INFO_NAME = "get-store-info";
@@ -11258,21 +11300,18 @@ var GET_STORE_INFO_SCHEMA = {
 };
 async function handleGetStoreInfo(args) {
   try {
-    const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-      /\/$/,
-      ""
-    );
-    const info = await fetchStoreInfo(args.connectionId, baseUrl);
+    const resolved = await resolveStoreInfo(args.connectionId, getCandidateApiUrls());
     return {
       content: [
         {
           type: "text",
           text: JSON.stringify(
             {
-              name: info.name,
-              currency: info.currency,
-              language: info.language,
-              connectionId: args.connectionId
+              name: resolved.info.name,
+              currency: resolved.info.currency,
+              language: resolved.info.language,
+              connectionId: args.connectionId,
+              apiBaseUrl: resolved.apiBaseUrl
             },
             null,
             2
@@ -11293,6 +11332,12 @@ async function handleGetStoreInfo(args) {
 var import_zod6 = require("zod");
 
 // src/utils/fetch-store-capabilities.ts
+var ConnectionNotFoundError2 = class extends Error {
+  constructor(connectionId, baseUrl) {
+    super(`Connection "${connectionId}" not found at ${baseUrl}`);
+    this.code = "NOT_FOUND";
+  }
+};
 async function fetchStoreCapabilities(connectionId, baseUrl = "https://api.brainerce.com") {
   const url = `${baseUrl}/api/vc/${connectionId}/capabilities`;
   const controller = new AbortController();
@@ -11302,24 +11347,51 @@ async function fetchStoreCapabilities(connectionId, baseUrl = "https://api.brain
     res = await fetch(url, { signal: controller.signal });
   } catch (err) {
     if (err.name === "AbortError") {
-      throw new Error("Request timed out");
+      throw new Error(`Request to ${baseUrl} timed out`);
     }
-    throw new Error(`Failed to connect to Brainerce API: ${err.message}`);
+    throw new Error(`Failed to connect to ${baseUrl}: ${err.message}`);
   } finally {
     clearTimeout(timeout);
   }
   if (res.status === 404) {
-    throw new Error(`Connection ID "${connectionId}" not found. Check your dashboard.`);
+    throw new ConnectionNotFoundError2(connectionId, baseUrl);
   }
   if (!res.ok) {
-    throw new Error(`API returned status ${res.status}`);
+    throw new Error(`${baseUrl} returned status ${res.status}`);
   }
   try {
     return await res.json();
   } catch {
-    throw new Error("Invalid response from API");
+    throw new Error(`Invalid response from ${baseUrl}`);
   }
 }
+async function resolveStoreCapabilities(connectionId, candidateUrls) {
+  const urls = candidateUrls.filter((u, i) => u && candidateUrls.indexOf(u) === i);
+  if (urls.length === 0) {
+    throw new Error("No API URLs to try");
+  }
+  let lastError;
+  let allNotFound = true;
+  for (let i = 0; i < urls.length; i++) {
+    const baseUrl = urls[i];
+    try {
+      const capabilities = await fetchStoreCapabilities(connectionId, baseUrl);
+      return { capabilities, apiBaseUrl: baseUrl, fellBack: i > 0 };
+    } catch (err) {
+      lastError = err;
+      const isNotFound = err.code === "NOT_FOUND";
+      if (!isNotFound) {
+        allNotFound = false;
+      }
+    }
+  }
+  if (allNotFound) {
+    throw new Error(
+      `Connection "${connectionId}" not found in any known environment (${urls.join(", ")}).`
+    );
+  }
+  throw lastError || new Error("Failed to resolve store capabilities");
+}
 
 // src/tools/get-store-capabilities.ts
 var GET_STORE_CAPABILITIES_NAME = "get-store-capabilities";
@@ -11437,13 +11509,9 @@ function formatCapabilities(caps) {
 }
 async function handleGetStoreCapabilities(args) {
   try {
-    const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-      /\/$/,
-      ""
-    );
-    const caps = await fetchStoreCapabilities(args.connectionId, baseUrl);
+    const resolved = await resolveStoreCapabilities(args.connectionId, getCandidateApiUrls());
     return {
-      content: [{ type: "text", text: formatCapabilities(caps) }]
+      content: [{ type: "text", text: formatCapabilities(resolved.capabilities) }]
     };
   } catch (error) {
     const message = error instanceof Error ? error.message : "Failed to fetch store capabilities";
@@ -11706,13 +11774,10 @@ var BUILD_STORE_SCHEMA = {
   storeStyle: import_zod7.z.string().optional().describe('Design style (e.g., "minimalist", "luxury", "playful", "dark mode")')
 };
 async function handleBuildStore(args) {
-  const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-    /\/$/,
-    ""
-  );
   let capabilities = null;
   try {
-    capabilities = await fetchStoreCapabilities(args.connectionId, baseUrl);
+    const resolved = await resolveStoreCapabilities(args.connectionId, getCandidateApiUrls());
+    capabilities = resolved.capabilities;
   } catch {
   }
   const bundle = buildStoreBundle({

package/dist/bin/stdio.js

@@ -11213,7 +11213,17 @@ async function handleGetRequiredPages(args) {
 var import_zod5 = require("zod");
 
 // src/utils/fetch-store-info.ts
-async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com") {
+var KNOWN_API_URLS = {
+  production: "https://api.brainerce.com",
+  staging: "https://api-staging.brainerce.com"
+};
+var ConnectionNotFoundError = class extends Error {
+  constructor(connectionId, baseUrl) {
+    super(`Connection "${connectionId}" not found at ${baseUrl}`);
+    this.code = "NOT_FOUND";
+  }
+};
+async function fetchStoreInfo(connectionId, baseUrl = KNOWN_API_URLS.production) {
   const url = `${baseUrl}/api/vc/${connectionId}/info`;
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), 1e4);
@@ -11222,23 +11232,23 @@ async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com
     res = await fetch(url, { signal: controller.signal });
   } catch (err) {
     if (err.name === "AbortError") {
-      throw new Error("Request timed out");
+      throw new Error(`Request to ${baseUrl} timed out`);
     }
-    throw new Error(`Failed to connect to Brainerce API: ${err.message}`);
+    throw new Error(`Failed to connect to ${baseUrl}: ${err.message}`);
   } finally {
     clearTimeout(timeout);
   }
   if (res.status === 404) {
-    throw new Error(`Connection ID "${connectionId}" not found. Check your dashboard.`);
+    throw new ConnectionNotFoundError(connectionId, baseUrl);
   }
   if (!res.ok) {
-    throw new Error(`API returned status ${res.status}`);
+    throw new Error(`${baseUrl} returned status ${res.status}`);
   }
   let json;
   try {
     json = await res.json();
   } catch {
-    throw new Error("Invalid response from API");
+    throw new Error(`Invalid response from ${baseUrl}`);
   }
   return {
     name: json.name || json.storeName || "My Store",
@@ -11247,6 +11257,38 @@ async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com
     ...json.i18n ? { i18n: json.i18n } : {}
   };
 }
+async function resolveStoreInfo(connectionId, candidateUrls) {
+  const urls = candidateUrls.filter((u, i) => u && candidateUrls.indexOf(u) === i);
+  if (urls.length === 0) {
+    throw new Error("No API URLs to try");
+  }
+  let lastError;
+  let allNotFound = true;
+  for (let i = 0; i < urls.length; i++) {
+    const baseUrl = urls[i];
+    try {
+      const info = await fetchStoreInfo(connectionId, baseUrl);
+      return { info, apiBaseUrl: baseUrl, fellBack: i > 0 };
+    } catch (err) {
+      lastError = err;
+      const isNotFound = err.code === "NOT_FOUND";
+      if (!isNotFound) {
+        allNotFound = false;
+      }
+    }
+  }
+  if (allNotFound) {
+    throw new Error(
+      `Connection "${connectionId}" not found in any known environment (${urls.join(", ")}).`
+    );
+  }
+  throw lastError || new Error("Failed to resolve store info");
+}
+function getCandidateApiUrls() {
+  const explicit = (process.env.BRAINERCE_API_URL || "").replace(/\/$/, "");
+  if (explicit) return [explicit];
+  return [KNOWN_API_URLS.production, KNOWN_API_URLS.staging];
+}
 
 // src/tools/get-store-info.ts
 var GET_STORE_INFO_NAME = "get-store-info";
@@ -11256,21 +11298,18 @@ var GET_STORE_INFO_SCHEMA = {
 };
 async function handleGetStoreInfo(args) {
   try {
-    const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-      /\/$/,
-      ""
-    );
-    const info = await fetchStoreInfo(args.connectionId, baseUrl);
+    const resolved = await resolveStoreInfo(args.connectionId, getCandidateApiUrls());
     return {
       content: [
         {
           type: "text",
           text: JSON.stringify(
             {
-              name: info.name,
-              currency: info.currency,
-              language: info.language,
-              connectionId: args.connectionId
+              name: resolved.info.name,
+              currency: resolved.info.currency,
+              language: resolved.info.language,
+              connectionId: args.connectionId,
+              apiBaseUrl: resolved.apiBaseUrl
             },
             null,
             2
@@ -11291,6 +11330,12 @@ async function handleGetStoreInfo(args) {
 var import_zod6 = require("zod");
 
 // src/utils/fetch-store-capabilities.ts
+var ConnectionNotFoundError2 = class extends Error {
+  constructor(connectionId, baseUrl) {
+    super(`Connection "${connectionId}" not found at ${baseUrl}`);
+    this.code = "NOT_FOUND";
+  }
+};
 async function fetchStoreCapabilities(connectionId, baseUrl = "https://api.brainerce.com") {
   const url = `${baseUrl}/api/vc/${connectionId}/capabilities`;
   const controller = new AbortController();
@@ -11300,24 +11345,51 @@ async function fetchStoreCapabilities(connectionId, baseUrl = "https://api.brain
     res = await fetch(url, { signal: controller.signal });
   } catch (err) {
     if (err.name === "AbortError") {
-      throw new Error("Request timed out");
+      throw new Error(`Request to ${baseUrl} timed out`);
     }
-    throw new Error(`Failed to connect to Brainerce API: ${err.message}`);
+    throw new Error(`Failed to connect to ${baseUrl}: ${err.message}`);
   } finally {
     clearTimeout(timeout);
   }
   if (res.status === 404) {
-    throw new Error(`Connection ID "${connectionId}" not found. Check your dashboard.`);
+    throw new ConnectionNotFoundError2(connectionId, baseUrl);
   }
   if (!res.ok) {
-    throw new Error(`API returned status ${res.status}`);
+    throw new Error(`${baseUrl} returned status ${res.status}`);
   }
   try {
     return await res.json();
   } catch {
-    throw new Error("Invalid response from API");
+    throw new Error(`Invalid response from ${baseUrl}`);
   }
 }
+async function resolveStoreCapabilities(connectionId, candidateUrls) {
+  const urls = candidateUrls.filter((u, i) => u && candidateUrls.indexOf(u) === i);
+  if (urls.length === 0) {
+    throw new Error("No API URLs to try");
+  }
+  let lastError;
+  let allNotFound = true;
+  for (let i = 0; i < urls.length; i++) {
+    const baseUrl = urls[i];
+    try {
+      const capabilities = await fetchStoreCapabilities(connectionId, baseUrl);
+      return { capabilities, apiBaseUrl: baseUrl, fellBack: i > 0 };
+    } catch (err) {
+      lastError = err;
+      const isNotFound = err.code === "NOT_FOUND";
+      if (!isNotFound) {
+        allNotFound = false;
+      }
+    }
+  }
+  if (allNotFound) {
+    throw new Error(
+      `Connection "${connectionId}" not found in any known environment (${urls.join(", ")}).`
+    );
+  }
+  throw lastError || new Error("Failed to resolve store capabilities");
+}
 
 // src/tools/get-store-capabilities.ts
 var GET_STORE_CAPABILITIES_NAME = "get-store-capabilities";
@@ -11435,13 +11507,9 @@ function formatCapabilities(caps) {
 }
 async function handleGetStoreCapabilities(args) {
   try {
-    const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-      /\/$/,
-      ""
-    );
-    const caps = await fetchStoreCapabilities(args.connectionId, baseUrl);
+    const resolved = await resolveStoreCapabilities(args.connectionId, getCandidateApiUrls());
     return {
-      content: [{ type: "text", text: formatCapabilities(caps) }]
+      content: [{ type: "text", text: formatCapabilities(resolved.capabilities) }]
     };
   } catch (error) {
     const message = error instanceof Error ? error.message : "Failed to fetch store capabilities";
@@ -11704,13 +11772,10 @@ var BUILD_STORE_SCHEMA = {
   storeStyle: import_zod7.z.string().optional().describe('Design style (e.g., "minimalist", "luxury", "playful", "dark mode")')
 };
 async function handleBuildStore(args) {
-  const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-    /\/$/,
-    ""
-  );
   let capabilities = null;
   try {
-    capabilities = await fetchStoreCapabilities(args.connectionId, baseUrl);
+    const resolved = await resolveStoreCapabilities(args.connectionId, getCandidateApiUrls());
+    capabilities = resolved.capabilities;
   } catch {
   }
   const bundle = buildStoreBundle({

package/dist/index.js

@@ -11242,7 +11242,17 @@ async function handleGetRequiredPages(args) {
 var import_zod5 = require("zod");
 
 // src/utils/fetch-store-info.ts
-async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com") {
+var KNOWN_API_URLS = {
+  production: "https://api.brainerce.com",
+  staging: "https://api-staging.brainerce.com"
+};
+var ConnectionNotFoundError = class extends Error {
+  constructor(connectionId, baseUrl) {
+    super(`Connection "${connectionId}" not found at ${baseUrl}`);
+    this.code = "NOT_FOUND";
+  }
+};
+async function fetchStoreInfo(connectionId, baseUrl = KNOWN_API_URLS.production) {
   const url = `${baseUrl}/api/vc/${connectionId}/info`;
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), 1e4);
@@ -11251,23 +11261,23 @@ async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com
     res = await fetch(url, { signal: controller.signal });
   } catch (err) {
     if (err.name === "AbortError") {
-      throw new Error("Request timed out");
+      throw new Error(`Request to ${baseUrl} timed out`);
     }
-    throw new Error(`Failed to connect to Brainerce API: ${err.message}`);
+    throw new Error(`Failed to connect to ${baseUrl}: ${err.message}`);
   } finally {
     clearTimeout(timeout);
   }
   if (res.status === 404) {
-    throw new Error(`Connection ID "${connectionId}" not found. Check your dashboard.`);
+    throw new ConnectionNotFoundError(connectionId, baseUrl);
   }
   if (!res.ok) {
-    throw new Error(`API returned status ${res.status}`);
+    throw new Error(`${baseUrl} returned status ${res.status}`);
   }
   let json;
   try {
     json = await res.json();
   } catch {
-    throw new Error("Invalid response from API");
+    throw new Error(`Invalid response from ${baseUrl}`);
   }
   return {
     name: json.name || json.storeName || "My Store",
@@ -11276,6 +11286,38 @@ async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com
     ...json.i18n ? { i18n: json.i18n } : {}
   };
 }
+async function resolveStoreInfo(connectionId, candidateUrls) {
+  const urls = candidateUrls.filter((u, i) => u && candidateUrls.indexOf(u) === i);
+  if (urls.length === 0) {
+    throw new Error("No API URLs to try");
+  }
+  let lastError;
+  let allNotFound = true;
+  for (let i = 0; i < urls.length; i++) {
+    const baseUrl = urls[i];
+    try {
+      const info = await fetchStoreInfo(connectionId, baseUrl);
+      return { info, apiBaseUrl: baseUrl, fellBack: i > 0 };
+    } catch (err) {
+      lastError = err;
+      const isNotFound = err.code === "NOT_FOUND";
+      if (!isNotFound) {
+        allNotFound = false;
+      }
+    }
+  }
+  if (allNotFound) {
+    throw new Error(
+      `Connection "${connectionId}" not found in any known environment (${urls.join(", ")}).`
+    );
+  }
+  throw lastError || new Error("Failed to resolve store info");
+}
+function getCandidateApiUrls() {
+  const explicit = (process.env.BRAINERCE_API_URL || "").replace(/\/$/, "");
+  if (explicit) return [explicit];
+  return [KNOWN_API_URLS.production, KNOWN_API_URLS.staging];
+}
 
 // src/tools/get-store-info.ts
 var GET_STORE_INFO_NAME = "get-store-info";
@@ -11285,21 +11327,18 @@ var GET_STORE_INFO_SCHEMA = {
 };
 async function handleGetStoreInfo(args) {
   try {
-    const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-      /\/$/,
-      ""
-    );
-    const info = await fetchStoreInfo(args.connectionId, baseUrl);
+    const resolved = await resolveStoreInfo(args.connectionId, getCandidateApiUrls());
     return {
       content: [
         {
           type: "text",
           text: JSON.stringify(
             {
-              name: info.name,
-              currency: info.currency,
-              language: info.language,
-              connectionId: args.connectionId
+              name: resolved.info.name,
+              currency: resolved.info.currency,
+              language: resolved.info.language,
+              connectionId: args.connectionId,
+              apiBaseUrl: resolved.apiBaseUrl
             },
             null,
             2
@@ -11320,6 +11359,12 @@ async function handleGetStoreInfo(args) {
 var import_zod6 = require("zod");
 
 // src/utils/fetch-store-capabilities.ts
+var ConnectionNotFoundError2 = class extends Error {
+  constructor(connectionId, baseUrl) {
+    super(`Connection "${connectionId}" not found at ${baseUrl}`);
+    this.code = "NOT_FOUND";
+  }
+};
 async function fetchStoreCapabilities(connectionId, baseUrl = "https://api.brainerce.com") {
   const url = `${baseUrl}/api/vc/${connectionId}/capabilities`;
   const controller = new AbortController();
@@ -11329,24 +11374,51 @@ async function fetchStoreCapabilities(connectionId, baseUrl = "https://api.brain
     res = await fetch(url, { signal: controller.signal });
   } catch (err) {
     if (err.name === "AbortError") {
-      throw new Error("Request timed out");
+      throw new Error(`Request to ${baseUrl} timed out`);
     }
-    throw new Error(`Failed to connect to Brainerce API: ${err.message}`);
+    throw new Error(`Failed to connect to ${baseUrl}: ${err.message}`);
   } finally {
     clearTimeout(timeout);
   }
   if (res.status === 404) {
-    throw new Error(`Connection ID "${connectionId}" not found. Check your dashboard.`);
+    throw new ConnectionNotFoundError2(connectionId, baseUrl);
   }
   if (!res.ok) {
-    throw new Error(`API returned status ${res.status}`);
+    throw new Error(`${baseUrl} returned status ${res.status}`);
   }
   try {
     return await res.json();
   } catch {
-    throw new Error("Invalid response from API");
+    throw new Error(`Invalid response from ${baseUrl}`);
   }
 }
+async function resolveStoreCapabilities(connectionId, candidateUrls) {
+  const urls = candidateUrls.filter((u, i) => u && candidateUrls.indexOf(u) === i);
+  if (urls.length === 0) {
+    throw new Error("No API URLs to try");
+  }
+  let lastError;
+  let allNotFound = true;
+  for (let i = 0; i < urls.length; i++) {
+    const baseUrl = urls[i];
+    try {
+      const capabilities = await fetchStoreCapabilities(connectionId, baseUrl);
+      return { capabilities, apiBaseUrl: baseUrl, fellBack: i > 0 };
+    } catch (err) {
+      lastError = err;
+      const isNotFound = err.code === "NOT_FOUND";
+      if (!isNotFound) {
+        allNotFound = false;
+      }
+    }
+  }
+  if (allNotFound) {
+    throw new Error(
+      `Connection "${connectionId}" not found in any known environment (${urls.join(", ")}).`
+    );
+  }
+  throw lastError || new Error("Failed to resolve store capabilities");
+}
 
 // src/tools/get-store-capabilities.ts
 var GET_STORE_CAPABILITIES_NAME = "get-store-capabilities";
@@ -11464,13 +11536,9 @@ function formatCapabilities(caps) {
 }
 async function handleGetStoreCapabilities(args) {
   try {
-    const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-      /\/$/,
-      ""
-    );
-    const caps = await fetchStoreCapabilities(args.connectionId, baseUrl);
+    const resolved = await resolveStoreCapabilities(args.connectionId, getCandidateApiUrls());
     return {
-      content: [{ type: "text", text: formatCapabilities(caps) }]
+      content: [{ type: "text", text: formatCapabilities(resolved.capabilities) }]
     };
   } catch (error) {
     const message = error instanceof Error ? error.message : "Failed to fetch store capabilities";
@@ -11733,13 +11801,10 @@ var BUILD_STORE_SCHEMA = {
   storeStyle: import_zod7.z.string().optional().describe('Design style (e.g., "minimalist", "luxury", "playful", "dark mode")')
 };
 async function handleBuildStore(args) {
-  const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-    /\/$/,
-    ""
-  );
   let capabilities = null;
   try {
-    capabilities = await fetchStoreCapabilities(args.connectionId, baseUrl);
+    const resolved = await resolveStoreCapabilities(args.connectionId, getCandidateApiUrls());
+    capabilities = resolved.capabilities;
   } catch {
   }
   const bundle = buildStoreBundle({

package/dist/index.mjs

@@ -11207,7 +11207,17 @@ async function handleGetRequiredPages(args) {
 import { z as z5 } from "zod";
 
 // src/utils/fetch-store-info.ts
-async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com") {
+var KNOWN_API_URLS = {
+  production: "https://api.brainerce.com",
+  staging: "https://api-staging.brainerce.com"
+};
+var ConnectionNotFoundError = class extends Error {
+  constructor(connectionId, baseUrl) {
+    super(`Connection "${connectionId}" not found at ${baseUrl}`);
+    this.code = "NOT_FOUND";
+  }
+};
+async function fetchStoreInfo(connectionId, baseUrl = KNOWN_API_URLS.production) {
   const url = `${baseUrl}/api/vc/${connectionId}/info`;
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), 1e4);
@@ -11216,23 +11226,23 @@ async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com
     res = await fetch(url, { signal: controller.signal });
   } catch (err) {
     if (err.name === "AbortError") {
-      throw new Error("Request timed out");
+      throw new Error(`Request to ${baseUrl} timed out`);
     }
-    throw new Error(`Failed to connect to Brainerce API: ${err.message}`);
+    throw new Error(`Failed to connect to ${baseUrl}: ${err.message}`);
   } finally {
     clearTimeout(timeout);
   }
   if (res.status === 404) {
-    throw new Error(`Connection ID "${connectionId}" not found. Check your dashboard.`);
+    throw new ConnectionNotFoundError(connectionId, baseUrl);
   }
   if (!res.ok) {
-    throw new Error(`API returned status ${res.status}`);
+    throw new Error(`${baseUrl} returned status ${res.status}`);
   }
   let json;
   try {
     json = await res.json();
   } catch {
-    throw new Error("Invalid response from API");
+    throw new Error(`Invalid response from ${baseUrl}`);
   }
   return {
     name: json.name || json.storeName || "My Store",
@@ -11241,6 +11251,38 @@ async function fetchStoreInfo(connectionId, baseUrl = "https://api.brainerce.com
     ...json.i18n ? { i18n: json.i18n } : {}
   };
 }
+async function resolveStoreInfo(connectionId, candidateUrls) {
+  const urls = candidateUrls.filter((u, i) => u && candidateUrls.indexOf(u) === i);
+  if (urls.length === 0) {
+    throw new Error("No API URLs to try");
+  }
+  let lastError;
+  let allNotFound = true;
+  for (let i = 0; i < urls.length; i++) {
+    const baseUrl = urls[i];
+    try {
+      const info = await fetchStoreInfo(connectionId, baseUrl);
+      return { info, apiBaseUrl: baseUrl, fellBack: i > 0 };
+    } catch (err) {
+      lastError = err;
+      const isNotFound = err.code === "NOT_FOUND";
+      if (!isNotFound) {
+        allNotFound = false;
+      }
+    }
+  }
+  if (allNotFound) {
+    throw new Error(
+      `Connection "${connectionId}" not found in any known environment (${urls.join(", ")}).`
+    );
+  }
+  throw lastError || new Error("Failed to resolve store info");
+}
+function getCandidateApiUrls() {
+  const explicit = (process.env.BRAINERCE_API_URL || "").replace(/\/$/, "");
+  if (explicit) return [explicit];
+  return [KNOWN_API_URLS.production, KNOWN_API_URLS.staging];
+}
 
 // src/tools/get-store-info.ts
 var GET_STORE_INFO_NAME = "get-store-info";
@@ -11250,21 +11292,18 @@ var GET_STORE_INFO_SCHEMA = {
 };
 async function handleGetStoreInfo(args) {
   try {
-    const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-      /\/$/,
-      ""
-    );
-    const info = await fetchStoreInfo(args.connectionId, baseUrl);
+    const resolved = await resolveStoreInfo(args.connectionId, getCandidateApiUrls());
     return {
       content: [
         {
           type: "text",
           text: JSON.stringify(
             {
-              name: info.name,
-              currency: info.currency,
-              language: info.language,
-              connectionId: args.connectionId
+              name: resolved.info.name,
+              currency: resolved.info.currency,
+              language: resolved.info.language,
+              connectionId: args.connectionId,
+              apiBaseUrl: resolved.apiBaseUrl
             },
             null,
             2
@@ -11285,6 +11324,12 @@ async function handleGetStoreInfo(args) {
 import { z as z6 } from "zod";
 
 // src/utils/fetch-store-capabilities.ts
+var ConnectionNotFoundError2 = class extends Error {
+  constructor(connectionId, baseUrl) {
+    super(`Connection "${connectionId}" not found at ${baseUrl}`);
+    this.code = "NOT_FOUND";
+  }
+};
 async function fetchStoreCapabilities(connectionId, baseUrl = "https://api.brainerce.com") {
   const url = `${baseUrl}/api/vc/${connectionId}/capabilities`;
   const controller = new AbortController();
@@ -11294,24 +11339,51 @@ async function fetchStoreCapabilities(connectionId, baseUrl = "https://api.brain
     res = await fetch(url, { signal: controller.signal });
   } catch (err) {
     if (err.name === "AbortError") {
-      throw new Error("Request timed out");
+      throw new Error(`Request to ${baseUrl} timed out`);
     }
-    throw new Error(`Failed to connect to Brainerce API: ${err.message}`);
+    throw new Error(`Failed to connect to ${baseUrl}: ${err.message}`);
   } finally {
     clearTimeout(timeout);
   }
   if (res.status === 404) {
-    throw new Error(`Connection ID "${connectionId}" not found. Check your dashboard.`);
+    throw new ConnectionNotFoundError2(connectionId, baseUrl);
   }
   if (!res.ok) {
-    throw new Error(`API returned status ${res.status}`);
+    throw new Error(`${baseUrl} returned status ${res.status}`);
   }
   try {
     return await res.json();
   } catch {
-    throw new Error("Invalid response from API");
+    throw new Error(`Invalid response from ${baseUrl}`);
   }
 }
+async function resolveStoreCapabilities(connectionId, candidateUrls) {
+  const urls = candidateUrls.filter((u, i) => u && candidateUrls.indexOf(u) === i);
+  if (urls.length === 0) {
+    throw new Error("No API URLs to try");
+  }
+  let lastError;
+  let allNotFound = true;
+  for (let i = 0; i < urls.length; i++) {
+    const baseUrl = urls[i];
+    try {
+      const capabilities = await fetchStoreCapabilities(connectionId, baseUrl);
+      return { capabilities, apiBaseUrl: baseUrl, fellBack: i > 0 };
+    } catch (err) {
+      lastError = err;
+      const isNotFound = err.code === "NOT_FOUND";
+      if (!isNotFound) {
+        allNotFound = false;
+      }
+    }
+  }
+  if (allNotFound) {
+    throw new Error(
+      `Connection "${connectionId}" not found in any known environment (${urls.join(", ")}).`
+    );
+  }
+  throw lastError || new Error("Failed to resolve store capabilities");
+}
 
 // src/tools/get-store-capabilities.ts
 var GET_STORE_CAPABILITIES_NAME = "get-store-capabilities";
@@ -11429,13 +11501,9 @@ function formatCapabilities(caps) {
 }
 async function handleGetStoreCapabilities(args) {
   try {
-    const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-      /\/$/,
-      ""
-    );
-    const caps = await fetchStoreCapabilities(args.connectionId, baseUrl);
+    const resolved = await resolveStoreCapabilities(args.connectionId, getCandidateApiUrls());
     return {
-      content: [{ type: "text", text: formatCapabilities(caps) }]
+      content: [{ type: "text", text: formatCapabilities(resolved.capabilities) }]
     };
   } catch (error) {
     const message = error instanceof Error ? error.message : "Failed to fetch store capabilities";
@@ -11698,13 +11766,10 @@ var BUILD_STORE_SCHEMA = {
   storeStyle: z7.string().optional().describe('Design style (e.g., "minimalist", "luxury", "playful", "dark mode")')
 };
 async function handleBuildStore(args) {
-  const baseUrl = (process.env.BRAINERCE_API_URL || "https://api.brainerce.com").replace(
-    /\/$/,
-    ""
-  );
   let capabilities = null;
   try {
-    capabilities = await fetchStoreCapabilities(args.connectionId, baseUrl);
+    const resolved = await resolveStoreCapabilities(args.connectionId, getCandidateApiUrls());
+    capabilities = resolved.capabilities;
   } catch {
   }
   const bundle = buildStoreBundle({

package/package.json

@@ -1,53 +1,54 @@
-{
-  "name": "@brainerce/mcp-server",
-  "version": "2.6.0",
-  "description": "MCP server for AI-powered Brainerce store building. Provides SDK docs, types, and code examples to AI tools like Lovable, Cursor, and Claude Code.",
-  "bin": {
-    "brainerce-mcp": "dist/bin/stdio.js"
-  },
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "prebuild": "node scripts/embed-templates.mjs",
-    "build": "node scripts/embed-templates.mjs && tsup",
-    "dev": "tsup --watch",
-    "start:stdio": "node dist/bin/stdio.js",
-    "start:http": "node dist/bin/http.js"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "zod": "^3.24.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "brainerce",
-    "mcp",
-    "model-context-protocol",
-    "ai",
-    "ecommerce",
-    "lovable",
-    "cursor",
-    "claude-code",
-    "vibe-coding"
-  ],
-  "license": "MIT"
-}
+{
+  "name": "@brainerce/mcp-server",
+  "version": "2.7.0",
+  "description": "MCP server for AI-powered Brainerce store building. Provides SDK docs, types, and code examples to AI tools like Lovable, Cursor, and Claude Code.",
+  "bin": {
+    "brainerce-mcp": "dist/bin/stdio.js"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/embed-templates.mjs",
+    "build": "node scripts/embed-templates.mjs && tsup",
+    "dev": "tsup --watch",
+    "start:stdio": "node dist/bin/stdio.js",
+    "start:http": "node dist/bin/http.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "brainerce",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "ecommerce",
+    "lovable",
+    "cursor",
+    "claude-code",
+    "vibe-coding"
+  ],
+  "license": "MIT"
+}