@yoryoboy/bi-mcp 1.4.0 → 1.5.0

package/dist/src/tools/mercadolibre/predict-category.js

@@ -0,0 +1,49 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { formatMercadoLibreError } from "../../services/mercadolibre/mercadolibre-api.js";
+import { searchMercadoLibreDomainDiscovery } from "../../services/mercadolibre/mercadolibre-items.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import { asArray, normalizeString, toNumber } from "./helpers.js";
+import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
+import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
+const meliPredictCategorySchema = z.object({
+  profileId: mercadolibreProfileIdSchemaField,
+  query: z.string().trim().min(2).describe("Search phrase describing the product to categorize."),
+  siteId: z.string().trim().min(3).optional().describe("MercadoLibre site id. Defaults to MLA."),
+  limit: z.number().int().min(1).max(8).optional().describe("Maximum candidate categories to return. Defaults to 5.")
+});
+async function meliPredictCategoryHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const candidates = await searchMercadoLibreDomainDiscovery(
+      profileResolution.value.profileId,
+      params.query,
+      params.limit ?? 5,
+      params.siteId ?? "MLA"
+    );
+    return object(
+      stripNulls({
+        profile_id: profileResolution.value.profileId,
+        query: params.query,
+        site_id: params.siteId ?? "MLA",
+        candidates: asArray(candidates).map((candidate) => ({
+          category_id: normalizeString(candidate.category_id),
+          category_name: normalizeString(candidate.category_name),
+          domain_id: normalizeString(candidate.domain_id),
+          domain_name: normalizeString(candidate.domain_name),
+          attributes_matched: toNumber(candidate.attributes_matched)
+        }))
+      })
+    );
+  } catch (err) {
+    return error(formatMercadoLibreError(err, "Failed to predict MercadoLibre category"));
+  }
+}
+export {
+  meliPredictCategoryHandler,
+  meliPredictCategorySchema
+};
+//# sourceMappingURL=predict-category.js.map

package/dist/src/tools/mercadolibre/predict-category.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/predict-category.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { searchMercadoLibreDomainDiscovery } from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, normalizeString, toNumber } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nexport const meliPredictCategorySchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  query: z.string().trim().min(2).describe(\"Search phrase describing the product to categorize.\"),\n  siteId: z.string().trim().min(3).optional().describe(\"MercadoLibre site id. Defaults to MLA.\"),\n  limit: z.number().int().min(1).max(8).optional().describe(\"Maximum candidate categories to return. Defaults to 5.\"),\n});\n\nexport async function meliPredictCategoryHandler(params: z.infer<typeof meliPredictCategorySchema>) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const candidates = await searchMercadoLibreDomainDiscovery(\n      profileResolution.value.profileId,\n      params.query,\n      params.limit ?? 5,\n      params.siteId ?? \"MLA\"\n    );\n\n    return object(\n      stripNulls({\n        profile_id: profileResolution.value.profileId,\n        query: params.query,\n        site_id: params.siteId ?? \"MLA\",\n        candidates: asArray<Record<string, unknown>>(candidates).map((candidate) => ({\n          category_id: normalizeString(candidate.category_id),\n          category_name: normalizeString(candidate.category_name),\n          domain_id: normalizeString(candidate.domain_id),\n          domain_name: normalizeString(candidate.domain_name),\n          attributes_matched: toNumber(candidate.attributes_matched),\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to predict MercadoLibre category\"));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,+BAA+B;AACxC,SAAS,yCAAyC;AAClD,SAAS,kBAAkB;AAC3B,SAAS,SAAS,iBAAiB,gBAAgB;AACnD,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAE1C,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,qDAAqD;AAAA,EAC9F,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,wCAAwC;AAAA,EAC7F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,wDAAwD;AACpH,CAAC;AAED,eAAsB,2BAA2B,QAAmD;AAClG,MAAI;AACF,UAAM,oBAAoB,MAAM,sCAAsC,OAAO,SAAS;AACtF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,aAAa,MAAM;AAAA,MACvB,kBAAkB,MAAM;AAAA,MACxB,OAAO;AAAA,MACP,OAAO,SAAS;AAAA,MAChB,OAAO,UAAU;AAAA,IACnB;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY,kBAAkB,MAAM;AAAA,QACpC,OAAO,OAAO;AAAA,QACd,SAAS,OAAO,UAAU;AAAA,QAC1B,YAAY,QAAiC,UAAU,EAAE,IAAI,CAAC,eAAe;AAAA,UAC3E,aAAa,gBAAgB,UAAU,WAAW;AAAA,UAClD,eAAe,gBAAgB,UAAU,aAAa;AAAA,UACtD,WAAW,gBAAgB,UAAU,SAAS;AAAA,UAC9C,aAAa,gBAAgB,UAAU,WAAW;AAAA,UAClD,oBAAoB,SAAS,UAAU,kBAAkB;AAAA,QAC3D,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,yCAAyC,CAAC;AAAA,EACtF;AACF;",
+  "names": []
+}

package/dist/src/tools/mercadolibre/profile-resolution.js

@@ -0,0 +1,56 @@
+import { object } from "mcp-use/server";
+import { getProfile, listProfiles } from "../../config/profile-store.js";
+function buildSelectionMessage(reason, profileId) {
+  switch (reason) {
+    case "missing_profile":
+      return "MercadoLibre requiere seleccion explicita de profileId. Reenviar la misma tool con uno de los perfiles activos disponibles.";
+    case "profile_not_found":
+      return `El profileId "${profileId}" no existe. Reenviar la misma tool con uno de los perfiles activos disponibles.`;
+    case "profile_inactive":
+      return `El profileId "${profileId}" esta inactivo. Reenviar la misma tool con uno de los perfiles activos disponibles.`;
+  }
+}
+async function buildSelectionResponse(reason, profileId) {
+  const profiles = await listProfiles({ activeOnly: true });
+  return object({
+    selection_required: true,
+    reason,
+    message: buildSelectionMessage(reason, profileId),
+    available_profiles: profiles.map((profile) => ({
+      profile_id: profile.id,
+      name: profile.name
+    }))
+  });
+}
+async function resolveMercadoLibreProfileOrSelection(profileId) {
+  const requestedProfileId = profileId?.trim();
+  if (!requestedProfileId) {
+    return {
+      ok: false,
+      response: await buildSelectionResponse("missing_profile")
+    };
+  }
+  const profile = await getProfile(requestedProfileId);
+  if (!profile) {
+    return {
+      ok: false,
+      response: await buildSelectionResponse("profile_not_found", requestedProfileId)
+    };
+  }
+  if (!profile.isActive) {
+    return {
+      ok: false,
+      response: await buildSelectionResponse("profile_inactive", requestedProfileId)
+    };
+  }
+  return {
+    ok: true,
+    value: {
+      profileId: profile.id
+    }
+  };
+}
+export {
+  resolveMercadoLibreProfileOrSelection
+};
+//# sourceMappingURL=profile-resolution.js.map

package/dist/src/tools/mercadolibre/profile-resolution.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/profile-resolution.ts"],
+  "sourcesContent": ["import { object } from \"mcp-use/server\";\n\nimport { getProfile, listProfiles } from \"../../config/profile-store.js\";\n\nexport type MercadoLibreProfileSelectionReason =\n  | \"missing_profile\"\n  | \"profile_not_found\"\n  | \"profile_inactive\";\n\nexport interface ResolvedMercadoLibreProfile {\n  profileId: string;\n}\n\nfunction buildSelectionMessage(\n  reason: MercadoLibreProfileSelectionReason,\n  profileId?: string\n): string {\n  switch (reason) {\n    case \"missing_profile\":\n      return \"MercadoLibre requiere seleccion explicita de profileId. Reenviar la misma tool con uno de los perfiles activos disponibles.\";\n    case \"profile_not_found\":\n      return `El profileId \"${profileId}\" no existe. Reenviar la misma tool con uno de los perfiles activos disponibles.`;\n    case \"profile_inactive\":\n      return `El profileId \"${profileId}\" esta inactivo. Reenviar la misma tool con uno de los perfiles activos disponibles.`;\n  }\n}\n\nasync function buildSelectionResponse(\n  reason: MercadoLibreProfileSelectionReason,\n  profileId?: string\n) {\n  const profiles = await listProfiles({ activeOnly: true });\n  return object({\n    selection_required: true,\n    reason,\n    message: buildSelectionMessage(reason, profileId),\n    available_profiles: profiles.map((profile) => ({\n      profile_id: profile.id,\n      name: profile.name,\n    })),\n  });\n}\n\nexport async function resolveMercadoLibreProfileOrSelection(\n  profileId?: string\n): Promise<\n  | { ok: true; value: ResolvedMercadoLibreProfile }\n  | { ok: false; response: ReturnType<typeof object<Record<string, unknown>>> }\n> {\n  const requestedProfileId = profileId?.trim();\n\n  if (!requestedProfileId) {\n    return {\n      ok: false,\n      response: await buildSelectionResponse(\"missing_profile\"),\n    };\n  }\n\n  const profile = await getProfile(requestedProfileId);\n  if (!profile) {\n    return {\n      ok: false,\n      response: await buildSelectionResponse(\"profile_not_found\", requestedProfileId),\n    };\n  }\n\n  if (!profile.isActive) {\n    return {\n      ok: false,\n      response: await buildSelectionResponse(\"profile_inactive\", requestedProfileId),\n    };\n  }\n\n  return {\n    ok: true,\n    value: {\n      profileId: profile.id,\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,cAAc;AAEvB,SAAS,YAAY,oBAAoB;AAWzC,SAAS,sBACP,QACA,WACQ;AACR,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,iBAAiB,SAAS;AAAA,IACnC,KAAK;AACH,aAAO,iBAAiB,SAAS;AAAA,EACrC;AACF;AAEA,eAAe,uBACb,QACA,WACA;AACA,QAAM,WAAW,MAAM,aAAa,EAAE,YAAY,KAAK,CAAC;AACxD,SAAO,OAAO;AAAA,IACZ,oBAAoB;AAAA,IACpB;AAAA,IACA,SAAS,sBAAsB,QAAQ,SAAS;AAAA,IAChD,oBAAoB,SAAS,IAAI,CAAC,aAAa;AAAA,MAC7C,YAAY,QAAQ;AAAA,MACpB,MAAM,QAAQ;AAAA,IAChB,EAAE;AAAA,EACJ,CAAC;AACH;AAEA,eAAsB,sCACpB,WAIA;AACA,QAAM,qBAAqB,WAAW,KAAK;AAE3C,MAAI,CAAC,oBAAoB;AACvB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,UAAU,MAAM,uBAAuB,iBAAiB;AAAA,IAC1D;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,WAAW,kBAAkB;AACnD,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,UAAU,MAAM,uBAAuB,qBAAqB,kBAAkB;AAAA,IAChF;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,UAAU;AACrB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,UAAU,MAAM,uBAAuB,oBAAoB,kBAAkB;AAAA,IAC/E;AAAA,EACF;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,WAAW,QAAQ;AAAA,IACrB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/tools/mercadolibre/search-items.js

@@ -0,0 +1,91 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { getMercadoLibreAccessForProfile } from "../../config/mercadolibre.js";
+import {
+  buildMercadoLibrePaginationMetadata,
+  formatMercadoLibreError,
+  normalizeMercadoLibrePaging
+} from "../../services/mercadolibre/mercadolibre-api.js";
+import {
+  getMercadoLibreItemDetailsBatch,
+  searchMercadoLibreItems
+} from "../../services/mercadolibre/mercadolibre-items.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import { asArray, normalizeString, toNumber } from "./helpers.js";
+import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
+import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
+const meliSearchItemsSchema = z.object({
+  profileId: mercadolibreProfileIdSchemaField,
+  status: z.string().trim().min(1).optional().describe("Optional item status filter."),
+  category: z.string().trim().min(1).optional().describe("Optional category id filter."),
+  listingTypeId: z.string().trim().min(1).optional().describe("Optional listing type filter."),
+  orders: z.string().trim().min(1).optional().describe("Optional MercadoLibre sort expression for items search."),
+  includeDetails: z.boolean().optional().describe("Whether to multiget compact item details for returned item ids."),
+  limit: z.number().int().min(1).max(50).optional().describe("Results per page (1-50)."),
+  offset: z.number().int().min(0).max(5e3).optional().describe("Pagination offset.")
+});
+async function meliSearchItemsHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    const access = await getMercadoLibreAccessForProfile(profileId);
+    const searchResponse = await searchMercadoLibreItems(profileId, {
+      sellerId: access.sellerId,
+      status: params.status,
+      category: params.category,
+      listingTypeId: params.listingTypeId,
+      orders: params.orders,
+      limit: params.limit ?? 20,
+      offset: params.offset ?? 0
+    });
+    const itemIds = asArray(searchResponse.results).map((value) => normalizeString(value)).filter(Boolean);
+    const compactItems = params.includeDetails ? await getMercadoLibreItemDetailsBatch(profileId, itemIds.slice(0, 20), [
+      "id",
+      "title",
+      "status",
+      "price",
+      "currency_id",
+      "available_quantity",
+      "sold_quantity",
+      "listing_type_id",
+      "permalink",
+      "thumbnail"
+    ]) : [];
+    const paging = normalizeMercadoLibrePaging(searchResponse.paging);
+    return object(
+      stripNulls({
+        profile_id: profileId,
+        metadata: buildMercadoLibrePaginationMetadata({
+          total: paging.total,
+          limit: paging.limit || params.limit || itemIds.length,
+          offset: paging.offset || params.offset || 0,
+          returned: itemIds.length,
+          nextField: "offset"
+        }),
+        item_ids: itemIds,
+        items: compactItems.map((item) => ({
+          item_id: normalizeString(item.id),
+          title: normalizeString(item.title),
+          status: normalizeString(item.status),
+          price: toNumber(item.price),
+          currency_id: normalizeString(item.currency_id, "UNKNOWN"),
+          available_quantity: toNumber(item.available_quantity),
+          sold_quantity: toNumber(item.sold_quantity),
+          listing_type_id: normalizeString(item.listing_type_id),
+          permalink: normalizeString(item.permalink),
+          thumbnail: normalizeString(item.thumbnail)
+        }))
+      })
+    );
+  } catch (err) {
+    return error(formatMercadoLibreError(err, "Failed to search MercadoLibre items"));
+  }
+}
+export {
+  meliSearchItemsHandler,
+  meliSearchItemsSchema
+};
+//# sourceMappingURL=search-items.js.map

package/dist/src/tools/mercadolibre/search-items.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/search-items.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\nimport {\n  buildMercadoLibrePaginationMetadata,\n  formatMercadoLibreError,\n  normalizeMercadoLibrePaging,\n} from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport {\n  getMercadoLibreItemDetailsBatch,\n  searchMercadoLibreItems,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, normalizeString, toNumber } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nexport const meliSearchItemsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  status: z.string().trim().min(1).optional().describe(\"Optional item status filter.\"),\n  category: z.string().trim().min(1).optional().describe(\"Optional category id filter.\"),\n  listingTypeId: z.string().trim().min(1).optional().describe(\"Optional listing type filter.\"),\n  orders: z.string().trim().min(1).optional().describe(\"Optional MercadoLibre sort expression for items search.\"),\n  includeDetails: z.boolean().optional().describe(\"Whether to multiget compact item details for returned item ids.\"),\n  limit: z.number().int().min(1).max(50).optional().describe(\"Results per page (1-50).\"),\n  offset: z.number().int().min(0).max(5000).optional().describe(\"Pagination offset.\"),\n});\n\nexport async function meliSearchItemsHandler(params: z.infer<typeof meliSearchItemsSchema>) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const access = await getMercadoLibreAccessForProfile(profileId);\n    const searchResponse = await searchMercadoLibreItems(profileId, {\n      sellerId: access.sellerId,\n      status: params.status,\n      category: params.category,\n      listingTypeId: params.listingTypeId,\n      orders: params.orders,\n      limit: params.limit ?? 20,\n      offset: params.offset ?? 0,\n    });\n\n    const itemIds = asArray<string>(searchResponse.results).map((value) => normalizeString(value)).filter(Boolean);\n    const compactItems = params.includeDetails\n      ? await getMercadoLibreItemDetailsBatch(profileId, itemIds.slice(0, 20), [\n          \"id\",\n          \"title\",\n          \"status\",\n          \"price\",\n          \"currency_id\",\n          \"available_quantity\",\n          \"sold_quantity\",\n          \"listing_type_id\",\n          \"permalink\",\n          \"thumbnail\",\n        ])\n      : [];\n\n    const paging = normalizeMercadoLibrePaging(searchResponse.paging as Record<string, unknown>);\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        metadata: buildMercadoLibrePaginationMetadata({\n          total: paging.total,\n          limit: paging.limit || params.limit || itemIds.length,\n          offset: paging.offset || params.offset || 0,\n          returned: itemIds.length,\n          nextField: \"offset\",\n        }),\n        item_ids: itemIds,\n        items: compactItems.map((item) => ({\n          item_id: normalizeString(item.id),\n          title: normalizeString(item.title),\n          status: normalizeString(item.status),\n          price: toNumber(item.price),\n          currency_id: normalizeString(item.currency_id, \"UNKNOWN\"),\n          available_quantity: toNumber(item.available_quantity),\n          sold_quantity: toNumber(item.sold_quantity),\n          listing_type_id: normalizeString(item.listing_type_id),\n          permalink: normalizeString(item.permalink),\n          thumbnail: normalizeString(item.thumbnail),\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to search MercadoLibre items\"));\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/mercadolibre/search-questions.js

@@ -0,0 +1,71 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { getMercadoLibreAccessForProfile } from "../../config/mercadolibre.js";
+import {
+  buildMercadoLibrePaginationMetadata,
+  formatMercadoLibreError,
+  normalizeMercadoLibrePaging
+} from "../../services/mercadolibre/mercadolibre-api.js";
+import { searchMercadoLibreQuestions } from "../../services/mercadolibre/mercadolibre-questions.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import { asArray, asRecord, compactDateTime, normalizeString } from "./helpers.js";
+import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
+import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
+const meliSearchQuestionsSchema = z.object({
+  profileId: mercadolibreProfileIdSchemaField,
+  itemId: z.string().trim().min(1).optional().describe("Optional MercadoLibre item id filter."),
+  status: z.string().trim().min(1).optional().describe("Optional question status filter."),
+  limit: z.number().int().min(1).max(50).optional().describe("Results per page (1-50)."),
+  offset: z.number().int().min(0).max(5e3).optional().describe("Pagination offset.")
+});
+async function meliSearchQuestionsHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    const access = await getMercadoLibreAccessForProfile(profileId);
+    const response = await searchMercadoLibreQuestions(profileId, {
+      sellerId: access.sellerId,
+      itemId: params.itemId,
+      status: params.status,
+      limit: params.limit ?? 20,
+      offset: params.offset ?? 0
+    });
+    const questions = asArray(response.questions ?? response.results);
+    const paging = normalizeMercadoLibrePaging(asRecord(response.paging));
+    return object(
+      stripNulls({
+        profile_id: profileId,
+        metadata: buildMercadoLibrePaginationMetadata({
+          total: paging.total || questions.length,
+          limit: paging.limit || params.limit || questions.length,
+          offset: paging.offset || params.offset || 0,
+          returned: questions.length,
+          nextField: "offset"
+        }),
+        questions: questions.map((question) => ({
+          question_id: question.id,
+          item_id: normalizeString(question.item_id),
+          item_title: normalizeString(asRecord(question.item).title),
+          status: normalizeString(question.status),
+          text: normalizeString(question.text),
+          date_created: compactDateTime(question.date_created),
+          from: stripNulls({
+            id: normalizeString(asRecord(question.from).id),
+            nickname: normalizeString(asRecord(question.from).nickname)
+          }),
+          answer_status: normalizeString(asRecord(question.answer).status)
+        }))
+      })
+    );
+  } catch (err) {
+    return error(formatMercadoLibreError(err, "Failed to search MercadoLibre questions"));
+  }
+}
+export {
+  meliSearchQuestionsHandler,
+  meliSearchQuestionsSchema
+};
+//# sourceMappingURL=search-questions.js.map

package/dist/src/tools/mercadolibre/search-questions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/search-questions.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\nimport {\n  buildMercadoLibrePaginationMetadata,\n  formatMercadoLibreError,\n  normalizeMercadoLibrePaging,\n} from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { searchMercadoLibreQuestions } from \"../../services/mercadolibre/mercadolibre-questions.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { asArray, asRecord, compactDateTime, normalizeString } from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nexport const meliSearchQuestionsSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  itemId: z.string().trim().min(1).optional().describe(\"Optional MercadoLibre item id filter.\"),\n  status: z.string().trim().min(1).optional().describe(\"Optional question status filter.\"),\n  limit: z.number().int().min(1).max(50).optional().describe(\"Results per page (1-50).\"),\n  offset: z.number().int().min(0).max(5000).optional().describe(\"Pagination offset.\"),\n});\n\nexport async function meliSearchQuestionsHandler(\n  params: z.infer<typeof meliSearchQuestionsSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const access = await getMercadoLibreAccessForProfile(profileId);\n    const response = await searchMercadoLibreQuestions(profileId, {\n      sellerId: access.sellerId,\n      itemId: params.itemId,\n      status: params.status,\n      limit: params.limit ?? 20,\n      offset: params.offset ?? 0,\n    });\n\n    const questions = asArray<Record<string, unknown>>(response.questions ?? response.results);\n    const paging = normalizeMercadoLibrePaging(asRecord(response.paging));\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        metadata: buildMercadoLibrePaginationMetadata({\n          total: paging.total || questions.length,\n          limit: paging.limit || params.limit || questions.length,\n          offset: paging.offset || params.offset || 0,\n          returned: questions.length,\n          nextField: \"offset\",\n        }),\n        questions: questions.map((question) => ({\n          question_id: question.id,\n          item_id: normalizeString(question.item_id),\n          item_title: normalizeString(asRecord(question.item).title),\n          status: normalizeString(question.status),\n          text: normalizeString(question.text),\n          date_created: compactDateTime(question.date_created),\n          from: stripNulls({\n            id: normalizeString(asRecord(question.from).id),\n            nickname: normalizeString(asRecord(question.from).nickname),\n          }),\n          answer_status: normalizeString(asRecord(question.answer).status),\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to search MercadoLibre questions\"));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uCAAuC;AAChD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,mCAAmC;AAC5C,SAAS,kBAAkB;AAC3B,SAAS,SAAS,UAAU,iBAAiB,uBAAuB;AACpE,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAE1C,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,WAAW;AAAA,EACX,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,uCAAuC;AAAA,EAC5F,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAAA,EACvF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,0BAA0B;AAAA,EACrF,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAI,EAAE,SAAS,EAAE,SAAS,oBAAoB;AACpF,CAAC;AAED,eAAsB,2BACpB,QACA;AACA,MAAI;AACF,UAAM,oBAAoB,MAAM,sCAAsC,OAAO,SAAS;AACtF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,UAAM,SAAS,MAAM,gCAAgC,SAAS;AAC9D,UAAM,WAAW,MAAM,4BAA4B,WAAW;AAAA,MAC5D,UAAU,OAAO;AAAA,MACjB,QAAQ,OAAO;AAAA,MACf,QAAQ,OAAO;AAAA,MACf,OAAO,OAAO,SAAS;AAAA,MACvB,QAAQ,OAAO,UAAU;AAAA,IAC3B,CAAC;AAED,UAAM,YAAY,QAAiC,SAAS,aAAa,SAAS,OAAO;AACzF,UAAM,SAAS,4BAA4B,SAAS,SAAS,MAAM,CAAC;AAEpE,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,UAAU,oCAAoC;AAAA,UAC5C,OAAO,OAAO,SAAS,UAAU;AAAA,UACjC,OAAO,OAAO,SAAS,OAAO,SAAS,UAAU;AAAA,UACjD,QAAQ,OAAO,UAAU,OAAO,UAAU;AAAA,UAC1C,UAAU,UAAU;AAAA,UACpB,WAAW;AAAA,QACb,CAAC;AAAA,QACD,WAAW,UAAU,IAAI,CAAC,cAAc;AAAA,UACtC,aAAa,SAAS;AAAA,UACtB,SAAS,gBAAgB,SAAS,OAAO;AAAA,UACzC,YAAY,gBAAgB,SAAS,SAAS,IAAI,EAAE,KAAK;AAAA,UACzD,QAAQ,gBAAgB,SAAS,MAAM;AAAA,UACvC,MAAM,gBAAgB,SAAS,IAAI;AAAA,UACnC,cAAc,gBAAgB,SAAS,YAAY;AAAA,UACnD,MAAM,WAAW;AAAA,YACf,IAAI,gBAAgB,SAAS,SAAS,IAAI,EAAE,EAAE;AAAA,YAC9C,UAAU,gBAAgB,SAAS,SAAS,IAAI,EAAE,QAAQ;AAAA,UAC5D,CAAC;AAAA,UACD,eAAe,gBAAgB,SAAS,SAAS,MAAM,EAAE,MAAM;AAAA,QACjE,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,yCAAyC,CAAC;AAAA,EACtF;AACF;",
+  "names": []
+}

package/dist/src/tools/mercadolibre/update-item-basic-fields.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import {
+  getMercadoLibreItem,
+  updateMercadoLibreItem
+} from "../../services/mercadolibre/mercadolibre-items.js";
+import {
+  buildMercadoLibreWriteSuccessResponse,
+  handleMercadoLibreWriteError,
+  mercadolibreProfileIdSchemaField,
+  resolveMercadoLibreWriteProfile
+} from "./write-helpers.js";
+const attributeSchema = z.object({
+  id: z.string().trim().min(1).describe("MercadoLibre attribute id."),
+  value_name: z.string().trim().min(1).optional().describe("Human-readable attribute value."),
+  value_id: z.string().trim().min(1).optional().describe("MercadoLibre attribute value id when known.")
+});
+const meliUpdateItemBasicFieldsSchema = z.object({
+  profileId: mercadolibreProfileIdSchemaField,
+  itemId: z.string().trim().min(1).describe("MercadoLibre item id."),
+  title: z.string().trim().min(3).optional().describe("New listing title."),
+  price: z.number().positive().optional().describe("New listing price."),
+  availableQuantity: z.number().int().min(0).optional().describe("New available quantity."),
+  attributes: z.array(attributeSchema).optional().describe("Updated attributes array."),
+  saleTerms: z.array(z.record(z.string(), z.unknown())).optional().describe("Updated sale terms array."),
+  shipping: z.record(z.string(), z.unknown()).optional().describe("Updated shipping payload."),
+  status: z.enum(["active", "paused", "closed", "under_review"]).optional().describe("New listing status."),
+  listingTypeId: z.string().trim().min(1).optional().describe("Optional new listing type id if supported by MercadoLibre for the item."),
+  channels: z.array(z.string().trim().min(1)).optional().describe("Optional replacement channels array if supported.")
+}).refine(
+  (value) => value.title !== void 0 || value.price !== void 0 || value.availableQuantity !== void 0 || value.attributes !== void 0 || value.saleTerms !== void 0 || value.shipping !== void 0 || value.status !== void 0 || value.listingTypeId !== void 0 || value.channels !== void 0,
+  {
+    message: "At least one item field must be provided.",
+    path: ["title"]
+  }
+);
+async function meliUpdateItemBasicFieldsHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    const before = await getMercadoLibreItem(profileId, params.itemId);
+    const after = await updateMercadoLibreItem(profileId, params.itemId, {
+      title: params.title,
+      price: params.price,
+      available_quantity: params.availableQuantity,
+      attributes: params.attributes,
+      sale_terms: params.saleTerms,
+      shipping: params.shipping,
+      status: params.status,
+      listing_type_id: params.listingTypeId,
+      channels: params.channels
+    });
+    return buildMercadoLibreWriteSuccessResponse({
+      profileId,
+      operation: "update_item_basic_fields",
+      resourceId: params.itemId,
+      message: "MercadoLibre item updated successfully.",
+      before,
+      after
+    });
+  } catch (err) {
+    return handleMercadoLibreWriteError(err, `Failed to update MercadoLibre item ${params.itemId}`);
+  }
+}
+export {
+  meliUpdateItemBasicFieldsHandler,
+  meliUpdateItemBasicFieldsSchema
+};
+//# sourceMappingURL=update-item-basic-fields.js.map

package/dist/src/tools/mercadolibre/update-item-basic-fields.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/update-item-basic-fields.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  getMercadoLibreItem,\n  updateMercadoLibreItem,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport {\n  buildMercadoLibreWriteSuccessResponse,\n  handleMercadoLibreWriteError,\n  mercadolibreProfileIdSchemaField,\n  resolveMercadoLibreWriteProfile,\n} from \"./write-helpers.js\";\n\nconst attributeSchema = z.object({\n  id: z.string().trim().min(1).describe(\"MercadoLibre attribute id.\"),\n  value_name: z.string().trim().min(1).optional().describe(\"Human-readable attribute value.\"),\n  value_id: z.string().trim().min(1).optional().describe(\"MercadoLibre attribute value id when known.\"),\n});\n\nexport const meliUpdateItemBasicFieldsSchema = z\n  .object({\n    profileId: mercadolibreProfileIdSchemaField,\n    itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\n    title: z.string().trim().min(3).optional().describe(\"New listing title.\"),\n    price: z.number().positive().optional().describe(\"New listing price.\"),\n    availableQuantity: z.number().int().min(0).optional().describe(\"New available quantity.\"),\n    attributes: z.array(attributeSchema).optional().describe(\"Updated attributes array.\"),\n    saleTerms: z.array(z.record(z.string(), z.unknown())).optional().describe(\"Updated sale terms array.\"),\n    shipping: z.record(z.string(), z.unknown()).optional().describe(\"Updated shipping payload.\"),\n    status: z.enum([\"active\", \"paused\", \"closed\", \"under_review\"]).optional().describe(\"New listing status.\"),\n    listingTypeId: z.string().trim().min(1).optional().describe(\"Optional new listing type id if supported by MercadoLibre for the item.\"),\n    channels: z.array(z.string().trim().min(1)).optional().describe(\"Optional replacement channels array if supported.\"),\n  })\n  .refine(\n    (value) =>\n      value.title !== undefined ||\n      value.price !== undefined ||\n      value.availableQuantity !== undefined ||\n      value.attributes !== undefined ||\n      value.saleTerms !== undefined ||\n      value.shipping !== undefined ||\n      value.status !== undefined ||\n      value.listingTypeId !== undefined ||\n      value.channels !== undefined,\n    {\n      message: \"At least one item field must be provided.\",\n      path: [\"title\"],\n    }\n  );\n\nexport async function meliUpdateItemBasicFieldsHandler(\n  params: z.infer<typeof meliUpdateItemBasicFieldsSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const before = await getMercadoLibreItem(profileId, params.itemId);\n    const after = await updateMercadoLibreItem(profileId, params.itemId, {\n      title: params.title,\n      price: params.price,\n      available_quantity: params.availableQuantity,\n      attributes: params.attributes,\n      sale_terms: params.saleTerms,\n      shipping: params.shipping,\n      status: params.status,\n      listing_type_id: params.listingTypeId,\n      channels: params.channels,\n    });\n\n    return buildMercadoLibreWriteSuccessResponse({\n      profileId,\n      operation: \"update_item_basic_fields\",\n      resourceId: params.itemId,\n      message: \"MercadoLibre item updated successfully.\",\n      before,\n      after,\n    });\n  } catch (err) {\n    return handleMercadoLibreWriteError(err, `Failed to update MercadoLibre item ${params.itemId}`);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/mercadolibre/update-item-description.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import {
+  createMercadoLibreItemDescription,
+  getMercadoLibreItemDescription,
+  replaceMercadoLibreItemDescription
+} from "../../services/mercadolibre/mercadolibre-items.js";
+import {
+  buildMercadoLibreWriteSuccessResponse,
+  handleMercadoLibreWriteError,
+  mercadolibreProfileIdSchemaField,
+  resolveMercadoLibreWriteProfile
+} from "./write-helpers.js";
+const meliUpdateItemDescriptionSchema = z.object({
+  profileId: mercadolibreProfileIdSchemaField,
+  itemId: z.string().trim().min(1).describe("MercadoLibre item id."),
+  plainText: z.string().trim().min(1).describe("Plain-text description to publish.")
+});
+async function meliUpdateItemDescriptionHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    let before = null;
+    let after;
+    try {
+      before = await getMercadoLibreItemDescription(profileId, params.itemId);
+      after = await replaceMercadoLibreItemDescription(profileId, params.itemId, params.plainText);
+    } catch {
+      after = await createMercadoLibreItemDescription(profileId, params.itemId, params.plainText);
+    }
+    return buildMercadoLibreWriteSuccessResponse({
+      profileId,
+      operation: "update_item_description",
+      resourceId: params.itemId,
+      message: "MercadoLibre item description updated successfully.",
+      before,
+      after
+    });
+  } catch (err) {
+    return handleMercadoLibreWriteError(err, `Failed to update description for ${params.itemId}`);
+  }
+}
+export {
+  meliUpdateItemDescriptionHandler,
+  meliUpdateItemDescriptionSchema
+};
+//# sourceMappingURL=update-item-description.js.map

package/dist/src/tools/mercadolibre/update-item-description.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/update-item-description.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  createMercadoLibreItemDescription,\n  getMercadoLibreItemDescription,\n  replaceMercadoLibreItemDescription,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport {\n  buildMercadoLibreWriteSuccessResponse,\n  handleMercadoLibreWriteError,\n  mercadolibreProfileIdSchemaField,\n  resolveMercadoLibreWriteProfile,\n} from \"./write-helpers.js\";\n\nexport const meliUpdateItemDescriptionSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\n  plainText: z.string().trim().min(1).describe(\"Plain-text description to publish.\"),\n});\n\nexport async function meliUpdateItemDescriptionHandler(\n  params: z.infer<typeof meliUpdateItemDescriptionSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    let before: Record<string, unknown> | null = null;\n    let after: Record<string, unknown>;\n\n    try {\n      before = await getMercadoLibreItemDescription(profileId, params.itemId);\n      after = await replaceMercadoLibreItemDescription(profileId, params.itemId, params.plainText);\n    } catch {\n      after = await createMercadoLibreItemDescription(profileId, params.itemId, params.plainText);\n    }\n\n    return buildMercadoLibreWriteSuccessResponse({\n      profileId,\n      operation: \"update_item_description\",\n      resourceId: params.itemId,\n      message: \"MercadoLibre item description updated successfully.\",\n      before,\n      after,\n    });\n  } catch (err) {\n    return handleMercadoLibreWriteError(err, `Failed to update description for ${params.itemId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,kCAAkC,EAAE,OAAO;AAAA,EACtD,WAAW;AAAA,EACX,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB;AAAA,EACjE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,oCAAoC;AACnF,CAAC;AAED,eAAsB,iCACpB,QACA;AACA,MAAI;AACF,UAAM,oBAAoB,MAAM,gCAAgC,OAAO,SAAS;AAChF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,QAAI,SAAyC;AAC7C,QAAI;AAEJ,QAAI;AACF,eAAS,MAAM,+BAA+B,WAAW,OAAO,MAAM;AACtE,cAAQ,MAAM,mCAAmC,WAAW,OAAO,QAAQ,OAAO,SAAS;AAAA,IAC7F,QAAQ;AACN,cAAQ,MAAM,kCAAkC,WAAW,OAAO,QAAQ,OAAO,SAAS;AAAA,IAC5F;AAEA,WAAO,sCAAsC;AAAA,MAC3C;AAAA,MACA,WAAW;AAAA,MACX,YAAY,OAAO;AAAA,MACnB,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,6BAA6B,KAAK,oCAAoC,OAAO,MAAM,EAAE;AAAA,EAC9F;AACF;",
+  "names": []
+}

package/dist/src/tools/mercadolibre/update-item-pictures.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import {
+  addMercadoLibreItemPicture,
+  getMercadoLibreItem,
+  updateMercadoLibreItem
+} from "../../services/mercadolibre/mercadolibre-items.js";
+import {
+  buildMercadoLibreWriteSuccessResponse,
+  handleMercadoLibreWriteError,
+  mercadolibreProfileIdSchemaField,
+  resolveMercadoLibreWriteProfile
+} from "./write-helpers.js";
+const meliUpdateItemPicturesSchema = z.object({
+  profileId: mercadolibreProfileIdSchemaField,
+  itemId: z.string().trim().min(1).describe("MercadoLibre item id."),
+  mode: z.enum(["add", "replace"]).describe("Whether to add new pictures or replace the full pictures array."),
+  pictures: z.array(z.object({ source: z.string().trim().url().describe("Public image URL.") })).min(1).max(12).describe("One or more public image URLs to attach.")
+});
+async function meliUpdateItemPicturesHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    const before = await getMercadoLibreItem(profileId, params.itemId);
+    let after;
+    if (params.mode === "replace") {
+      after = await updateMercadoLibreItem(profileId, params.itemId, {
+        pictures: params.pictures
+      });
+    } else {
+      for (const picture of params.pictures) {
+        await addMercadoLibreItemPicture(profileId, params.itemId, picture.source);
+      }
+      after = await getMercadoLibreItem(profileId, params.itemId);
+    }
+    return buildMercadoLibreWriteSuccessResponse({
+      profileId,
+      operation: "update_item_pictures",
+      resourceId: params.itemId,
+      message: `MercadoLibre item pictures ${params.mode === "replace" ? "replaced" : "updated"} successfully.`,
+      before,
+      after,
+      details: {
+        mode: params.mode,
+        pictures_count: params.pictures.length
+      }
+    });
+  } catch (err) {
+    return handleMercadoLibreWriteError(err, `Failed to update pictures for ${params.itemId}`);
+  }
+}
+export {
+  meliUpdateItemPicturesHandler,
+  meliUpdateItemPicturesSchema
+};
+//# sourceMappingURL=update-item-pictures.js.map

package/dist/src/tools/mercadolibre/update-item-pictures.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/update-item-pictures.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  addMercadoLibreItemPicture,\n  getMercadoLibreItem,\n  updateMercadoLibreItem,\n} from \"../../services/mercadolibre/mercadolibre-items.js\";\nimport {\n  buildMercadoLibreWriteSuccessResponse,\n  handleMercadoLibreWriteError,\n  mercadolibreProfileIdSchemaField,\n  resolveMercadoLibreWriteProfile,\n} from \"./write-helpers.js\";\n\nexport const meliUpdateItemPicturesSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n  itemId: z.string().trim().min(1).describe(\"MercadoLibre item id.\"),\n  mode: z.enum([\"add\", \"replace\"]).describe(\"Whether to add new pictures or replace the full pictures array.\"),\n  pictures: z\n    .array(z.object({ source: z.string().trim().url().describe(\"Public image URL.\") }))\n    .min(1)\n    .max(12)\n    .describe(\"One or more public image URLs to attach.\"),\n});\n\nexport async function meliUpdateItemPicturesHandler(\n  params: z.infer<typeof meliUpdateItemPicturesSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreWriteProfile(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const before = await getMercadoLibreItem(profileId, params.itemId);\n\n    let after: Record<string, unknown>;\n    if (params.mode === \"replace\") {\n      after = await updateMercadoLibreItem(profileId, params.itemId, {\n        pictures: params.pictures,\n      });\n    } else {\n      for (const picture of params.pictures) {\n        await addMercadoLibreItemPicture(profileId, params.itemId, picture.source);\n      }\n      after = await getMercadoLibreItem(profileId, params.itemId);\n    }\n\n    return buildMercadoLibreWriteSuccessResponse({\n      profileId,\n      operation: \"update_item_pictures\",\n      resourceId: params.itemId,\n      message: `MercadoLibre item pictures ${params.mode === \"replace\" ? \"replaced\" : \"updated\"} successfully.`,\n      before,\n      after,\n      details: {\n        mode: params.mode,\n        pictures_count: params.pictures.length,\n      },\n    });\n  } catch (err) {\n    return handleMercadoLibreWriteError(err, `Failed to update pictures for ${params.itemId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,+BAA+B,EAAE,OAAO;AAAA,EACnD,WAAW;AAAA,EACX,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB;AAAA,EACjE,MAAM,EAAE,KAAK,CAAC,OAAO,SAAS,CAAC,EAAE,SAAS,iEAAiE;AAAA,EAC3G,UAAU,EACP,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,mBAAmB,EAAE,CAAC,CAAC,EACjF,IAAI,CAAC,EACL,IAAI,EAAE,EACN,SAAS,0CAA0C;AACxD,CAAC;AAED,eAAsB,8BACpB,QACA;AACA,MAAI;AACF,UAAM,oBAAoB,MAAM,gCAAgC,OAAO,SAAS;AAChF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,UAAM,SAAS,MAAM,oBAAoB,WAAW,OAAO,MAAM;AAEjE,QAAI;AACJ,QAAI,OAAO,SAAS,WAAW;AAC7B,cAAQ,MAAM,uBAAuB,WAAW,OAAO,QAAQ;AAAA,QAC7D,UAAU,OAAO;AAAA,MACnB,CAAC;AAAA,IACH,OAAO;AACL,iBAAW,WAAW,OAAO,UAAU;AACrC,cAAM,2BAA2B,WAAW,OAAO,QAAQ,QAAQ,MAAM;AAAA,MAC3E;AACA,cAAQ,MAAM,oBAAoB,WAAW,OAAO,MAAM;AAAA,IAC5D;AAEA,WAAO,sCAAsC;AAAA,MAC3C;AAAA,MACA,WAAW;AAAA,MACX,YAAY,OAAO;AAAA,MACnB,SAAS,8BAA8B,OAAO,SAAS,YAAY,aAAa,SAAS;AAAA,MACzF;AAAA,MACA;AAAA,MACA,SAAS;AAAA,QACP,MAAM,OAAO;AAAA,QACb,gBAAgB,OAAO,SAAS;AAAA,MAClC;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,6BAA6B,KAAK,iCAAiC,OAAO,MAAM,EAAE;AAAA,EAC3F;AACF;",
+  "names": []
+}

package/dist/src/tools/mercadolibre/validate-connection.js

@@ -0,0 +1,44 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { getMercadoLibreConnectionRow } from "../../config/mercadolibre-profile-store.js";
+import { getMercadoLibreAccessForProfile } from "../../config/mercadolibre.js";
+import { getMercadoLibreUsersMe, formatMercadoLibreError } from "../../services/mercadolibre/mercadolibre-api.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
+import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
+const meliValidateConnectionSchema = z.object({
+  profileId: mercadolibreProfileIdSchemaField
+});
+async function meliValidateConnectionHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    const before = await getMercadoLibreConnectionRow(profileId);
+    const access = await getMercadoLibreAccessForProfile(profileId);
+    const account = await getMercadoLibreUsersMe(profileId);
+    const after = await getMercadoLibreConnectionRow(profileId);
+    const refreshed = before?.expiresAt?.toISOString() !== after?.expiresAt?.toISOString() || before?.encryptedAccessToken !== after?.encryptedAccessToken;
+    return object(
+      stripNulls({
+        profile_id: profileId,
+        validation_status: after?.status ?? "active",
+        refreshed,
+        seller_id: access.sellerId,
+        account_id: account.id,
+        nickname: account.nickname,
+        expires_at: access.expiresAt,
+        scopes: access.scopes
+      })
+    );
+  } catch (err) {
+    return error(formatMercadoLibreError(err, "Failed to validate MercadoLibre connection"));
+  }
+}
+export {
+  meliValidateConnectionHandler,
+  meliValidateConnectionSchema
+};
+//# sourceMappingURL=validate-connection.js.map

package/dist/src/tools/mercadolibre/validate-connection.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/validate-connection.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getMercadoLibreConnectionRow } from \"../../config/mercadolibre-profile-store.js\";\nimport { getMercadoLibreAccessForProfile } from \"../../config/mercadolibre.js\";\nimport { getMercadoLibreUsersMe, formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nexport const meliValidateConnectionSchema = z.object({\n  profileId: mercadolibreProfileIdSchemaField,\n});\n\nexport async function meliValidateConnectionHandler(\n  params: z.infer<typeof meliValidateConnectionSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n    const before = await getMercadoLibreConnectionRow(profileId);\n    const access = await getMercadoLibreAccessForProfile(profileId);\n    const account = await getMercadoLibreUsersMe(profileId);\n    const after = await getMercadoLibreConnectionRow(profileId);\n\n    const refreshed =\n      before?.expiresAt?.toISOString() !== after?.expiresAt?.toISOString() ||\n      before?.encryptedAccessToken !== after?.encryptedAccessToken;\n\n    return object(\n      stripNulls({\n        profile_id: profileId,\n        validation_status: after?.status ?? \"active\",\n        refreshed,\n        seller_id: access.sellerId,\n        account_id: account.id,\n        nickname: account.nickname,\n        expires_at: access.expiresAt,\n        scopes: access.scopes,\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to validate MercadoLibre connection\"));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,oCAAoC;AAC7C,SAAS,uCAAuC;AAChD,SAAS,wBAAwB,+BAA+B;AAChE,SAAS,kBAAkB;AAC3B,SAAS,6CAA6C;AACtD,SAAS,wCAAwC;AAE1C,MAAM,+BAA+B,EAAE,OAAO;AAAA,EACnD,WAAW;AACb,CAAC;AAED,eAAsB,8BACpB,QACA;AACA,MAAI;AACF,UAAM,oBAAoB,MAAM,sCAAsC,OAAO,SAAS;AACtF,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,YAAY,kBAAkB,MAAM;AAC1C,UAAM,SAAS,MAAM,6BAA6B,SAAS;AAC3D,UAAM,SAAS,MAAM,gCAAgC,SAAS;AAC9D,UAAM,UAAU,MAAM,uBAAuB,SAAS;AACtD,UAAM,QAAQ,MAAM,6BAA6B,SAAS;AAE1D,UAAM,YACJ,QAAQ,WAAW,YAAY,MAAM,OAAO,WAAW,YAAY,KACnE,QAAQ,yBAAyB,OAAO;AAE1C,WAAO;AAAA,MACL,WAAW;AAAA,QACT,YAAY;AAAA,QACZ,mBAAmB,OAAO,UAAU;AAAA,QACpC;AAAA,QACA,WAAW,OAAO;AAAA,QAClB,YAAY,QAAQ;AAAA,QACpB,UAAU,QAAQ;AAAA,QAClB,YAAY,OAAO;AAAA,QACnB,QAAQ,OAAO;AAAA,MACjB,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,wBAAwB,KAAK,4CAA4C,CAAC;AAAA,EACzF;AACF;",
+  "names": []
+}