@lehaotech/walmart-mcp 0.5.4

package/build/tools/definitions/settings.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+// Walmart shipping-settings payload structure (per Walmart docs):
+//   { shippingTemplates: [{ templateName, methods: [...] }] }
+// Method enum / region structure varies — we gate the envelope.
+const ShippingTemplateSchema = z
+    .object({
+    templateName: z.string().min(1).max(100),
+    isDefault: z.boolean().optional(),
+    methods: z
+        .array(z
+        .object({
+        methodCode: z.enum(['Standard', 'Expedited', 'OneDay', 'TwoDay', 'Freight', 'Value']),
+        transitTime: z.number().int().min(0).max(99).optional(),
+        isActive: z.boolean().default(true),
+    })
+        .passthrough())
+        .min(1, 'Each shipping template must have at least 1 method'),
+})
+    .passthrough();
+const ShippingSettingsBodySchema = z
+    .object({
+    shippingTemplates: z
+        .array(ShippingTemplateSchema)
+        .min(1, 'Need at least 1 shipping template'),
+})
+    .strict();
+export const settingsTools = [
+    {
+        name: 'walmart_get_shipping_settings',
+        description: 'Get current shipping configuration including shipping methods, transit times, and regions.',
+        inputSchema: {},
+    },
+    {
+        name: 'walmart_update_shipping_settings',
+        description: 'Update shipping configuration. Body: { shippingTemplates: [{ templateName, methods: ' +
+            '[{ methodCode, transitTime?, isActive? }] }] }. methodCode must be one of Standard, ' +
+            'Expedited, OneDay, TwoDay, Freight, Value.',
+        inputSchema: {
+            settingsData: ShippingSettingsBodySchema,
+        },
+    },
+    {
+        name: 'walmart_get_fulfillment_centers',
+        description: 'Get list of configured fulfillment centers (ship nodes) with addresses and capabilities.',
+        inputSchema: {},
+    },
+    {
+        name: 'walmart_get_partner_info',
+        description: 'Get Walmart partner account information including seller ID, status, and onboarding state.',
+        inputSchema: {},
+    },
+];

package/build/tools/definitions/shared-schemas.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared zod atom schemas used across multiple write tools.
+ *
+ * Keep this file conservative — only schemas that genuinely repeat across
+ * 2+ tools belong here. If a schema is unique to one tool's feed body,
+ * keep it inline in that tool's definition file.
+ */
+import { z } from 'zod';
+/** Seller-defined SKU. Walmart allows up to 50 chars from a limited charset. */
+export declare const SkuSchema: z.ZodString;
+/** GTIN / UPC / EAN — Walmart accepts 8 / 12 / 13 / 14 digit numeric strings. */
+export declare const GtinSchema: z.ZodString;
+/** Walmart ship node ID. Numeric string in practice but kept as string for safety. */
+export declare const ShipNodeSchema: z.ZodString;
+export declare const Iso4217CurrencySchema: z.ZodEnum<["USD", "MXN", "CAD", "CLP"]>;
+export declare const MoneySchema: z.ZodObject<{
+    currency: z.ZodEnum<["USD", "MXN", "CAD", "CLP"]>;
+    amount: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    currency: "USD" | "MXN" | "CAD" | "CLP";
+    amount: number;
+}, {
+    currency: "USD" | "MXN" | "CAD" | "CLP";
+    amount: number;
+}>;
+export declare const Iso8601UtcSchema: z.ZodString;
+/** Walmart inventory unit. EACH is overwhelmingly the common value. */
+export declare const QuantityUnitSchema: z.ZodEnum<["EACH", "CASE"]>;
+export declare const QuantitySchema: z.ZodObject<{
+    unit: z.ZodDefault<z.ZodEnum<["EACH", "CASE"]>>;
+    amount: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    amount: number;
+    unit: "EACH" | "CASE";
+}, {
+    amount: number;
+    unit?: "EACH" | "CASE" | undefined;
+}>;
+/** Most feed entries support an UPSERT/DELETE process mode. */
+export declare const ProcessModeSchema: z.ZodDefault<z.ZodEnum<["UPSERT", "DELETE"]>>;

package/build/tools/definitions/shared-schemas.js

@@ -0,0 +1,47 @@
+/**
+ * Shared zod atom schemas used across multiple write tools.
+ *
+ * Keep this file conservative — only schemas that genuinely repeat across
+ * 2+ tools belong here. If a schema is unique to one tool's feed body,
+ * keep it inline in that tool's definition file.
+ */
+import { z } from 'zod';
+// ---------- Identifier atoms ----------
+/** Seller-defined SKU. Walmart allows up to 50 chars from a limited charset. */
+export const SkuSchema = z
+    .string()
+    .min(1, 'SKU cannot be empty')
+    .max(50, 'SKU max 50 chars')
+    .regex(/^[A-Za-z0-9._\-:/+]+$/, 'SKU may only contain letters, digits, and . _ - : / +');
+/** GTIN / UPC / EAN — Walmart accepts 8 / 12 / 13 / 14 digit numeric strings. */
+export const GtinSchema = z
+    .string()
+    .regex(/^[0-9]{8,14}$/, 'GTIN must be 8-14 digit numeric');
+/** Walmart ship node ID. Numeric string in practice but kept as string for safety. */
+export const ShipNodeSchema = z.string().min(1).max(50);
+// ---------- Money / time atoms ----------
+export const Iso4217CurrencySchema = z
+    .enum(['USD', 'MXN', 'CAD', 'CLP'])
+    .describe('ISO 4217 currency. us->USD, mx->MXN, ca->CAD, cl->CLP.');
+export const MoneySchema = z
+    .object({
+    currency: Iso4217CurrencySchema,
+    amount: z.number().positive('Money amount must be positive'),
+})
+    .strict();
+export const Iso8601UtcSchema = z
+    .string()
+    .datetime({ offset: true })
+    .describe('ISO 8601 UTC datetime, e.g. 2026-06-01T00:00:00Z');
+// ---------- Inventory / quantity atoms ----------
+/** Walmart inventory unit. EACH is overwhelmingly the common value. */
+export const QuantityUnitSchema = z.enum(['EACH', 'CASE']);
+export const QuantitySchema = z
+    .object({
+    unit: QuantityUnitSchema.default('EACH'),
+    amount: z.number().int('Quantity amount must be integer').min(0, 'Quantity cannot be negative'),
+})
+    .strict();
+// ---------- Feed-control atoms ----------
+/** Most feed entries support an UPSERT/DELETE process mode. */
+export const ProcessModeSchema = z.enum(['UPSERT', 'DELETE']).default('UPSERT');

package/build/tools/definitions/token-management.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export declare const tokenManagementTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        clientId?: undefined;
+        clientSecret?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+    };
+})[];

package/build/tools/definitions/token-management.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export const tokenManagementTools = [
+    {
+        name: 'walmart_get_token',
+        description: 'Request a new access token from Walmart API. Tokens expire in 15 minutes. This tool automatically caches the token.',
+        inputSchema: {},
+    },
+    {
+        name: 'walmart_get_token_status',
+        description: 'Check the current token validity, scopes, and expiration time. Returns detailed token information from Walmart API.',
+        inputSchema: {},
+    },
+    {
+        name: 'walmart_get_token_info',
+        description: 'Get local token cache info including expiry time and environment. Does not call the Walmart API.',
+        inputSchema: {},
+    },
+    {
+        name: 'walmart_set_credentials',
+        description: 'Set Walmart API credentials (Client ID and Client Secret). Saves to .env file for persistence.',
+        inputSchema: {
+            clientId: z.string().describe('Walmart API Client ID'),
+            clientSecret: z.string().describe('Walmart API Client Secret'),
+        },
+    },
+    {
+        name: 'walmart_display_credentials',
+        description: 'Display current Walmart API credentials (Client ID shown in full, Client Secret masked). Shows environment and market configuration.',
+        inputSchema: {},
+    },
+    {
+        name: 'walmart_setup_guide',
+        description: 'Get step-by-step setup instructions and a checklist for configuring this MCP server. Reports what is already configured (environment, market, whether marketplace and advertising credentials are set) and what is still needed. Call this first when getting started or when calls fail due to missing credentials.',
+        inputSchema: {},
+    },
+    {
+        name: 'walmart_get_rate_budget',
+        description: 'Get current rate-limit budget for the Walmart Marketplace client. Returns the local sliding-window state (requests issued by this MCP in the last 60s) plus the latest Walmart-server-reported token bucket (x-current-token-count + x-next-replenish-time from the most recent response). Call this before bulk operations to see how much headroom you have. Note: Walmart Marketplace uses client_credentials + per-endpoint token buckets; there is no OAuth user-token flow to unlock higher rate limits, only the seller-account tier set by Walmart.',
+        inputSchema: {},
+    },
+];