npm - @brainerce/mcp-server - Versions diffs - 3.11.1 → 3.12.0 - Mend

@brainerce/mcp-server 3.11.1 → 3.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/bin/http.js CHANGED Viewed

@@ -2537,8 +2537,9 @@ await admin.createTaxRate({ name: 'VAT (Food)', rate: 0, country: 'GB', taxClass
 await admin.mergeTaxClasses(food.id, standardClassId);
 \`\`\`
-Storefront (public, no apiKey \u2014 \`storeId\` mode): \`getStoreTaxClasses()\` lists
-the store's classes (storefront-safe fields only) for a transparency badge.
+Storefront (public, no apiKey \u2014 \`storeId\` mode OR vibe-coded mode \`vc_*\`, gated
+on the \`products:read\` scope every connection already has): \`getStoreTaxClasses()\`
+lists the store's classes (storefront-safe fields only) for a transparency badge.
 For a buyer-facing tax preview on PDP / PLP / cart, \`estimateTax({ country,
 subtotal })\` returns the tax portion at the Standard rate for the buyer's
@@ -2560,8 +2561,10 @@ A region binds countries \u2192 currency + tax-display mode + enabled payment
 providers. Manage them via the SDK (scopes \`regions:read\` / \`regions:write\`).
 \`detectRegion\` is a pure client-side helper to map a buyer's country to a
 region; pass the resolved \`regionId\` to \`createCheckout\` to associate the
-checkout with a region (recorded for reporting + provider scoping; currency
-follows the cart until FX price conversion lands).
+checkout with a region (recorded for reporting + provider scoping). FX-at-checkout:
+presentment-enabled regions (Stripe today) charge in the region currency and the
+checkout response carries a \`presentment\` overlay with the charged amounts;
+otherwise the checkout is charged in the store base currency.
 \`\`\`typescript
 const eu = await admin.createRegion({
@@ -2574,9 +2577,12 @@ const { data: regions } = await admin.getRegions();
 const region = admin.detectRegion('DE', regions); // \u2192 eu, else default, else null
 \`\`\`
-Storefront (public, no apiKey \u2014 \`storeId\` mode): \`getStoreRegions()\` lists
-active regions, \`getStoreRegion(id)\` returns one region + its payment providers.
-Pair with \`detectRegion\` to pick the buyer's region for currency display.
+Storefront (public, no apiKey \u2014 \`storeId\` mode OR vibe-coded mode \`vc_*\`, gated
+on the \`products:read\` scope every connection already has): \`getStoreRegions()\`
+lists active regions, \`getStoreRegion(id)\` returns one region + its payment
+providers. \`getAutoRegion(country)\` and \`estimateTax({ country, subtotal })\` work
+in both modes too. Pair with \`detectRegion\` to pick the buyer's region for
+currency display.
 \`\`\`typescript
 const store = new BrainerceClient({ storeId: 'store_123' });
@@ -3200,6 +3206,38 @@ Rules:
   count updates when the bot adds items.
 `;
 }
+function getStorefrontAnalyticsSection(connectionId) {
+  return `## Storefront Traffic Analytics (visits, countries, sources)
+Brainerce can track cookieless storefront traffic \u2014 how many people visit the
+store, from which countries, and from which traffic sources \u2014 and surface it in
+the merchant dashboard alongside sales (so the merchant gets a REAL conversion
+rate: visits \u2192 orders).
+Add ONE line to the storefront's root layout (\`<head>\` or end of \`<body>\`):
+\`\`\`html
+<script defer src="https://api.brainerce.com/t.js" data-channel="${connectionId}"></script>
+\`\`\`
+That's it \u2014 the pixel auto-sends a pageview beacon on load and on SPA route
+changes. Stores scaffolded with \`create-brainerce-store\` already include it.
+Privacy: the pixel is cookieless and stores NO personal data \u2014 no cookie, no
+cross-site/cross-day tracking, and the visitor IP is resolved to a country
+server-side then discarded. No cookie-consent banner is required for it under
+GDPR/ePrivacy.
+CSP: if the storefront sets a Content-Security-Policy, allow the script + beacon:
+- \`script-src\` \u2026 \`https://api.brainerce.com\`
+- \`connect-src\` \u2026 \`https://api.brainerce.com\`
+The merchant can toggle tracking per sales channel in the dashboard. The data
+shows up under Dashboard \u2192 Analytics (visits over time, by country, by source,
+by device) and can also be asked of the AI assistant ("how many visits did I get
+this month and from where?").
+`;
+}
 function getSectionByTopic(topic, connectionId, currency) {
   const cid = connectionId || "vc_YOUR_CONNECTION_ID";
   const cur = currency || "USD";
@@ -3256,6 +3294,9 @@ function getSectionByTopic(topic, connectionId, currency) {
       return getBlogSection();
     case "storefront-bot":
       return getStorefrontBotSection(cid);
+    case "analytics":
+    case "traffic-analytics":
+      return getStorefrontAnalyticsSection(cid);
     case "all":
       return [
         "# Brainerce SDK \u2014 full topic dump",
@@ -3324,6 +3365,10 @@ function getSectionByTopic(topic, connectionId, currency) {
         "",
         "---",
         "",
+        getStorefrontAnalyticsSection(cid),
+        "",
+        "---",
+        "",
         getProductCustomizationFieldsSection(),
         "",
         "---",
@@ -3393,6 +3438,7 @@ var GET_SDK_DOCS_SCHEMA = {
     "inquiries",
     "content",
     "storefront-bot",
+    "analytics",
     "all"
   ]).describe("The SDK documentation topic to retrieve"),
   salesChannelId: import_zod.z.string().optional().describe("Sales channel ID (starts with vc_). Used to personalize setup code."),
@@ -3430,7 +3476,7 @@ interface Product {
   priceMin?: string | null;  // Lowest variant price (VARIABLE products) \u2014 same as basePrice for VARIABLE, kept for back-compat and JSON-LD range display.
   priceMax?: string | null;  // Highest variant price (VARIABLE products). Use with priceMin for "\u20AA49 \u2013 \u20AA199" range.
   priceVaries?: boolean;     // true when variant prices differ \u2014 show "\u20AA49 \u2013 \u20AA199" range.
-  // FX DISPLAY overlay (PRD \xA723). Set only when getProducts({ regionId }) was called AND region.currency !== store.currency. basePrice/salePrice above stay in store currency \u2014 these are additive, display-only. The buyer is still charged in store currency at checkout; payment provider handles customer-side FX.
+  // FX DISPLAY overlay (PRD \xA723). Set only when getProducts({ regionId }) was called AND region.currency !== store.currency. basePrice/salePrice above stay in store currency \u2014 these are additive. For presentment-enabled regions (Stripe) the displayPrice uses the same buffered rate the checkout charges (browsed == checkout); for display-only regions it is mid-market and the buyer is charged in store currency at checkout (payment provider handles customer-side FX).
   displayPrice?: string;        // basePrice \xD7 daily FX rate, in displayCurrency.
   displaySalePrice?: string;    // salePrice \xD7 rate (if salePrice present).
   displayPriceMin?: string;     // priceMin \xD7 rate (VARIABLE products).
@@ -3684,7 +3730,7 @@ interface Checkout {
   status: CheckoutStatus;
   email?: string | null;
   customerId?: string | null;
-  regionId?: string | null;  // multi-region: recorded for reporting + provider scoping (currency follows the cart until FX lands)
+  regionId?: string | null;  // multi-region: recorded for reporting + provider scoping. FX-at-checkout: presentment-enabled regions (Stripe) charge in the region currency \u2014 see the presentment field below; else charged in store base currency
   shippingAddress?: CheckoutAddress | null;
   billingAddress?: CheckoutAddress | null;
   shippingRateId?: string | null;
@@ -3704,6 +3750,18 @@ interface Checkout {
   itemCount: number;
   availableShippingRates?: ShippingRate[];
   reservation?: ReservationInfo;
+  // FX-at-checkout: present ONLY when the region charges in its own currency (presentment-enabled \u2014 Stripe today). The amounts the buyer is actually CHARGED, in presentment.currency; presentment.total equals the payment intent amount. Render these (not total/currency above) when present. Absent = charged in store base currency. The fields above stay the base reference.
+  presentment?: {
+    currency: string;        // ISO-4217 charged currency, e.g. "EUR"
+    subtotal: string;
+    discountAmount: string;
+    shippingAmount: string;
+    taxAmount: string;
+    surchargeAmount: string;
+    total: string;           // equals the charged amount, to the cent
+    fxChargingRate: string;  // base\u2192presentment rate (buffer included)
+    fxBufferPercent: string | null;
+  };
   createdAt: string;
   updatedAt: string;
 }
@@ -4081,10 +4139,22 @@ interface CartAppliedDiscount {
 }
 // Recommendation types
+interface RecommendationVariant {
+  id: string; name?: string; price?: string; salePrice?: string;
+  attributes?: Record<string, string>; image?: ProductImage | string; inventory?: InventoryInfo;
+}
 interface ProductRecommendation {
-  id: string; name: string; slug: string; basePrice: string; salePrice?: string;
+  id: string; name: string; slug: string;
+  // For a VARIABLE target, basePrice is the pinned variant's price (when
+  // targetVariantId is set) or the "from {min variant}" range \u2014 never 0.
+  basePrice: string; salePrice?: string;
   images: ProductImage[]; type: 'SIMPLE' | 'VARIABLE'; inventory?: InventoryInfo;
   relationType: string;
+  // Variant context (VARIABLE targets):
+  targetVariantId?: string | null;        // merchant-pinned variant, or null
+  requiresVariantSelection?: boolean;      // true \u2192 customer must pick from variants
+  pinnedVariant?: { id: string; name?: string; attributes?: Record<string, string> } | null;
+  variants?: RecommendationVariant[];      // present when requiresVariantSelection
 }
 interface ProductRecommendationsResponse {
   crossSells: ProductRecommendation[];
@@ -4118,6 +4188,12 @@ interface CartBundleOfferOfferedProduct {
   salePrice: string | null;
   images: Array<{ url: string }>;
   type: string;
+  // Variant context (VARIABLE offered products):
+  variantId?: string | null;               // merchant-pinned variant for this slot
+  requiresVariantSelection?: boolean;       // true \u2192 customer must pick from variants
+  pinnedVariant?: { id: string; name?: string; attributes?: Record<string, string> } | null;
+  variants?: RecommendationVariant[];       // present when requiresVariantSelection
+  // originalPrice = pinned/cheapest variant price for VARIABLE (not a 0 parent base).
   originalPrice: string;
   discountedPrice: string;
 }
@@ -4601,10 +4677,12 @@ interface UpdateRegionDto extends Partial<CreateRegionDto> { isActive?: boolean
 // client.detectRegion(country, regions): Region | null  \u2014 pure, no network.
 //   \u2192 region whose countries includes the code, else the default region, else null.
 // Pass the resolved regionId to createCheckout to associate the checkout with a
-// region (recorded for reporting + provider scoping; currency follows the cart
-// until FX price conversion lands).
+// region (recorded for reporting + provider scoping). FX-at-checkout:
+// presentment-enabled regions (Stripe) charge in the region currency and the
+// response carries a presentment overlay; else charged in store base currency.
 //
-// Storefront (public, no apiKey \u2014 storeId mode):
+// Storefront (public, no apiKey \u2014 storeId mode OR vibe-coded mode, salesChannelId 'vc_*';
+// the vc routes are gated on products:read, which every connection already has):
 interface PublicRegion {
   id: string; name: string; slug: string; currency: string;
   countries: string[]; taxInclusive: boolean; isDefault: boolean;
@@ -4656,7 +4734,8 @@ interface AssignTaxClassDto { productIds?: string[]; variantIds?: string[]; cate
 //                deleteTaxClass(id), setDefaultTaxClass(id), assignTaxClass(id, dto),
 //                mergeTaxClasses(id, targetId)
 //
-// SDK methods (storefront, public \u2014 storeId mode, no apiKey):
+// SDK methods (storefront, public \u2014 storeId mode OR vibe-coded mode 'vc_*', no apiKey;
+// the vc routes are gated on products:read, which every connection already has):
 //   getStoreRegions(), getStoreRegion(id), getAutoRegion(country)
 //   getStoreTaxClasses(), estimateTax({ country?, subtotal })
 //

package/dist/bin/stdio.js CHANGED Viewed

@@ -2534,8 +2534,9 @@ await admin.createTaxRate({ name: 'VAT (Food)', rate: 0, country: 'GB', taxClass
 await admin.mergeTaxClasses(food.id, standardClassId);
 \`\`\`
-Storefront (public, no apiKey \u2014 \`storeId\` mode): \`getStoreTaxClasses()\` lists
-the store's classes (storefront-safe fields only) for a transparency badge.
+Storefront (public, no apiKey \u2014 \`storeId\` mode OR vibe-coded mode \`vc_*\`, gated
+on the \`products:read\` scope every connection already has): \`getStoreTaxClasses()\`
+lists the store's classes (storefront-safe fields only) for a transparency badge.
 For a buyer-facing tax preview on PDP / PLP / cart, \`estimateTax({ country,
 subtotal })\` returns the tax portion at the Standard rate for the buyer's
@@ -2557,8 +2558,10 @@ A region binds countries \u2192 currency + tax-display mode + enabled payment
 providers. Manage them via the SDK (scopes \`regions:read\` / \`regions:write\`).
 \`detectRegion\` is a pure client-side helper to map a buyer's country to a
 region; pass the resolved \`regionId\` to \`createCheckout\` to associate the
-checkout with a region (recorded for reporting + provider scoping; currency
-follows the cart until FX price conversion lands).
+checkout with a region (recorded for reporting + provider scoping). FX-at-checkout:
+presentment-enabled regions (Stripe today) charge in the region currency and the
+checkout response carries a \`presentment\` overlay with the charged amounts;
+otherwise the checkout is charged in the store base currency.
 \`\`\`typescript
 const eu = await admin.createRegion({
@@ -2571,9 +2574,12 @@ const { data: regions } = await admin.getRegions();
 const region = admin.detectRegion('DE', regions); // \u2192 eu, else default, else null
 \`\`\`
-Storefront (public, no apiKey \u2014 \`storeId\` mode): \`getStoreRegions()\` lists
-active regions, \`getStoreRegion(id)\` returns one region + its payment providers.
-Pair with \`detectRegion\` to pick the buyer's region for currency display.
+Storefront (public, no apiKey \u2014 \`storeId\` mode OR vibe-coded mode \`vc_*\`, gated
+on the \`products:read\` scope every connection already has): \`getStoreRegions()\`
+lists active regions, \`getStoreRegion(id)\` returns one region + its payment
+providers. \`getAutoRegion(country)\` and \`estimateTax({ country, subtotal })\` work
+in both modes too. Pair with \`detectRegion\` to pick the buyer's region for
+currency display.
 \`\`\`typescript
 const store = new BrainerceClient({ storeId: 'store_123' });
@@ -3197,6 +3203,38 @@ Rules:
   count updates when the bot adds items.
 `;
 }
+function getStorefrontAnalyticsSection(connectionId) {
+  return `## Storefront Traffic Analytics (visits, countries, sources)
+Brainerce can track cookieless storefront traffic \u2014 how many people visit the
+store, from which countries, and from which traffic sources \u2014 and surface it in
+the merchant dashboard alongside sales (so the merchant gets a REAL conversion
+rate: visits \u2192 orders).
+Add ONE line to the storefront's root layout (\`<head>\` or end of \`<body>\`):
+\`\`\`html
+<script defer src="https://api.brainerce.com/t.js" data-channel="${connectionId}"></script>
+\`\`\`
+That's it \u2014 the pixel auto-sends a pageview beacon on load and on SPA route
+changes. Stores scaffolded with \`create-brainerce-store\` already include it.
+Privacy: the pixel is cookieless and stores NO personal data \u2014 no cookie, no
+cross-site/cross-day tracking, and the visitor IP is resolved to a country
+server-side then discarded. No cookie-consent banner is required for it under
+GDPR/ePrivacy.
+CSP: if the storefront sets a Content-Security-Policy, allow the script + beacon:
+- \`script-src\` \u2026 \`https://api.brainerce.com\`
+- \`connect-src\` \u2026 \`https://api.brainerce.com\`
+The merchant can toggle tracking per sales channel in the dashboard. The data
+shows up under Dashboard \u2192 Analytics (visits over time, by country, by source,
+by device) and can also be asked of the AI assistant ("how many visits did I get
+this month and from where?").
+`;
+}
 function getSectionByTopic(topic, connectionId, currency) {
   const cid = connectionId || "vc_YOUR_CONNECTION_ID";
   const cur = currency || "USD";
@@ -3253,6 +3291,9 @@ function getSectionByTopic(topic, connectionId, currency) {
       return getBlogSection();
     case "storefront-bot":
       return getStorefrontBotSection(cid);
+    case "analytics":
+    case "traffic-analytics":
+      return getStorefrontAnalyticsSection(cid);
     case "all":
       return [
         "# Brainerce SDK \u2014 full topic dump",
@@ -3321,6 +3362,10 @@ function getSectionByTopic(topic, connectionId, currency) {
         "",
         "---",
         "",
+        getStorefrontAnalyticsSection(cid),
+        "",
+        "---",
+        "",
         getProductCustomizationFieldsSection(),
         "",
         "---",
@@ -3390,6 +3435,7 @@ var GET_SDK_DOCS_SCHEMA = {
     "inquiries",
     "content",
     "storefront-bot",
+    "analytics",
     "all"
   ]).describe("The SDK documentation topic to retrieve"),
   salesChannelId: import_zod.z.string().optional().describe("Sales channel ID (starts with vc_). Used to personalize setup code."),
@@ -3427,7 +3473,7 @@ interface Product {
   priceMin?: string | null;  // Lowest variant price (VARIABLE products) \u2014 same as basePrice for VARIABLE, kept for back-compat and JSON-LD range display.
   priceMax?: string | null;  // Highest variant price (VARIABLE products). Use with priceMin for "\u20AA49 \u2013 \u20AA199" range.
   priceVaries?: boolean;     // true when variant prices differ \u2014 show "\u20AA49 \u2013 \u20AA199" range.
-  // FX DISPLAY overlay (PRD \xA723). Set only when getProducts({ regionId }) was called AND region.currency !== store.currency. basePrice/salePrice above stay in store currency \u2014 these are additive, display-only. The buyer is still charged in store currency at checkout; payment provider handles customer-side FX.
+  // FX DISPLAY overlay (PRD \xA723). Set only when getProducts({ regionId }) was called AND region.currency !== store.currency. basePrice/salePrice above stay in store currency \u2014 these are additive. For presentment-enabled regions (Stripe) the displayPrice uses the same buffered rate the checkout charges (browsed == checkout); for display-only regions it is mid-market and the buyer is charged in store currency at checkout (payment provider handles customer-side FX).
   displayPrice?: string;        // basePrice \xD7 daily FX rate, in displayCurrency.
   displaySalePrice?: string;    // salePrice \xD7 rate (if salePrice present).
   displayPriceMin?: string;     // priceMin \xD7 rate (VARIABLE products).
@@ -3681,7 +3727,7 @@ interface Checkout {
   status: CheckoutStatus;
   email?: string | null;
   customerId?: string | null;
-  regionId?: string | null;  // multi-region: recorded for reporting + provider scoping (currency follows the cart until FX lands)
+  regionId?: string | null;  // multi-region: recorded for reporting + provider scoping. FX-at-checkout: presentment-enabled regions (Stripe) charge in the region currency \u2014 see the presentment field below; else charged in store base currency
   shippingAddress?: CheckoutAddress | null;
   billingAddress?: CheckoutAddress | null;
   shippingRateId?: string | null;
@@ -3701,6 +3747,18 @@ interface Checkout {
   itemCount: number;
   availableShippingRates?: ShippingRate[];
   reservation?: ReservationInfo;
+  // FX-at-checkout: present ONLY when the region charges in its own currency (presentment-enabled \u2014 Stripe today). The amounts the buyer is actually CHARGED, in presentment.currency; presentment.total equals the payment intent amount. Render these (not total/currency above) when present. Absent = charged in store base currency. The fields above stay the base reference.
+  presentment?: {
+    currency: string;        // ISO-4217 charged currency, e.g. "EUR"
+    subtotal: string;
+    discountAmount: string;
+    shippingAmount: string;
+    taxAmount: string;
+    surchargeAmount: string;
+    total: string;           // equals the charged amount, to the cent
+    fxChargingRate: string;  // base\u2192presentment rate (buffer included)
+    fxBufferPercent: string | null;
+  };
   createdAt: string;
   updatedAt: string;
 }
@@ -4078,10 +4136,22 @@ interface CartAppliedDiscount {
 }
 // Recommendation types
+interface RecommendationVariant {
+  id: string; name?: string; price?: string; salePrice?: string;
+  attributes?: Record<string, string>; image?: ProductImage | string; inventory?: InventoryInfo;
+}
 interface ProductRecommendation {
-  id: string; name: string; slug: string; basePrice: string; salePrice?: string;
+  id: string; name: string; slug: string;
+  // For a VARIABLE target, basePrice is the pinned variant's price (when
+  // targetVariantId is set) or the "from {min variant}" range \u2014 never 0.
+  basePrice: string; salePrice?: string;
   images: ProductImage[]; type: 'SIMPLE' | 'VARIABLE'; inventory?: InventoryInfo;
   relationType: string;
+  // Variant context (VARIABLE targets):
+  targetVariantId?: string | null;        // merchant-pinned variant, or null
+  requiresVariantSelection?: boolean;      // true \u2192 customer must pick from variants
+  pinnedVariant?: { id: string; name?: string; attributes?: Record<string, string> } | null;
+  variants?: RecommendationVariant[];      // present when requiresVariantSelection
 }
 interface ProductRecommendationsResponse {
   crossSells: ProductRecommendation[];
@@ -4115,6 +4185,12 @@ interface CartBundleOfferOfferedProduct {
   salePrice: string | null;
   images: Array<{ url: string }>;
   type: string;
+  // Variant context (VARIABLE offered products):
+  variantId?: string | null;               // merchant-pinned variant for this slot
+  requiresVariantSelection?: boolean;       // true \u2192 customer must pick from variants
+  pinnedVariant?: { id: string; name?: string; attributes?: Record<string, string> } | null;
+  variants?: RecommendationVariant[];       // present when requiresVariantSelection
+  // originalPrice = pinned/cheapest variant price for VARIABLE (not a 0 parent base).
   originalPrice: string;
   discountedPrice: string;
 }
@@ -4598,10 +4674,12 @@ interface UpdateRegionDto extends Partial<CreateRegionDto> { isActive?: boolean
 // client.detectRegion(country, regions): Region | null  \u2014 pure, no network.
 //   \u2192 region whose countries includes the code, else the default region, else null.
 // Pass the resolved regionId to createCheckout to associate the checkout with a
-// region (recorded for reporting + provider scoping; currency follows the cart
-// until FX price conversion lands).
+// region (recorded for reporting + provider scoping). FX-at-checkout:
+// presentment-enabled regions (Stripe) charge in the region currency and the
+// response carries a presentment overlay; else charged in store base currency.
 //
-// Storefront (public, no apiKey \u2014 storeId mode):
+// Storefront (public, no apiKey \u2014 storeId mode OR vibe-coded mode, salesChannelId 'vc_*';
+// the vc routes are gated on products:read, which every connection already has):
 interface PublicRegion {
   id: string; name: string; slug: string; currency: string;
   countries: string[]; taxInclusive: boolean; isDefault: boolean;
@@ -4653,7 +4731,8 @@ interface AssignTaxClassDto { productIds?: string[]; variantIds?: string[]; cate
 //                deleteTaxClass(id), setDefaultTaxClass(id), assignTaxClass(id, dto),
 //                mergeTaxClasses(id, targetId)
 //
-// SDK methods (storefront, public \u2014 storeId mode, no apiKey):
+// SDK methods (storefront, public \u2014 storeId mode OR vibe-coded mode 'vc_*', no apiKey;
+// the vc routes are gated on products:read, which every connection already has):
 //   getStoreRegions(), getStoreRegion(id), getAutoRegion(country)
 //   getStoreTaxClasses(), estimateTax({ country?, subtotal })
 //

package/dist/index.js CHANGED Viewed

@@ -2560,8 +2560,9 @@ await admin.createTaxRate({ name: 'VAT (Food)', rate: 0, country: 'GB', taxClass
 await admin.mergeTaxClasses(food.id, standardClassId);
 \`\`\`
-Storefront (public, no apiKey \u2014 \`storeId\` mode): \`getStoreTaxClasses()\` lists
-the store's classes (storefront-safe fields only) for a transparency badge.
+Storefront (public, no apiKey \u2014 \`storeId\` mode OR vibe-coded mode \`vc_*\`, gated
+on the \`products:read\` scope every connection already has): \`getStoreTaxClasses()\`
+lists the store's classes (storefront-safe fields only) for a transparency badge.
 For a buyer-facing tax preview on PDP / PLP / cart, \`estimateTax({ country,
 subtotal })\` returns the tax portion at the Standard rate for the buyer's
@@ -2583,8 +2584,10 @@ A region binds countries \u2192 currency + tax-display mode + enabled payment
 providers. Manage them via the SDK (scopes \`regions:read\` / \`regions:write\`).
 \`detectRegion\` is a pure client-side helper to map a buyer's country to a
 region; pass the resolved \`regionId\` to \`createCheckout\` to associate the
-checkout with a region (recorded for reporting + provider scoping; currency
-follows the cart until FX price conversion lands).
+checkout with a region (recorded for reporting + provider scoping). FX-at-checkout:
+presentment-enabled regions (Stripe today) charge in the region currency and the
+checkout response carries a \`presentment\` overlay with the charged amounts;
+otherwise the checkout is charged in the store base currency.
 \`\`\`typescript
 const eu = await admin.createRegion({
@@ -2597,9 +2600,12 @@ const { data: regions } = await admin.getRegions();
 const region = admin.detectRegion('DE', regions); // \u2192 eu, else default, else null
 \`\`\`
-Storefront (public, no apiKey \u2014 \`storeId\` mode): \`getStoreRegions()\` lists
-active regions, \`getStoreRegion(id)\` returns one region + its payment providers.
-Pair with \`detectRegion\` to pick the buyer's region for currency display.
+Storefront (public, no apiKey \u2014 \`storeId\` mode OR vibe-coded mode \`vc_*\`, gated
+on the \`products:read\` scope every connection already has): \`getStoreRegions()\`
+lists active regions, \`getStoreRegion(id)\` returns one region + its payment
+providers. \`getAutoRegion(country)\` and \`estimateTax({ country, subtotal })\` work
+in both modes too. Pair with \`detectRegion\` to pick the buyer's region for
+currency display.
 \`\`\`typescript
 const store = new BrainerceClient({ storeId: 'store_123' });
@@ -3223,6 +3229,38 @@ Rules:
   count updates when the bot adds items.
 `;
 }
+function getStorefrontAnalyticsSection(connectionId) {
+  return `## Storefront Traffic Analytics (visits, countries, sources)
+Brainerce can track cookieless storefront traffic \u2014 how many people visit the
+store, from which countries, and from which traffic sources \u2014 and surface it in
+the merchant dashboard alongside sales (so the merchant gets a REAL conversion
+rate: visits \u2192 orders).
+Add ONE line to the storefront's root layout (\`<head>\` or end of \`<body>\`):
+\`\`\`html
+<script defer src="https://api.brainerce.com/t.js" data-channel="${connectionId}"></script>
+\`\`\`
+That's it \u2014 the pixel auto-sends a pageview beacon on load and on SPA route
+changes. Stores scaffolded with \`create-brainerce-store\` already include it.
+Privacy: the pixel is cookieless and stores NO personal data \u2014 no cookie, no
+cross-site/cross-day tracking, and the visitor IP is resolved to a country
+server-side then discarded. No cookie-consent banner is required for it under
+GDPR/ePrivacy.
+CSP: if the storefront sets a Content-Security-Policy, allow the script + beacon:
+- \`script-src\` \u2026 \`https://api.brainerce.com\`
+- \`connect-src\` \u2026 \`https://api.brainerce.com\`
+The merchant can toggle tracking per sales channel in the dashboard. The data
+shows up under Dashboard \u2192 Analytics (visits over time, by country, by source,
+by device) and can also be asked of the AI assistant ("how many visits did I get
+this month and from where?").
+`;
+}
 function getSectionByTopic(topic, connectionId, currency) {
   const cid = connectionId || "vc_YOUR_CONNECTION_ID";
   const cur = currency || "USD";
@@ -3279,6 +3317,9 @@ function getSectionByTopic(topic, connectionId, currency) {
       return getBlogSection();
     case "storefront-bot":
       return getStorefrontBotSection(cid);
+    case "analytics":
+    case "traffic-analytics":
+      return getStorefrontAnalyticsSection(cid);
     case "all":
       return [
         "# Brainerce SDK \u2014 full topic dump",
@@ -3347,6 +3388,10 @@ function getSectionByTopic(topic, connectionId, currency) {
         "",
         "---",
         "",
+        getStorefrontAnalyticsSection(cid),
+        "",
+        "---",
+        "",
         getProductCustomizationFieldsSection(),
         "",
         "---",
@@ -3416,6 +3461,7 @@ var GET_SDK_DOCS_SCHEMA = {
     "inquiries",
     "content",
     "storefront-bot",
+    "analytics",
     "all"
   ]).describe("The SDK documentation topic to retrieve"),
   salesChannelId: import_zod.z.string().optional().describe("Sales channel ID (starts with vc_). Used to personalize setup code."),
@@ -3453,7 +3499,7 @@ interface Product {
   priceMin?: string | null;  // Lowest variant price (VARIABLE products) \u2014 same as basePrice for VARIABLE, kept for back-compat and JSON-LD range display.
   priceMax?: string | null;  // Highest variant price (VARIABLE products). Use with priceMin for "\u20AA49 \u2013 \u20AA199" range.
   priceVaries?: boolean;     // true when variant prices differ \u2014 show "\u20AA49 \u2013 \u20AA199" range.
-  // FX DISPLAY overlay (PRD \xA723). Set only when getProducts({ regionId }) was called AND region.currency !== store.currency. basePrice/salePrice above stay in store currency \u2014 these are additive, display-only. The buyer is still charged in store currency at checkout; payment provider handles customer-side FX.
+  // FX DISPLAY overlay (PRD \xA723). Set only when getProducts({ regionId }) was called AND region.currency !== store.currency. basePrice/salePrice above stay in store currency \u2014 these are additive. For presentment-enabled regions (Stripe) the displayPrice uses the same buffered rate the checkout charges (browsed == checkout); for display-only regions it is mid-market and the buyer is charged in store currency at checkout (payment provider handles customer-side FX).
   displayPrice?: string;        // basePrice \xD7 daily FX rate, in displayCurrency.
   displaySalePrice?: string;    // salePrice \xD7 rate (if salePrice present).
   displayPriceMin?: string;     // priceMin \xD7 rate (VARIABLE products).
@@ -3707,7 +3753,7 @@ interface Checkout {
   status: CheckoutStatus;
   email?: string | null;
   customerId?: string | null;
-  regionId?: string | null;  // multi-region: recorded for reporting + provider scoping (currency follows the cart until FX lands)
+  regionId?: string | null;  // multi-region: recorded for reporting + provider scoping. FX-at-checkout: presentment-enabled regions (Stripe) charge in the region currency \u2014 see the presentment field below; else charged in store base currency
   shippingAddress?: CheckoutAddress | null;
   billingAddress?: CheckoutAddress | null;
   shippingRateId?: string | null;
@@ -3727,6 +3773,18 @@ interface Checkout {
   itemCount: number;
   availableShippingRates?: ShippingRate[];
   reservation?: ReservationInfo;
+  // FX-at-checkout: present ONLY when the region charges in its own currency (presentment-enabled \u2014 Stripe today). The amounts the buyer is actually CHARGED, in presentment.currency; presentment.total equals the payment intent amount. Render these (not total/currency above) when present. Absent = charged in store base currency. The fields above stay the base reference.
+  presentment?: {
+    currency: string;        // ISO-4217 charged currency, e.g. "EUR"
+    subtotal: string;
+    discountAmount: string;
+    shippingAmount: string;
+    taxAmount: string;
+    surchargeAmount: string;
+    total: string;           // equals the charged amount, to the cent
+    fxChargingRate: string;  // base\u2192presentment rate (buffer included)
+    fxBufferPercent: string | null;
+  };
   createdAt: string;
   updatedAt: string;
 }
@@ -4104,10 +4162,22 @@ interface CartAppliedDiscount {
 }
 // Recommendation types
+interface RecommendationVariant {
+  id: string; name?: string; price?: string; salePrice?: string;
+  attributes?: Record<string, string>; image?: ProductImage | string; inventory?: InventoryInfo;
+}
 interface ProductRecommendation {
-  id: string; name: string; slug: string; basePrice: string; salePrice?: string;
+  id: string; name: string; slug: string;
+  // For a VARIABLE target, basePrice is the pinned variant's price (when
+  // targetVariantId is set) or the "from {min variant}" range \u2014 never 0.
+  basePrice: string; salePrice?: string;
   images: ProductImage[]; type: 'SIMPLE' | 'VARIABLE'; inventory?: InventoryInfo;
   relationType: string;
+  // Variant context (VARIABLE targets):
+  targetVariantId?: string | null;        // merchant-pinned variant, or null
+  requiresVariantSelection?: boolean;      // true \u2192 customer must pick from variants
+  pinnedVariant?: { id: string; name?: string; attributes?: Record<string, string> } | null;
+  variants?: RecommendationVariant[];      // present when requiresVariantSelection
 }
 interface ProductRecommendationsResponse {
   crossSells: ProductRecommendation[];
@@ -4141,6 +4211,12 @@ interface CartBundleOfferOfferedProduct {
   salePrice: string | null;
   images: Array<{ url: string }>;
   type: string;
+  // Variant context (VARIABLE offered products):
+  variantId?: string | null;               // merchant-pinned variant for this slot
+  requiresVariantSelection?: boolean;       // true \u2192 customer must pick from variants
+  pinnedVariant?: { id: string; name?: string; attributes?: Record<string, string> } | null;
+  variants?: RecommendationVariant[];       // present when requiresVariantSelection
+  // originalPrice = pinned/cheapest variant price for VARIABLE (not a 0 parent base).
   originalPrice: string;
   discountedPrice: string;
 }
@@ -4624,10 +4700,12 @@ interface UpdateRegionDto extends Partial<CreateRegionDto> { isActive?: boolean
 // client.detectRegion(country, regions): Region | null  \u2014 pure, no network.
 //   \u2192 region whose countries includes the code, else the default region, else null.
 // Pass the resolved regionId to createCheckout to associate the checkout with a
-// region (recorded for reporting + provider scoping; currency follows the cart
-// until FX price conversion lands).
+// region (recorded for reporting + provider scoping). FX-at-checkout:
+// presentment-enabled regions (Stripe) charge in the region currency and the
+// response carries a presentment overlay; else charged in store base currency.
 //
-// Storefront (public, no apiKey \u2014 storeId mode):
+// Storefront (public, no apiKey \u2014 storeId mode OR vibe-coded mode, salesChannelId 'vc_*';
+// the vc routes are gated on products:read, which every connection already has):
 interface PublicRegion {
   id: string; name: string; slug: string; currency: string;
   countries: string[]; taxInclusive: boolean; isDefault: boolean;
@@ -4679,7 +4757,8 @@ interface AssignTaxClassDto { productIds?: string[]; variantIds?: string[]; cate
 //                deleteTaxClass(id), setDefaultTaxClass(id), assignTaxClass(id, dto),
 //                mergeTaxClasses(id, targetId)
 //
-// SDK methods (storefront, public \u2014 storeId mode, no apiKey):
+// SDK methods (storefront, public \u2014 storeId mode OR vibe-coded mode 'vc_*', no apiKey;
+// the vc routes are gated on products:read, which every connection already has):
 //   getStoreRegions(), getStoreRegion(id), getAutoRegion(country)
 //   getStoreTaxClasses(), estimateTax({ country?, subtotal })
 //

package/dist/index.mjs CHANGED Viewed

@@ -2528,8 +2528,9 @@ await admin.createTaxRate({ name: 'VAT (Food)', rate: 0, country: 'GB', taxClass
 await admin.mergeTaxClasses(food.id, standardClassId);
 \`\`\`
-Storefront (public, no apiKey \u2014 \`storeId\` mode): \`getStoreTaxClasses()\` lists
-the store's classes (storefront-safe fields only) for a transparency badge.
+Storefront (public, no apiKey \u2014 \`storeId\` mode OR vibe-coded mode \`vc_*\`, gated
+on the \`products:read\` scope every connection already has): \`getStoreTaxClasses()\`
+lists the store's classes (storefront-safe fields only) for a transparency badge.
 For a buyer-facing tax preview on PDP / PLP / cart, \`estimateTax({ country,
 subtotal })\` returns the tax portion at the Standard rate for the buyer's
@@ -2551,8 +2552,10 @@ A region binds countries \u2192 currency + tax-display mode + enabled payment
 providers. Manage them via the SDK (scopes \`regions:read\` / \`regions:write\`).
 \`detectRegion\` is a pure client-side helper to map a buyer's country to a
 region; pass the resolved \`regionId\` to \`createCheckout\` to associate the
-checkout with a region (recorded for reporting + provider scoping; currency
-follows the cart until FX price conversion lands).
+checkout with a region (recorded for reporting + provider scoping). FX-at-checkout:
+presentment-enabled regions (Stripe today) charge in the region currency and the
+checkout response carries a \`presentment\` overlay with the charged amounts;
+otherwise the checkout is charged in the store base currency.
 \`\`\`typescript
 const eu = await admin.createRegion({
@@ -2565,9 +2568,12 @@ const { data: regions } = await admin.getRegions();
 const region = admin.detectRegion('DE', regions); // \u2192 eu, else default, else null
 \`\`\`
-Storefront (public, no apiKey \u2014 \`storeId\` mode): \`getStoreRegions()\` lists
-active regions, \`getStoreRegion(id)\` returns one region + its payment providers.
-Pair with \`detectRegion\` to pick the buyer's region for currency display.
+Storefront (public, no apiKey \u2014 \`storeId\` mode OR vibe-coded mode \`vc_*\`, gated
+on the \`products:read\` scope every connection already has): \`getStoreRegions()\`
+lists active regions, \`getStoreRegion(id)\` returns one region + its payment
+providers. \`getAutoRegion(country)\` and \`estimateTax({ country, subtotal })\` work
+in both modes too. Pair with \`detectRegion\` to pick the buyer's region for
+currency display.
 \`\`\`typescript
 const store = new BrainerceClient({ storeId: 'store_123' });
@@ -3191,6 +3197,38 @@ Rules:
   count updates when the bot adds items.
 `;
 }
+function getStorefrontAnalyticsSection(connectionId) {
+  return `## Storefront Traffic Analytics (visits, countries, sources)
+Brainerce can track cookieless storefront traffic \u2014 how many people visit the
+store, from which countries, and from which traffic sources \u2014 and surface it in
+the merchant dashboard alongside sales (so the merchant gets a REAL conversion
+rate: visits \u2192 orders).
+Add ONE line to the storefront's root layout (\`<head>\` or end of \`<body>\`):
+\`\`\`html
+<script defer src="https://api.brainerce.com/t.js" data-channel="${connectionId}"></script>
+\`\`\`
+That's it \u2014 the pixel auto-sends a pageview beacon on load and on SPA route
+changes. Stores scaffolded with \`create-brainerce-store\` already include it.
+Privacy: the pixel is cookieless and stores NO personal data \u2014 no cookie, no
+cross-site/cross-day tracking, and the visitor IP is resolved to a country
+server-side then discarded. No cookie-consent banner is required for it under
+GDPR/ePrivacy.
+CSP: if the storefront sets a Content-Security-Policy, allow the script + beacon:
+- \`script-src\` \u2026 \`https://api.brainerce.com\`
+- \`connect-src\` \u2026 \`https://api.brainerce.com\`
+The merchant can toggle tracking per sales channel in the dashboard. The data
+shows up under Dashboard \u2192 Analytics (visits over time, by country, by source,
+by device) and can also be asked of the AI assistant ("how many visits did I get
+this month and from where?").
+`;
+}
 function getSectionByTopic(topic, connectionId, currency) {
   const cid = connectionId || "vc_YOUR_CONNECTION_ID";
   const cur = currency || "USD";
@@ -3247,6 +3285,9 @@ function getSectionByTopic(topic, connectionId, currency) {
       return getBlogSection();
     case "storefront-bot":
       return getStorefrontBotSection(cid);
+    case "analytics":
+    case "traffic-analytics":
+      return getStorefrontAnalyticsSection(cid);
     case "all":
       return [
         "# Brainerce SDK \u2014 full topic dump",
@@ -3315,6 +3356,10 @@ function getSectionByTopic(topic, connectionId, currency) {
         "",
         "---",
         "",
+        getStorefrontAnalyticsSection(cid),
+        "",
+        "---",
+        "",
         getProductCustomizationFieldsSection(),
         "",
         "---",
@@ -3384,6 +3429,7 @@ var GET_SDK_DOCS_SCHEMA = {
     "inquiries",
     "content",
     "storefront-bot",
+    "analytics",
     "all"
   ]).describe("The SDK documentation topic to retrieve"),
   salesChannelId: z.string().optional().describe("Sales channel ID (starts with vc_). Used to personalize setup code."),
@@ -3421,7 +3467,7 @@ interface Product {
   priceMin?: string | null;  // Lowest variant price (VARIABLE products) \u2014 same as basePrice for VARIABLE, kept for back-compat and JSON-LD range display.
   priceMax?: string | null;  // Highest variant price (VARIABLE products). Use with priceMin for "\u20AA49 \u2013 \u20AA199" range.
   priceVaries?: boolean;     // true when variant prices differ \u2014 show "\u20AA49 \u2013 \u20AA199" range.
-  // FX DISPLAY overlay (PRD \xA723). Set only when getProducts({ regionId }) was called AND region.currency !== store.currency. basePrice/salePrice above stay in store currency \u2014 these are additive, display-only. The buyer is still charged in store currency at checkout; payment provider handles customer-side FX.
+  // FX DISPLAY overlay (PRD \xA723). Set only when getProducts({ regionId }) was called AND region.currency !== store.currency. basePrice/salePrice above stay in store currency \u2014 these are additive. For presentment-enabled regions (Stripe) the displayPrice uses the same buffered rate the checkout charges (browsed == checkout); for display-only regions it is mid-market and the buyer is charged in store currency at checkout (payment provider handles customer-side FX).
   displayPrice?: string;        // basePrice \xD7 daily FX rate, in displayCurrency.
   displaySalePrice?: string;    // salePrice \xD7 rate (if salePrice present).
   displayPriceMin?: string;     // priceMin \xD7 rate (VARIABLE products).
@@ -3675,7 +3721,7 @@ interface Checkout {
   status: CheckoutStatus;
   email?: string | null;
   customerId?: string | null;
-  regionId?: string | null;  // multi-region: recorded for reporting + provider scoping (currency follows the cart until FX lands)
+  regionId?: string | null;  // multi-region: recorded for reporting + provider scoping. FX-at-checkout: presentment-enabled regions (Stripe) charge in the region currency \u2014 see the presentment field below; else charged in store base currency
   shippingAddress?: CheckoutAddress | null;
   billingAddress?: CheckoutAddress | null;
   shippingRateId?: string | null;
@@ -3695,6 +3741,18 @@ interface Checkout {
   itemCount: number;
   availableShippingRates?: ShippingRate[];
   reservation?: ReservationInfo;
+  // FX-at-checkout: present ONLY when the region charges in its own currency (presentment-enabled \u2014 Stripe today). The amounts the buyer is actually CHARGED, in presentment.currency; presentment.total equals the payment intent amount. Render these (not total/currency above) when present. Absent = charged in store base currency. The fields above stay the base reference.
+  presentment?: {
+    currency: string;        // ISO-4217 charged currency, e.g. "EUR"
+    subtotal: string;
+    discountAmount: string;
+    shippingAmount: string;
+    taxAmount: string;
+    surchargeAmount: string;
+    total: string;           // equals the charged amount, to the cent
+    fxChargingRate: string;  // base\u2192presentment rate (buffer included)
+    fxBufferPercent: string | null;
+  };
   createdAt: string;
   updatedAt: string;
 }
@@ -4072,10 +4130,22 @@ interface CartAppliedDiscount {
 }
 // Recommendation types
+interface RecommendationVariant {
+  id: string; name?: string; price?: string; salePrice?: string;
+  attributes?: Record<string, string>; image?: ProductImage | string; inventory?: InventoryInfo;
+}
 interface ProductRecommendation {
-  id: string; name: string; slug: string; basePrice: string; salePrice?: string;
+  id: string; name: string; slug: string;
+  // For a VARIABLE target, basePrice is the pinned variant's price (when
+  // targetVariantId is set) or the "from {min variant}" range \u2014 never 0.
+  basePrice: string; salePrice?: string;
   images: ProductImage[]; type: 'SIMPLE' | 'VARIABLE'; inventory?: InventoryInfo;
   relationType: string;
+  // Variant context (VARIABLE targets):
+  targetVariantId?: string | null;        // merchant-pinned variant, or null
+  requiresVariantSelection?: boolean;      // true \u2192 customer must pick from variants
+  pinnedVariant?: { id: string; name?: string; attributes?: Record<string, string> } | null;
+  variants?: RecommendationVariant[];      // present when requiresVariantSelection
 }
 interface ProductRecommendationsResponse {
   crossSells: ProductRecommendation[];
@@ -4109,6 +4179,12 @@ interface CartBundleOfferOfferedProduct {
   salePrice: string | null;
   images: Array<{ url: string }>;
   type: string;
+  // Variant context (VARIABLE offered products):
+  variantId?: string | null;               // merchant-pinned variant for this slot
+  requiresVariantSelection?: boolean;       // true \u2192 customer must pick from variants
+  pinnedVariant?: { id: string; name?: string; attributes?: Record<string, string> } | null;
+  variants?: RecommendationVariant[];       // present when requiresVariantSelection
+  // originalPrice = pinned/cheapest variant price for VARIABLE (not a 0 parent base).
   originalPrice: string;
   discountedPrice: string;
 }
@@ -4592,10 +4668,12 @@ interface UpdateRegionDto extends Partial<CreateRegionDto> { isActive?: boolean
 // client.detectRegion(country, regions): Region | null  \u2014 pure, no network.
 //   \u2192 region whose countries includes the code, else the default region, else null.
 // Pass the resolved regionId to createCheckout to associate the checkout with a
-// region (recorded for reporting + provider scoping; currency follows the cart
-// until FX price conversion lands).
+// region (recorded for reporting + provider scoping). FX-at-checkout:
+// presentment-enabled regions (Stripe) charge in the region currency and the
+// response carries a presentment overlay; else charged in store base currency.
 //
-// Storefront (public, no apiKey \u2014 storeId mode):
+// Storefront (public, no apiKey \u2014 storeId mode OR vibe-coded mode, salesChannelId 'vc_*';
+// the vc routes are gated on products:read, which every connection already has):
 interface PublicRegion {
   id: string; name: string; slug: string; currency: string;
   countries: string[]; taxInclusive: boolean; isDefault: boolean;
@@ -4647,7 +4725,8 @@ interface AssignTaxClassDto { productIds?: string[]; variantIds?: string[]; cate
 //                deleteTaxClass(id), setDefaultTaxClass(id), assignTaxClass(id, dto),
 //                mergeTaxClasses(id, targetId)
 //
-// SDK methods (storefront, public \u2014 storeId mode, no apiKey):
+// SDK methods (storefront, public \u2014 storeId mode OR vibe-coded mode 'vc_*', no apiKey;
+// the vc routes are gated on products:read, which every connection already has):
 //   getStoreRegions(), getStoreRegion(id), getAutoRegion(country)
 //   getStoreTaxClasses(), estimateTax({ country?, subtotal })
 //

package/package.json CHANGED Viewed

@@ -1,53 +1,53 @@
-{
-  "name": "@brainerce/mcp-server",
-  "version": "3.11.1",
-  "description": "Framework-agnostic domain knowledge API for Brainerce. Provides SDK docs, types, business flows, critical rules, and store capabilities to AI tools like Lovable, Cursor, Bolt, v0, and Claude Code. Does NOT provide framework-specific boilerplate — clients build in whatever framework fits.",
-  "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": {
-    "build": "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"
-}
+{
+  "name": "@brainerce/mcp-server",
+  "version": "3.12.0",
+  "description": "Framework-agnostic domain knowledge API for Brainerce. Provides SDK docs, types, business flows, critical rules, and store capabilities to AI tools like Lovable, Cursor, Bolt, v0, and Claude Code. Does NOT provide framework-specific boilerplate — clients build in whatever framework fits.",
+  "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": {
+    "build": "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"
+}