@shoppexio/mcp-commerce-server 0.3.0 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/mcp-commerce-server",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Shoppex MCP server for commerce operations over the Dev API",
   "type": "module",
   "repository": {

package/src/server.mjs

@@ -12,6 +12,9 @@ function resolveBaseUrl(explicitValue) {
 }
 
 function jsonContent(value) {
+  const structured = Array.isArray(value) || value === null || typeof value !== 'object'
+    ? { result: value }
+    : value;
   return {
     content: [
       {
@@ -19,7 +22,7 @@ function jsonContent(value) {
         text: JSON.stringify(value, null, 2),
       },
     ],
-    structuredContent: value,
+    structuredContent: structured,
   };
 }
 
@@ -257,13 +260,29 @@ export class ShoppexCommerceDevApiClient {
 }
 
 const BaseToolSchema = {
-  shop_api_key: z.string().trim().min(1),
+  shop_api_key: z.string().trim().min(1).optional(),
   api_base_url: z.string().trim().url().optional(),
 };
 
+function resolveShopApiKey(explicitValue) {
+  if (typeof explicitValue === 'string' && explicitValue.trim()) {
+    return explicitValue.trim();
+  }
+  const fromEnv = process.env.SHOPPEX_SHOP_API_KEY?.trim()
+    || process.env.SHOPPEX_API_KEY?.trim()
+    || process.env.SHOP_API_KEY?.trim();
+  if (!fromEnv) {
+    throw new ShoppexCommerceDevApiError(
+      'Missing Shoppex shop API key. Set SHOPPEX_SHOP_API_KEY in the MCP server env, or pass shop_api_key to the tool.',
+      { code: 'auth_error', retryable: false },
+    );
+  }
+  return fromEnv;
+}
+
 function createClient(args) {
   return new ShoppexCommerceDevApiClient({
-    shopApiKey: args.shop_api_key,
+    shopApiKey: resolveShopApiKey(args.shop_api_key),
     apiBaseUrl: args.api_base_url,
   });
 }