@yoryoboy/bi-mcp 1.0.5 → 1.2.0

package/dist/src/tools/meta/campaign-performance.js

@@ -0,0 +1,81 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  getMetaCampaigns,
+  getMetaInsights,
+  listAccessibleMetaAdAccounts
+} from "../../services/meta/meta-ads.js";
+import {
+  dateRegex,
+  getMetricBundle,
+  normalizeRequestedAccountIds,
+  resolveRequestedAccounts
+} from "../../meta/meta-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const metaCampaignPerformanceSchema = z.object({
+  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
+  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
+  adAccountIds: z.array(z.string()).optional().describe(
+    "Optional list of Meta ad account IDs. Accepts digits with or without the act_ prefix. If omitted, uses all accessible ad accounts."
+  ),
+  limit: z.number().int().min(1).max(100).optional().describe("Maximum number of campaigns to return per ad account. Default: 25.")
+});
+async function metaCampaignPerformanceHandler(params) {
+  try {
+    const accessibleAccounts = (await listAccessibleMetaAdAccounts()).adAccounts;
+    const requestedIds = normalizeRequestedAccountIds(params.adAccountIds);
+    const accounts = resolveRequestedAccounts(requestedIds, accessibleAccounts);
+    const limit = params.limit ?? 25;
+    const results = await Promise.all(
+      accounts.map(async (account) => {
+        const campaigns = await getMetaCampaigns(account.account_id || "", limit);
+        const rows = await Promise.all(
+          campaigns.map(async (campaign) => {
+            const insight = (await getMetaInsights(campaign.id || "", {
+              time_range: JSON.stringify({ since: params.startDate, until: params.endDate }),
+              level: "campaign"
+            }))[0];
+            return {
+              campaign_id: campaign.id,
+              campaign_name: campaign.name,
+              status: campaign.status,
+              effective_status: campaign.effective_status,
+              objective: campaign.objective,
+              ...getMetricBundle(insight)
+            };
+          })
+        );
+        rows.sort((left, right) => right.spend - left.spend);
+        return {
+          ad_account_id: account.account_id,
+          account_name: account.name,
+          currency_code: account.currency,
+          campaigns: rows
+        };
+      })
+    );
+    return object(
+      stripNulls({
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        accounts: results,
+        metadata: {
+          analyzed_accounts: results.length,
+          campaigns_per_account_limit: limit,
+          note: "Campaigns are ranked inside each ad account to preserve account context and avoid unsafe cross-account aggregation."
+        }
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to fetch Meta campaign performance"
+    );
+  }
+}
+export {
+  metaCampaignPerformanceHandler,
+  metaCampaignPerformanceSchema
+};
+//# sourceMappingURL=campaign-performance.js.map

package/dist/src/tools/meta/campaign-performance.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/meta/campaign-performance.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  getMetaCampaigns,\n  getMetaInsights,\n  listAccessibleMetaAdAccounts,\n} from \"../../services/meta/meta-ads.js\";\nimport {\n  dateRegex,\n  getMetricBundle,\n  normalizeRequestedAccountIds,\n  resolveRequestedAccounts,\n} from \"../../meta/meta-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const metaCampaignPerformanceSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  adAccountIds: z\n    .array(z.string())\n    .optional()\n    .describe(\n      \"Optional list of Meta ad account IDs. Accepts digits with or without the act_ prefix. If omitted, uses all accessible ad accounts.\"\n    ),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(100)\n    .optional()\n    .describe(\"Maximum number of campaigns to return per ad account. Default: 25.\"),\n});\n\nexport async function metaCampaignPerformanceHandler(\n  params: z.infer<typeof metaCampaignPerformanceSchema>\n) {\n  try {\n    const accessibleAccounts = (await listAccessibleMetaAdAccounts()).adAccounts;\n    const requestedIds = normalizeRequestedAccountIds(params.adAccountIds);\n    const accounts = resolveRequestedAccounts(requestedIds, accessibleAccounts);\n    const limit = params.limit ?? 25;\n\n    const results = await Promise.all(\n      accounts.map(async (account) => {\n        const campaigns = await getMetaCampaigns(account.account_id || \"\", limit);\n        const rows = await Promise.all(\n          campaigns.map(async (campaign) => {\n            const insight = (\n              await getMetaInsights(campaign.id || \"\", {\n                time_range: JSON.stringify({ since: params.startDate, until: params.endDate }),\n                level: \"campaign\",\n              })\n            )[0];\n\n            return {\n              campaign_id: campaign.id,\n              campaign_name: campaign.name,\n              status: campaign.status,\n              effective_status: campaign.effective_status,\n              objective: campaign.objective,\n              ...getMetricBundle(insight),\n            };\n          })\n        );\n\n        rows.sort((left, right) => right.spend - left.spend);\n\n        return {\n          ad_account_id: account.account_id,\n          account_name: account.name,\n          currency_code: account.currency,\n          campaigns: rows,\n        };\n      })\n    );\n\n    return object(\n      stripNulls({\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        accounts: results,\n        metadata: {\n          analyzed_accounts: results.length,\n          campaigns_per_account_limit: limit,\n          note:\n            \"Campaigns are ranked inside each ad account to preserve account context and avoid unsafe cross-account aggregation.\",\n        },\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Meta campaign performance\"\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,gCAAgC,EAAE,OAAO;AAAA,EACpD,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,kCAAkC;AAAA,EAClF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,gCAAgC;AAAA,EAC9E,cAAc,EACX,MAAM,EAAE,OAAO,CAAC,EAChB,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,OAAO,EACJ,OAAO,EACP,IAAI,EACJ,IAAI,CAAC,EACL,IAAI,GAAG,EACP,SAAS,EACT,SAAS,oEAAoE;AAClF,CAAC;AAED,eAAsB,+BACpB,QACA;AACA,MAAI;AACF,UAAM,sBAAsB,MAAM,6BAA6B,GAAG;AAClE,UAAM,eAAe,6BAA6B,OAAO,YAAY;AACrE,UAAM,WAAW,yBAAyB,cAAc,kBAAkB;AAC1E,UAAM,QAAQ,OAAO,SAAS;AAE9B,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,SAAS,IAAI,OAAO,YAAY;AAC9B,cAAM,YAAY,MAAM,iBAAiB,QAAQ,cAAc,IAAI,KAAK;AACxE,cAAM,OAAO,MAAM,QAAQ;AAAA,UACzB,UAAU,IAAI,OAAO,aAAa;AAChC,kBAAM,WACJ,MAAM,gBAAgB,SAAS,MAAM,IAAI;AAAA,cACvC,YAAY,KAAK,UAAU,EAAE,OAAO,OAAO,WAAW,OAAO,OAAO,QAAQ,CAAC;AAAA,cAC7E,OAAO;AAAA,YACT,CAAC,GACD,CAAC;AAEH,mBAAO;AAAA,cACL,aAAa,SAAS;AAAA,cACtB,eAAe,SAAS;AAAA,cACxB,QAAQ,SAAS;AAAA,cACjB,kBAAkB,SAAS;AAAA,cAC3B,WAAW,SAAS;AAAA,cACpB,GAAG,gBAAgB,OAAO;AAAA,YAC5B;AAAA,UACF,CAAC;AAAA,QACH;AAEA,aAAK,KAAK,CAAC,MAAM,UAAU,MAAM,QAAQ,KAAK,KAAK;AAEnD,eAAO;AAAA,UACL,eAAe,QAAQ;AAAA,UACvB,cAAc,QAAQ;AAAA,UACtB,eAAe,QAAQ;AAAA,UACvB,WAAW;AAAA,QACb;AAAA,MACF,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,UAAU;AAAA,QACV,UAAU;AAAA,UACR,mBAAmB,QAAQ;AAAA,UAC3B,6BAA6B;AAAA,UAC7B,MACE;AAAA,QACJ;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/tools/meta/index.js

@@ -0,0 +1,9 @@
+export * from "./list-accessible-businesses.js";
+export * from "./list-accessible-ad-accounts.js";
+export * from "./ad-account-info.js";
+export * from "./account-overview.js";
+export * from "./campaign-performance.js";
+export * from "./ads-performance.js";
+export * from "./time-series.js";
+export * from "./placement-mix.js";
+//# sourceMappingURL=index.js.map

package/dist/src/tools/meta/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/meta/index.ts"],
+  "sourcesContent": ["export * from \"./list-accessible-businesses.js\";\nexport * from \"./list-accessible-ad-accounts.js\";\nexport * from \"./ad-account-info.js\";\nexport * from \"./account-overview.js\";\nexport * from \"./campaign-performance.js\";\nexport * from \"./ads-performance.js\";\nexport * from \"./time-series.js\";\nexport * from \"./placement-mix.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/src/tools/meta/list-accessible-ad-accounts.js

@@ -0,0 +1,44 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { listAccessibleMetaAdAccounts } from "../../services/meta/meta-ads.js";
+import { getMetaAdAccountStatusLabel } from "../../meta/meta-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const metaListAccessibleAdAccountsSchema = z.object({
+  after: z.string().optional().describe("Optional pagination cursor returned by a previous Meta ad accounts listing.")
+});
+async function metaListAccessibleAdAccountsHandler(params) {
+  try {
+    const result = await listAccessibleMetaAdAccounts(params.after);
+    return object(
+      stripNulls({
+        ad_accounts: result.adAccounts.map((account) => ({
+          id: account.id,
+          account_id: account.account_id,
+          act_id: account.account_id ? `act_${account.account_id}` : account.id,
+          name: account.name,
+          currency: account.currency,
+          account_status: account.account_status,
+          account_status_label: getMetaAdAccountStatusLabel(account.account_status),
+          timezone_name: account.timezone_name,
+          timezone_offset_hours_utc: account.timezone_offset_hours_utc,
+          business: account.business
+        })),
+        metadata: {
+          returned_ad_accounts: result.adAccounts.length,
+          pagination: {
+            has_more: result.paging.has_more,
+            next_after: result.paging.after
+          },
+          note: result.paging.has_more ? "Partial data. Use metadata.pagination.next_after to request the next page." : "Complete data for the current token and page size."
+        }
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to list accessible Meta ad accounts");
+  }
+}
+export {
+  metaListAccessibleAdAccountsHandler,
+  metaListAccessibleAdAccountsSchema
+};
+//# sourceMappingURL=list-accessible-ad-accounts.js.map

package/dist/src/tools/meta/list-accessible-ad-accounts.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/meta/list-accessible-ad-accounts.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listAccessibleMetaAdAccounts } from \"../../services/meta/meta-ads.js\";\nimport { getMetaAdAccountStatusLabel } from \"../../meta/meta-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const metaListAccessibleAdAccountsSchema = z.object({\n  after: z\n    .string()\n    .optional()\n    .describe(\"Optional pagination cursor returned by a previous Meta ad accounts listing.\"),\n});\n\nexport async function metaListAccessibleAdAccountsHandler(\n  params: z.infer<typeof metaListAccessibleAdAccountsSchema>\n) {\n  try {\n    const result = await listAccessibleMetaAdAccounts(params.after);\n\n    return object(\n      stripNulls({\n        ad_accounts: result.adAccounts.map((account) => ({\n          id: account.id,\n          account_id: account.account_id,\n          act_id: account.account_id ? `act_${account.account_id}` : account.id,\n          name: account.name,\n          currency: account.currency,\n          account_status: account.account_status,\n          account_status_label: getMetaAdAccountStatusLabel(account.account_status),\n          timezone_name: account.timezone_name,\n          timezone_offset_hours_utc: account.timezone_offset_hours_utc,\n          business: account.business,\n        })),\n        metadata: {\n          returned_ad_accounts: result.adAccounts.length,\n          pagination: {\n            has_more: result.paging.has_more,\n            next_after: result.paging.after,\n          },\n          note: result.paging.has_more\n            ? \"Partial data. Use metadata.pagination.next_after to request the next page.\"\n            : \"Complete data for the current token and page size.\",\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to list accessible Meta ad accounts\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,oCAAoC;AAC7C,SAAS,mCAAmC;AAC5C,SAAS,kBAAkB;AAEpB,MAAM,qCAAqC,EAAE,OAAO;AAAA,EACzD,OAAO,EACJ,OAAO,EACP,SAAS,EACT,SAAS,6EAA6E;AAC3F,CAAC;AAED,eAAsB,oCACpB,QACA;AACA,MAAI;AACF,UAAM,SAAS,MAAM,6BAA6B,OAAO,KAAK;AAE9D,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa,OAAO,WAAW,IAAI,CAAC,aAAa;AAAA,UAC/C,IAAI,QAAQ;AAAA,UACZ,YAAY,QAAQ;AAAA,UACpB,QAAQ,QAAQ,aAAa,OAAO,QAAQ,UAAU,KAAK,QAAQ;AAAA,UACnE,MAAM,QAAQ;AAAA,UACd,UAAU,QAAQ;AAAA,UAClB,gBAAgB,QAAQ;AAAA,UACxB,sBAAsB,4BAA4B,QAAQ,cAAc;AAAA,UACxE,eAAe,QAAQ;AAAA,UACvB,2BAA2B,QAAQ;AAAA,UACnC,UAAU,QAAQ;AAAA,QACpB,EAAE;AAAA,QACF,UAAU;AAAA,UACR,sBAAsB,OAAO,WAAW;AAAA,UACxC,YAAY;AAAA,YACV,UAAU,OAAO,OAAO;AAAA,YACxB,YAAY,OAAO,OAAO;AAAA,UAC5B;AAAA,UACA,MAAM,OAAO,OAAO,WAChB,+EACA;AAAA,QACN;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,4CAA4C;AAAA,EAChG;AACF;",
+  "names": []
+}

package/dist/src/tools/meta/list-accessible-businesses.js

@@ -0,0 +1,36 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { listAccessibleMetaBusinesses } from "../../services/meta/meta-ads.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const metaListAccessibleBusinessesSchema = z.object({
+  after: z.string().optional().describe("Optional pagination cursor returned by a previous Meta businesses listing.")
+});
+async function metaListAccessibleBusinessesHandler(params) {
+  try {
+    const result = await listAccessibleMetaBusinesses(params.after);
+    return object(
+      stripNulls({
+        businesses: result.businesses.map((business) => ({
+          id: business.id,
+          name: business.name,
+          verification_status: business.verification_status
+        })),
+        metadata: {
+          returned_businesses: result.businesses.length,
+          pagination: {
+            has_more: result.paging.has_more,
+            next_after: result.paging.after
+          },
+          note: result.paging.has_more ? "Partial data. Use metadata.pagination.next_after to request the next page." : "Complete data for the current token and page size."
+        }
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to list accessible Meta businesses");
+  }
+}
+export {
+  metaListAccessibleBusinessesHandler,
+  metaListAccessibleBusinessesSchema
+};
+//# sourceMappingURL=list-accessible-businesses.js.map

package/dist/src/tools/meta/list-accessible-businesses.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/meta/list-accessible-businesses.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listAccessibleMetaBusinesses } from \"../../services/meta/meta-ads.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const metaListAccessibleBusinessesSchema = z.object({\n  after: z\n    .string()\n    .optional()\n    .describe(\"Optional pagination cursor returned by a previous Meta businesses listing.\"),\n});\n\nexport async function metaListAccessibleBusinessesHandler(\n  params: z.infer<typeof metaListAccessibleBusinessesSchema>\n) {\n  try {\n    const result = await listAccessibleMetaBusinesses(params.after);\n\n    return object(\n      stripNulls({\n        businesses: result.businesses.map((business) => ({\n          id: business.id,\n          name: business.name,\n          verification_status: business.verification_status,\n        })),\n        metadata: {\n          returned_businesses: result.businesses.length,\n          pagination: {\n            has_more: result.paging.has_more,\n            next_after: result.paging.after,\n          },\n          note: result.paging.has_more\n            ? \"Partial data. Use metadata.pagination.next_after to request the next page.\"\n            : \"Complete data for the current token and page size.\",\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to list accessible Meta businesses\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,oCAAoC;AAC7C,SAAS,kBAAkB;AAEpB,MAAM,qCAAqC,EAAE,OAAO;AAAA,EACzD,OAAO,EACJ,OAAO,EACP,SAAS,EACT,SAAS,4EAA4E;AAC1F,CAAC;AAED,eAAsB,oCACpB,QACA;AACA,MAAI;AACF,UAAM,SAAS,MAAM,6BAA6B,OAAO,KAAK;AAE9D,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY,OAAO,WAAW,IAAI,CAAC,cAAc;AAAA,UAC/C,IAAI,SAAS;AAAA,UACb,MAAM,SAAS;AAAA,UACf,qBAAqB,SAAS;AAAA,QAChC,EAAE;AAAA,QACF,UAAU;AAAA,UACR,qBAAqB,OAAO,WAAW;AAAA,UACvC,YAAY;AAAA,YACV,UAAU,OAAO,OAAO;AAAA,YACxB,YAAY,OAAO,OAAO;AAAA,UAC5B;AAAA,UACA,MAAM,OAAO,OAAO,WAChB,+EACA;AAAA,QACN;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,2CAA2C;AAAA,EAC/F;AACF;",
+  "names": []
+}

package/dist/src/tools/meta/placement-mix.js

@@ -0,0 +1,67 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  getMetaPlacementInsights,
+  listAccessibleMetaAdAccounts
+} from "../../services/meta/meta-ads.js";
+import {
+  dateRegex,
+  getMetricBundle,
+  normalizeRequestedAccountIds,
+  resolveRequestedAccounts
+} from "../../meta/meta-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const metaPlacementMixSchema = z.object({
+  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
+  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
+  adAccountIds: z.array(z.string()).optional().describe(
+    "Optional list of Meta ad account IDs. Accepts digits with or without the act_ prefix. If omitted, uses all accessible ad accounts."
+  )
+});
+async function metaPlacementMixHandler(params) {
+  try {
+    const accessibleAccounts = (await listAccessibleMetaAdAccounts()).adAccounts;
+    const requestedIds = normalizeRequestedAccountIds(params.adAccountIds);
+    const accounts = resolveRequestedAccounts(requestedIds, accessibleAccounts);
+    const results = await Promise.all(
+      accounts.map(async (account) => {
+        const rows = await getMetaPlacementInsights(account.account_id || "", {
+          time_range: JSON.stringify({ since: params.startDate, until: params.endDate }),
+          level: "account",
+          breakdowns: "publisher_platform,platform_position,impression_device"
+        });
+        return {
+          ad_account_id: account.account_id,
+          account_name: account.name,
+          currency_code: account.currency,
+          placements: rows.map((row) => ({
+            publisher_platform: row.publisher_platform,
+            platform_position: row.platform_position,
+            impression_device: row.impression_device,
+            ...getMetricBundle(row)
+          })).sort((left, right) => right.spend - left.spend)
+        };
+      })
+    );
+    return object(
+      stripNulls({
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        accounts: results,
+        metadata: {
+          analyzed_accounts: results.length,
+          note: "Placement mix is returned per ad account. Use this to compare Facebook, Instagram, and placement efficiency inside each account."
+        }
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to fetch Meta placement mix");
+  }
+}
+export {
+  metaPlacementMixHandler,
+  metaPlacementMixSchema
+};
+//# sourceMappingURL=placement-mix.js.map

package/dist/src/tools/meta/placement-mix.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/meta/placement-mix.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  getMetaPlacementInsights,\n  listAccessibleMetaAdAccounts,\n} from \"../../services/meta/meta-ads.js\";\nimport {\n  dateRegex,\n  getMetricBundle,\n  normalizeRequestedAccountIds,\n  resolveRequestedAccounts,\n} from \"../../meta/meta-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const metaPlacementMixSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  adAccountIds: z\n    .array(z.string())\n    .optional()\n    .describe(\n      \"Optional list of Meta ad account IDs. Accepts digits with or without the act_ prefix. If omitted, uses all accessible ad accounts.\"\n    ),\n});\n\nexport async function metaPlacementMixHandler(\n  params: z.infer<typeof metaPlacementMixSchema>\n) {\n  try {\n    const accessibleAccounts = (await listAccessibleMetaAdAccounts()).adAccounts;\n    const requestedIds = normalizeRequestedAccountIds(params.adAccountIds);\n    const accounts = resolveRequestedAccounts(requestedIds, accessibleAccounts);\n\n    const results = await Promise.all(\n      accounts.map(async (account) => {\n        const rows = await getMetaPlacementInsights(account.account_id || \"\", {\n          time_range: JSON.stringify({ since: params.startDate, until: params.endDate }),\n          level: \"account\",\n          breakdowns: \"publisher_platform,platform_position,impression_device\",\n        });\n\n        return {\n          ad_account_id: account.account_id,\n          account_name: account.name,\n          currency_code: account.currency,\n          placements: rows\n            .map((row) => ({\n              publisher_platform: row.publisher_platform,\n              platform_position: row.platform_position,\n              impression_device: row.impression_device,\n              ...getMetricBundle(row),\n            }))\n            .sort((left, right) => right.spend - left.spend),\n        };\n      })\n    );\n\n    return object(\n      stripNulls({\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        accounts: results,\n        metadata: {\n          analyzed_accounts: results.length,\n          note:\n            \"Placement mix is returned per ad account. Use this to compare Facebook, Instagram, and placement efficiency inside each account.\",\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch Meta placement mix\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,yBAAyB,EAAE,OAAO;AAAA,EAC7C,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,kCAAkC;AAAA,EAClF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,gCAAgC;AAAA,EAC9E,cAAc,EACX,MAAM,EAAE,OAAO,CAAC,EAChB,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,wBACpB,QACA;AACA,MAAI;AACF,UAAM,sBAAsB,MAAM,6BAA6B,GAAG;AAClE,UAAM,eAAe,6BAA6B,OAAO,YAAY;AACrE,UAAM,WAAW,yBAAyB,cAAc,kBAAkB;AAE1E,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,SAAS,IAAI,OAAO,YAAY;AAC9B,cAAM,OAAO,MAAM,yBAAyB,QAAQ,cAAc,IAAI;AAAA,UACpE,YAAY,KAAK,UAAU,EAAE,OAAO,OAAO,WAAW,OAAO,OAAO,QAAQ,CAAC;AAAA,UAC7E,OAAO;AAAA,UACP,YAAY;AAAA,QACd,CAAC;AAED,eAAO;AAAA,UACL,eAAe,QAAQ;AAAA,UACvB,cAAc,QAAQ;AAAA,UACtB,eAAe,QAAQ;AAAA,UACvB,YAAY,KACT,IAAI,CAAC,SAAS;AAAA,YACb,oBAAoB,IAAI;AAAA,YACxB,mBAAmB,IAAI;AAAA,YACvB,mBAAmB,IAAI;AAAA,YACvB,GAAG,gBAAgB,GAAG;AAAA,UACxB,EAAE,EACD,KAAK,CAAC,MAAM,UAAU,MAAM,QAAQ,KAAK,KAAK;AAAA,QACnD;AAAA,MACF,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,UAAU;AAAA,QACV,UAAU;AAAA,UACR,mBAAmB,QAAQ;AAAA,UAC3B,MACE;AAAA,QACJ;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,oCAAoC;AAAA,EACxF;AACF;",
+  "names": []
+}

package/dist/src/tools/meta/time-series.js

@@ -0,0 +1,69 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  getMetaInsights,
+  listAccessibleMetaAdAccounts
+} from "../../services/meta/meta-ads.js";
+import {
+  dateRegex,
+  getMetricBundle,
+  normalizeRequestedAccountIds,
+  resolveRequestedAccounts
+} from "../../meta/meta-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const metaTimeSeriesSchema = z.object({
+  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
+  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
+  adAccountIds: z.array(z.string()).optional().describe(
+    "Optional list of Meta ad account IDs. Accepts digits with or without the act_ prefix. If omitted, uses all accessible ad accounts."
+  ),
+  timeIncrement: z.enum(["1", "7", "monthly"]).optional().describe("Time increment for the series. Use 1 for daily, 7 for weekly, or monthly.")
+});
+async function metaTimeSeriesHandler(params) {
+  try {
+    const accessibleAccounts = (await listAccessibleMetaAdAccounts()).adAccounts;
+    const requestedIds = normalizeRequestedAccountIds(params.adAccountIds);
+    const accounts = resolveRequestedAccounts(requestedIds, accessibleAccounts);
+    const timeIncrement = params.timeIncrement ?? "1";
+    const results = await Promise.all(
+      accounts.map(async (account) => {
+        const rows = await getMetaInsights(`act_${account.account_id}`, {
+          time_range: JSON.stringify({ since: params.startDate, until: params.endDate }),
+          time_increment: timeIncrement,
+          level: "account"
+        });
+        return {
+          ad_account_id: account.account_id,
+          account_name: account.name,
+          currency_code: account.currency,
+          series: rows.map((row) => ({
+            date_start: row.date_start,
+            date_stop: row.date_stop,
+            ...getMetricBundle(row)
+          }))
+        };
+      })
+    );
+    return object(
+      stripNulls({
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        time_increment: timeIncrement,
+        accounts: results,
+        metadata: {
+          analyzed_accounts: results.length,
+          note: "Time series are returned per ad account to preserve currency and account context."
+        }
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to fetch Meta time series");
+  }
+}
+export {
+  metaTimeSeriesHandler,
+  metaTimeSeriesSchema
+};
+//# sourceMappingURL=time-series.js.map

package/dist/src/tools/meta/time-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/meta/time-series.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  getMetaInsights,\n  listAccessibleMetaAdAccounts,\n} from \"../../services/meta/meta-ads.js\";\nimport {\n  dateRegex,\n  getMetricBundle,\n  normalizeRequestedAccountIds,\n  resolveRequestedAccounts,\n} from \"../../meta/meta-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const metaTimeSeriesSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  adAccountIds: z\n    .array(z.string())\n    .optional()\n    .describe(\n      \"Optional list of Meta ad account IDs. Accepts digits with or without the act_ prefix. If omitted, uses all accessible ad accounts.\"\n    ),\n  timeIncrement: z\n    .enum([\"1\", \"7\", \"monthly\"])\n    .optional()\n    .describe(\"Time increment for the series. Use 1 for daily, 7 for weekly, or monthly.\"),\n});\n\nexport async function metaTimeSeriesHandler(\n  params: z.infer<typeof metaTimeSeriesSchema>\n) {\n  try {\n    const accessibleAccounts = (await listAccessibleMetaAdAccounts()).adAccounts;\n    const requestedIds = normalizeRequestedAccountIds(params.adAccountIds);\n    const accounts = resolveRequestedAccounts(requestedIds, accessibleAccounts);\n    const timeIncrement = params.timeIncrement ?? \"1\";\n\n    const results = await Promise.all(\n      accounts.map(async (account) => {\n        const rows = await getMetaInsights(`act_${account.account_id}`, {\n          time_range: JSON.stringify({ since: params.startDate, until: params.endDate }),\n          time_increment: timeIncrement,\n          level: \"account\",\n        });\n\n        return {\n          ad_account_id: account.account_id,\n          account_name: account.name,\n          currency_code: account.currency,\n          series: rows.map((row) => ({\n            date_start: row.date_start,\n            date_stop: row.date_stop,\n            ...getMetricBundle(row),\n          })),\n        };\n      })\n    );\n\n    return object(\n      stripNulls({\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        time_increment: timeIncrement,\n        accounts: results,\n        metadata: {\n          analyzed_accounts: results.length,\n          note: \"Time series are returned per ad account to preserve currency and account context.\",\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch Meta time series\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,kCAAkC;AAAA,EAClF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,gCAAgC;AAAA,EAC9E,cAAc,EACX,MAAM,EAAE,OAAO,CAAC,EAChB,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,eAAe,EACZ,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,EAC1B,SAAS,EACT,SAAS,2EAA2E;AACzF,CAAC;AAED,eAAsB,sBACpB,QACA;AACA,MAAI;AACF,UAAM,sBAAsB,MAAM,6BAA6B,GAAG;AAClE,UAAM,eAAe,6BAA6B,OAAO,YAAY;AACrE,UAAM,WAAW,yBAAyB,cAAc,kBAAkB;AAC1E,UAAM,gBAAgB,OAAO,iBAAiB;AAE9C,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,SAAS,IAAI,OAAO,YAAY;AAC9B,cAAM,OAAO,MAAM,gBAAgB,OAAO,QAAQ,UAAU,IAAI;AAAA,UAC9D,YAAY,KAAK,UAAU,EAAE,OAAO,OAAO,WAAW,OAAO,OAAO,QAAQ,CAAC;AAAA,UAC7E,gBAAgB;AAAA,UAChB,OAAO;AAAA,QACT,CAAC;AAED,eAAO;AAAA,UACL,eAAe,QAAQ;AAAA,UACvB,cAAc,QAAQ;AAAA,UACtB,eAAe,QAAQ;AAAA,UACvB,QAAQ,KAAK,IAAI,CAAC,SAAS;AAAA,YACzB,YAAY,IAAI;AAAA,YAChB,WAAW,IAAI;AAAA,YACf,GAAG,gBAAgB,GAAG;AAAA,UACxB,EAAE;AAAA,QACJ;AAAA,MACF,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,gBAAgB;AAAA,QAChB,UAAU;AAAA,QACV,UAAU;AAAA,UACR,mBAAmB,QAAQ;AAAA,UAC3B,MAAM;AAAA,QACR;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,kCAAkC;AAAA,EACtF;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/computed-price.js

@@ -4,7 +4,11 @@ import { formatVtexError } from "../../services/vtex/vtex-api.js";
 import { getComputedPrice } from "../../services/vtex/vtex-pricing.js";
 import { moneyFromCentsOptional } from "../../utils/money.js";
 import { stripNulls } from "../../utils/strip-payload.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const computedPriceSchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   itemId: z.string().min(1).describe("SKU item identifier"),
   priceTableId: z.string().min(1).describe("Price table or trade policy identifier"),
   categoryId: z.number().int().positive().describe("Category identifier"),
@@ -12,6 +16,7 @@ const computedPriceSchema = z.object({
   quantity: z.number().int().positive().describe("SKU quantity context")
 });
 async function computedPriceHandler({
+  profileId,
   itemId,
   priceTableId,
   categoryId,
@@ -19,13 +24,19 @@ async function computedPriceHandler({
   quantity
 }) {
   try {
-    const computedPrice = await getComputedPrice(itemId, priceTableId, {
+    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const computedPrice = await getComputedPrice(resolvedProfileId, itemId, priceTableId, {
       categoryId,
       brandId,
       quantity
     });
     return object(
       stripNulls({
+        profile_id: resolvedProfileId,
         item_id: itemId,
         price_table_id: priceTableId,
         trade_policy_id: computedPrice.tradePolicyId,

package/dist/src/tools/vtex/computed-price.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/computed-price.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getComputedPrice } from \"../../services/vtex/vtex-pricing.js\";\nimport { moneyFromCentsOptional } from \"../../utils/money.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const computedPriceSchema = z.object({\n  itemId: z.string().min(1).describe(\"SKU item identifier\"),\n  priceTableId: z.string().min(1).describe(\"Price table or trade policy identifier\"),\n  categoryId: z.number().int().positive().describe(\"Category identifier\"),\n  brandId: z.number().int().positive().describe(\"Brand identifier\"),\n  quantity: z.number().int().positive().describe(\"SKU quantity context\"),\n});\n\nexport async function computedPriceHandler({\n  itemId,\n  priceTableId,\n  categoryId,\n  brandId,\n  quantity,\n}: z.infer<typeof computedPriceSchema>) {\n  try {\n    const computedPrice = await getComputedPrice(itemId, priceTableId, {\n      categoryId,\n      brandId,\n      quantity,\n    });\n\n    return object(\n      stripNulls({\n        item_id: itemId,\n        price_table_id: priceTableId,\n        trade_policy_id: computedPrice.tradePolicyId,\n        list_price: moneyFromCentsOptional(computedPrice.listPrice),\n        cost_price: moneyFromCentsOptional(computedPrice.costPrice),\n        selling_price: moneyFromCentsOptional(computedPrice.sellingPrice),\n        price_valid_until: computedPrice.priceValidUntil,\n      })\n    );\n  } catch (err) {\n    return error(\n      formatVtexError(err, `Failed to fetch computed price for item ${itemId} and table ${priceTableId}`)\n    );\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AACjC,SAAS,8BAA8B;AACvC,SAAS,kBAAkB;AAEpB,MAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,qBAAqB;AAAA,EACxD,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,wCAAwC;AAAA,EACjF,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,qBAAqB;AAAA,EACtE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EAChE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,sBAAsB;AACvE,CAAC;AAED,eAAsB,qBAAqB;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAwC;AACtC,MAAI;AACF,UAAM,gBAAgB,MAAM,iBAAiB,QAAQ,cAAc;AAAA,MACjE;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO;AAAA,MACL,WAAW;AAAA,QACT,SAAS;AAAA,QACT,gBAAgB;AAAA,QAChB,iBAAiB,cAAc;AAAA,QAC/B,YAAY,uBAAuB,cAAc,SAAS;AAAA,QAC1D,YAAY,uBAAuB,cAAc,SAAS;AAAA,QAC1D,eAAe,uBAAuB,cAAc,YAAY;AAAA,QAChE,mBAAmB,cAAc;AAAA,MACnC,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,gBAAgB,KAAK,2CAA2C,MAAM,cAAc,YAAY,EAAE;AAAA,IACpG;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getComputedPrice } from \"../../services/vtex/vtex-pricing.js\";\nimport { moneyFromCentsOptional } from \"../../utils/money.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const computedPriceSchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  itemId: z.string().min(1).describe(\"SKU item identifier\"),\n  priceTableId: z.string().min(1).describe(\"Price table or trade policy identifier\"),\n  categoryId: z.number().int().positive().describe(\"Category identifier\"),\n  brandId: z.number().int().positive().describe(\"Brand identifier\"),\n  quantity: z.number().int().positive().describe(\"SKU quantity context\"),\n});\n\nexport async function computedPriceHandler({\n  profileId,\n  itemId,\n  priceTableId,\n  categoryId,\n  brandId,\n  quantity,\n}: z.infer<typeof computedPriceSchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const computedPrice = await getComputedPrice(resolvedProfileId, itemId, priceTableId, {\n      categoryId,\n      brandId,\n      quantity,\n    });\n\n    return object(\n      stripNulls({\n        profile_id: resolvedProfileId,\n        item_id: itemId,\n        price_table_id: priceTableId,\n        trade_policy_id: computedPrice.tradePolicyId,\n        list_price: moneyFromCentsOptional(computedPrice.listPrice),\n        cost_price: moneyFromCentsOptional(computedPrice.costPrice),\n        selling_price: moneyFromCentsOptional(computedPrice.sellingPrice),\n        price_valid_until: computedPrice.priceValidUntil,\n      })\n    );\n  } catch (err) {\n    return error(\n      formatVtexError(err, `Failed to fetch computed price for item ${itemId} and table ${priceTableId}`)\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AACjC,SAAS,8BAA8B;AACvC,SAAS,kBAAkB;AAC3B,SAAS,qCAAqC;AAEvC,MAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,qBAAqB;AAAA,EACxD,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,wCAAwC;AAAA,EACjF,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,qBAAqB;AAAA,EACtE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EAChE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,sBAAsB;AACvE,CAAC;AAED,eAAsB,qBAAqB;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAwC;AACtC,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,gBAAgB,MAAM,iBAAiB,mBAAmB,QAAQ,cAAc;AAAA,MACpF;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,SAAS;AAAA,QACT,gBAAgB;AAAA,QAChB,iBAAiB,cAAc;AAAA,QAC/B,YAAY,uBAAuB,cAAc,SAAS;AAAA,QAC1D,YAAY,uBAAuB,cAAc,SAAS;AAAA,QAC1D,eAAe,uBAAuB,cAAc,YAAY;AAAA,QAChE,mBAAmB,cAAc;AAAA,MACnC,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,gBAAgB,KAAK,2CAA2C,MAAM,cAAc,YAAY,EAAE;AAAA,IACpG;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/index.js

@@ -8,4 +8,5 @@ export * from "./sku-price.js";
 export * from "./computed-price.js";
 export * from "./product-offers.js";
 export * from "./sku-offers.js";
+export * from "./profile-resolution.js";
 //# sourceMappingURL=index.js.map

package/dist/src/tools/vtex/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/index.ts"],
-  "sourcesContent": ["export * from \"./orders-summary.js\";\nexport * from \"./order-details.js\";\nexport * from \"./inventory-check.js\";\nexport * from \"./warehouse-inventory.js\";\nexport * from \"./update-inventory.js\";\nexport * from \"./update-lead-time.js\";\nexport * from \"./sku-price.js\";\nexport * from \"./computed-price.js\";\nexport * from \"./product-offers.js\";\nexport * from \"./sku-offers.js\";\n"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from \"./orders-summary.js\";\nexport * from \"./order-details.js\";\nexport * from \"./inventory-check.js\";\nexport * from \"./warehouse-inventory.js\";\nexport * from \"./update-inventory.js\";\nexport * from \"./update-lead-time.js\";\nexport * from \"./sku-price.js\";\nexport * from \"./computed-price.js\";\nexport * from \"./product-offers.js\";\nexport * from \"./sku-offers.js\";\nexport * from \"./profile-resolution.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/dist/src/tools/vtex/inventory-check.js

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { formatVtexError } from "../../services/vtex/vtex-api.js";
 import { getInventoryBySkuBatch } from "../../services/vtex/vtex-logistics.js";
 import { stripNulls } from "../../utils/strip-payload.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const MAX_SKU_IDS = 50;
 const MAX_CONCURRENT_REQUESTS = 10;
 const MAX_RETRIES_PER_SKU = 2;
@@ -36,12 +37,23 @@ function formatCompactUtcDate(dateTime) {
   return `${match[1]} ${match[2]}`;
 }
 const inventoryCheckSchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   skuIds: z.array(z.string().trim().min(1).describe("SKU identifier")).min(1).max(MAX_SKU_IDS).describe("List of SKU identifiers to fetch (up to 50 IDs)")
 });
-async function inventoryCheckHandler({ skuIds }) {
+async function inventoryCheckHandler({
+  profileId,
+  skuIds
+}) {
   try {
+    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
     const uniqueSkuIds = Array.from(new Set(skuIds));
-    const batchResult = await getInventoryBySkuBatch(uniqueSkuIds, {
+    const batchResult = await getInventoryBySkuBatch(resolvedProfileId, uniqueSkuIds, {
       maxConcurrency: MAX_CONCURRENT_REQUESTS,
       maxRetries: MAX_RETRIES_PER_SKU
     });
@@ -116,6 +128,7 @@ async function inventoryCheckHandler({ skuIds }) {
     return object(
       stripNulls({
         metadata: {
+          profile_id: resolvedProfileId,
           requested_ids: skuIds.length,
           unique_ids: uniqueSkuIds.length,
           max_parallel_requests: MAX_CONCURRENT_REQUESTS,

package/dist/src/tools/vtex/inventory-check.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/inventory-check.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getInventoryBySkuBatch } from \"../../services/vtex/vtex-logistics.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\ntype HealthStatus = \"HEALTHY\" | \"LOW_STOCK\" | \"CRITICAL_LOW_STOCK\" | \"OUT_OF_STOCK\";\ntype SkuInventoryRow = [string, number, HealthStatus];\ntype WarehouseBalanceBaseRow = [string, number, number, boolean];\ntype WarehouseBalanceWithRefillRow = [...WarehouseBalanceBaseRow, string];\ntype WarehouseBalanceWithDateRow = [...WarehouseBalanceBaseRow, string];\ntype WarehouseBalanceFullRow = [...WarehouseBalanceBaseRow, string, string];\ntype WarehouseBalanceRow =\n  | WarehouseBalanceBaseRow\n  | WarehouseBalanceWithRefillRow\n  | WarehouseBalanceWithDateRow\n  | WarehouseBalanceFullRow;\n\nconst MAX_SKU_IDS = 50;\nconst MAX_CONCURRENT_REQUESTS = 10;\nconst MAX_RETRIES_PER_SKU = 2;\n\nfunction inferHealthStatus(globalAvailableQuantity: number, hasUnlimitedQuantity: boolean): HealthStatus {\n  if (hasUnlimitedQuantity) {\n    return \"HEALTHY\";\n  }\n\n  if (globalAvailableQuantity <= 0) {\n    return \"OUT_OF_STOCK\";\n  }\n\n  if (globalAvailableQuantity < 5) {\n    return \"CRITICAL_LOW_STOCK\";\n  }\n\n  if (globalAvailableQuantity < 20) {\n    return \"LOW_STOCK\";\n  }\n\n  return \"HEALTHY\";\n}\n\nfunction toNumber(value: unknown): number {\n  const parsedValue = Number(value);\n  return Number.isFinite(parsedValue) ? parsedValue : 0;\n}\n\nfunction formatCompactUtcDate(dateTime?: string): string {\n  if (!dateTime) {\n    return \"\";\n  }\n\n  const match = dateTime.match(/^(\\d{4}-\\d{2}-\\d{2})T(\\d{2}:\\d{2})/);\n  if (!match) {\n    return dateTime;\n  }\n\n  return `${match[1]} ${match[2]}`;\n}\n\nexport const inventoryCheckSchema = z.object({\n  skuIds: z\n    .array(z.string().trim().min(1).describe(\"SKU identifier\"))\n    .min(1)\n    .max(MAX_SKU_IDS)\n    .describe(\"List of SKU identifiers to fetch (up to 50 IDs)\"),\n});\n\nexport async function inventoryCheckHandler({ skuIds }: z.infer<typeof inventoryCheckSchema>) {\n  try {\n    const uniqueSkuIds = Array.from(new Set(skuIds));\n    const batchResult = await getInventoryBySkuBatch(uniqueSkuIds, {\n      maxConcurrency: MAX_CONCURRENT_REQUESTS,\n      maxRetries: MAX_RETRIES_PER_SKU,\n    });\n\n    const hasAnyTimeToRefill = batchResult.successful.some(({ document }) =>\n      (Array.isArray(document.balance) ? document.balance : []).some(\n        (balance) => typeof balance.timeToRefill === \"string\" && balance.timeToRefill.trim().length > 0\n      )\n    );\n    const hasAnyDateOfSupplyUtc = batchResult.successful.some(({ document }) =>\n      (Array.isArray(document.balance) ? document.balance : []).some(\n        (balance) =>\n          typeof balance.dateOfSupplyUtc === \"string\" && balance.dateOfSupplyUtc.trim().length > 0\n      )\n    );\n\n    const warehouseBalanceSchema = [\"warehouseName\", \"totalQuantity\", \"reservedQuantity\", \"hasUnlimitedQuantity\"];\n    if (hasAnyTimeToRefill) {\n      warehouseBalanceSchema.push(\"timeToRefill\");\n    }\n    if (hasAnyDateOfSupplyUtc) {\n      warehouseBalanceSchema.push(\"dateOfSupplyUtc\");\n    }\n\n    const inventory = batchResult.successful.map(({ skuId, document }) => {\n      const balances = Array.isArray(document.balance) ? document.balance : [];\n      const warehouses: WarehouseBalanceRow[] = balances.map((balance) => {\n        const totalQuantity = toNumber(balance.totalQuantity);\n        const reservedQuantity = toNumber(balance.reservedQuantity);\n        const availableQuantityRaw = balance.availableQuantity;\n        const availableQuantity =\n          availableQuantityRaw === undefined\n            ? Math.max(0, totalQuantity - reservedQuantity)\n            : toNumber(availableQuantityRaw);\n        const hasUnlimitedQuantity = Boolean(\n          balance.hasUnlimitedQuantity ?? balance.isUnlimited ?? false\n        );\n\n        const warehouseBase: WarehouseBalanceBaseRow = [\n          balance.warehouseName ?? balance.warehouseId ?? \"unknown\",\n          totalQuantity,\n          reservedQuantity,\n          hasUnlimitedQuantity,\n        ];\n\n        if (hasAnyTimeToRefill && hasAnyDateOfSupplyUtc) {\n          return [\n            ...warehouseBase,\n            balance.timeToRefill ?? \"\",\n            formatCompactUtcDate(balance.dateOfSupplyUtc),\n          ];\n        }\n\n        if (hasAnyTimeToRefill) {\n          return [...warehouseBase, balance.timeToRefill ?? \"\"];\n        }\n\n        if (hasAnyDateOfSupplyUtc) {\n          return [...warehouseBase, formatCompactUtcDate(balance.dateOfSupplyUtc)];\n        }\n\n        return warehouseBase;\n      });\n\n      const globalAvailableQuantity = balances.reduce((accumulator, balance) => {\n        const totalQuantity = toNumber(balance.totalQuantity);\n        const reservedQuantity = toNumber(balance.reservedQuantity);\n        const availableQuantityRaw = balance.availableQuantity;\n        const availableQuantity =\n          availableQuantityRaw === undefined\n            ? Math.max(0, totalQuantity - reservedQuantity)\n            : toNumber(availableQuantityRaw);\n        return accumulator + availableQuantity;\n      }, 0);\n      const hasUnlimitedQuantity = balances.some((balance) =>\n        Boolean(balance.hasUnlimitedQuantity ?? balance.isUnlimited ?? false)\n      );\n      const skuRow: SkuInventoryRow = [\n        document.skuId ?? skuId,\n        globalAvailableQuantity,\n        inferHealthStatus(globalAvailableQuantity, hasUnlimitedQuantity),\n      ];\n\n      return {\n        sku: skuRow,\n        warehouses,\n      };\n    });\n\n    return object(\n      stripNulls({\n        metadata: {\n          requested_ids: skuIds.length,\n          unique_ids: uniqueSkuIds.length,\n          max_parallel_requests: MAX_CONCURRENT_REQUESTS,\n          successful_items: batchResult.successful.length,\n          failed_items: batchResult.failed.length,\n          has_failures: batchResult.failed.length > 0,\n        },\n        inventory_schema: {\n          sku: [\"sku_id\", \"global_available_quantity\", \"health_status\"],\n          warehouse_balance: warehouseBalanceSchema,\n        },\n        inventory,\n        failures: batchResult.failed.map((failure) => ({\n          sku_id: failure.skuId,\n          message: failure.message,\n          status_code: failure.statusCode,\n          attempts: failure.attempts,\n          retryable: failure.retryable,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, \"Failed to check inventory batch\"));\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getInventoryBySkuBatch } from \"../../services/vtex/vtex-logistics.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\ntype HealthStatus = \"HEALTHY\" | \"LOW_STOCK\" | \"CRITICAL_LOW_STOCK\" | \"OUT_OF_STOCK\";\ntype SkuInventoryRow = [string, number, HealthStatus];\ntype WarehouseBalanceBaseRow = [string, number, number, boolean];\ntype WarehouseBalanceWithRefillRow = [...WarehouseBalanceBaseRow, string];\ntype WarehouseBalanceWithDateRow = [...WarehouseBalanceBaseRow, string];\ntype WarehouseBalanceFullRow = [...WarehouseBalanceBaseRow, string, string];\ntype WarehouseBalanceRow =\n  | WarehouseBalanceBaseRow\n  | WarehouseBalanceWithRefillRow\n  | WarehouseBalanceWithDateRow\n  | WarehouseBalanceFullRow;\n\nconst MAX_SKU_IDS = 50;\nconst MAX_CONCURRENT_REQUESTS = 10;\nconst MAX_RETRIES_PER_SKU = 2;\n\nfunction inferHealthStatus(globalAvailableQuantity: number, hasUnlimitedQuantity: boolean): HealthStatus {\n  if (hasUnlimitedQuantity) {\n    return \"HEALTHY\";\n  }\n\n  if (globalAvailableQuantity <= 0) {\n    return \"OUT_OF_STOCK\";\n  }\n\n  if (globalAvailableQuantity < 5) {\n    return \"CRITICAL_LOW_STOCK\";\n  }\n\n  if (globalAvailableQuantity < 20) {\n    return \"LOW_STOCK\";\n  }\n\n  return \"HEALTHY\";\n}\n\nfunction toNumber(value: unknown): number {\n  const parsedValue = Number(value);\n  return Number.isFinite(parsedValue) ? parsedValue : 0;\n}\n\nfunction formatCompactUtcDate(dateTime?: string): string {\n  if (!dateTime) {\n    return \"\";\n  }\n\n  const match = dateTime.match(/^(\\d{4}-\\d{2}-\\d{2})T(\\d{2}:\\d{2})/);\n  if (!match) {\n    return dateTime;\n  }\n\n  return `${match[1]} ${match[2]}`;\n}\n\nexport const inventoryCheckSchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  skuIds: z\n    .array(z.string().trim().min(1).describe(\"SKU identifier\"))\n    .min(1)\n    .max(MAX_SKU_IDS)\n    .describe(\"List of SKU identifiers to fetch (up to 50 IDs)\"),\n});\n\nexport async function inventoryCheckHandler({\n  profileId,\n  skuIds,\n}: z.infer<typeof inventoryCheckSchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const uniqueSkuIds = Array.from(new Set(skuIds));\n    const batchResult = await getInventoryBySkuBatch(resolvedProfileId, uniqueSkuIds, {\n      maxConcurrency: MAX_CONCURRENT_REQUESTS,\n      maxRetries: MAX_RETRIES_PER_SKU,\n    });\n\n    const hasAnyTimeToRefill = batchResult.successful.some(({ document }) =>\n      (Array.isArray(document.balance) ? document.balance : []).some(\n        (balance) => typeof balance.timeToRefill === \"string\" && balance.timeToRefill.trim().length > 0\n      )\n    );\n    const hasAnyDateOfSupplyUtc = batchResult.successful.some(({ document }) =>\n      (Array.isArray(document.balance) ? document.balance : []).some(\n        (balance) =>\n          typeof balance.dateOfSupplyUtc === \"string\" && balance.dateOfSupplyUtc.trim().length > 0\n      )\n    );\n\n    const warehouseBalanceSchema = [\"warehouseName\", \"totalQuantity\", \"reservedQuantity\", \"hasUnlimitedQuantity\"];\n    if (hasAnyTimeToRefill) {\n      warehouseBalanceSchema.push(\"timeToRefill\");\n    }\n    if (hasAnyDateOfSupplyUtc) {\n      warehouseBalanceSchema.push(\"dateOfSupplyUtc\");\n    }\n\n    const inventory = batchResult.successful.map(({ skuId, document }) => {\n      const balances = Array.isArray(document.balance) ? document.balance : [];\n      const warehouses: WarehouseBalanceRow[] = balances.map((balance) => {\n        const totalQuantity = toNumber(balance.totalQuantity);\n        const reservedQuantity = toNumber(balance.reservedQuantity);\n        const availableQuantityRaw = balance.availableQuantity;\n        const availableQuantity =\n          availableQuantityRaw === undefined\n            ? Math.max(0, totalQuantity - reservedQuantity)\n            : toNumber(availableQuantityRaw);\n        const hasUnlimitedQuantity = Boolean(\n          balance.hasUnlimitedQuantity ?? balance.isUnlimited ?? false\n        );\n\n        const warehouseBase: WarehouseBalanceBaseRow = [\n          balance.warehouseName ?? balance.warehouseId ?? \"unknown\",\n          totalQuantity,\n          reservedQuantity,\n          hasUnlimitedQuantity,\n        ];\n\n        if (hasAnyTimeToRefill && hasAnyDateOfSupplyUtc) {\n          return [\n            ...warehouseBase,\n            balance.timeToRefill ?? \"\",\n            formatCompactUtcDate(balance.dateOfSupplyUtc),\n          ];\n        }\n\n        if (hasAnyTimeToRefill) {\n          return [...warehouseBase, balance.timeToRefill ?? \"\"];\n        }\n\n        if (hasAnyDateOfSupplyUtc) {\n          return [...warehouseBase, formatCompactUtcDate(balance.dateOfSupplyUtc)];\n        }\n\n        return warehouseBase;\n      });\n\n      const globalAvailableQuantity = balances.reduce((accumulator, balance) => {\n        const totalQuantity = toNumber(balance.totalQuantity);\n        const reservedQuantity = toNumber(balance.reservedQuantity);\n        const availableQuantityRaw = balance.availableQuantity;\n        const availableQuantity =\n          availableQuantityRaw === undefined\n            ? Math.max(0, totalQuantity - reservedQuantity)\n            : toNumber(availableQuantityRaw);\n        return accumulator + availableQuantity;\n      }, 0);\n      const hasUnlimitedQuantity = balances.some((balance) =>\n        Boolean(balance.hasUnlimitedQuantity ?? balance.isUnlimited ?? false)\n      );\n      const skuRow: SkuInventoryRow = [\n        document.skuId ?? skuId,\n        globalAvailableQuantity,\n        inferHealthStatus(globalAvailableQuantity, hasUnlimitedQuantity),\n      ];\n\n      return {\n        sku: skuRow,\n        warehouses,\n      };\n    });\n\n    return object(\n      stripNulls({\n        metadata: {\n          profile_id: resolvedProfileId,\n          requested_ids: skuIds.length,\n          unique_ids: uniqueSkuIds.length,\n          max_parallel_requests: MAX_CONCURRENT_REQUESTS,\n          successful_items: batchResult.successful.length,\n          failed_items: batchResult.failed.length,\n          has_failures: batchResult.failed.length > 0,\n        },\n        inventory_schema: {\n          sku: [\"sku_id\", \"global_available_quantity\", \"health_status\"],\n          warehouse_balance: warehouseBalanceSchema,\n        },\n        inventory,\n        failures: batchResult.failed.map((failure) => ({\n          sku_id: failure.skuId,\n          message: failure.message,\n          status_code: failure.statusCode,\n          attempts: failure.attempts,\n          retryable: failure.retryable,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, \"Failed to check inventory batch\"));\n  }\n}\n"],
+  "mappings": "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",
   "names": ["hasUnlimitedQuantity"]
 }

package/dist/src/tools/vtex/order-details.js

@@ -4,17 +4,30 @@ import { getOrderDocumentsBatch } from "../../services/vtex/vtex-orders.js";
 import { formatVtexError } from "../../services/vtex/vtex-api.js";
 import { formatOrderDetails } from "../../utils/format-order-details.js";
 import { stripNulls } from "../../utils/strip-payload.js";
+import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
 const MAX_ORDER_IDS = 50;
 const MAX_CONCURRENT_REQUESTS = 10;
 const MAX_RETRIES_PER_ORDER = 2;
 const orderDetailsSchema = z.object({
+  profileId: z.string().trim().min(1).optional().describe(
+    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
+  ),
   orderIds: z.array(z.string().trim().min(3).describe("VTEX order identifier")).min(1).max(MAX_ORDER_IDS).describe("List of VTEX order identifiers to fetch (up to 50 IDs)"),
   reason: z.string().trim().min(1).optional().describe("Optional reason for requesting unmasked PII data when required")
 });
-async function orderDetailsHandler({ orderIds, reason }) {
+async function orderDetailsHandler({
+  profileId,
+  orderIds,
+  reason
+}) {
   try {
+    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
     const uniqueOrderIds = Array.from(new Set(orderIds));
-    const batchResult = await getOrderDocumentsBatch(uniqueOrderIds, {
+    const batchResult = await getOrderDocumentsBatch(resolvedProfileId, uniqueOrderIds, {
       reason,
       maxConcurrency: MAX_CONCURRENT_REQUESTS,
       maxRetries: MAX_RETRIES_PER_ORDER
@@ -23,6 +36,7 @@ async function orderDetailsHandler({ orderIds, reason }) {
     return object(
       stripNulls({
         metadata: {
+          profile_id: resolvedProfileId,
           requested: uniqueOrderIds.length,
           successful: batchResult.successful.length,
           failed: batchResult.failed.length