Walmart Marketplace MCP Server: Orders and Inventory

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Walmart Marketplace, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Walmart Marketplace

Walmart Marketplace API for US sellers: orders with acknowledge and ship with tracking, returns, items and catalog search, inventory, prices, bulk feeds, on-request reports, WFS inbound shipments and shipping settings. Client ID and secret.

Setup

Setting up takes about 5 minutes.

1. Sign in at https://developer.walmart.com with your Seller Center login (choose Marketplace seller).
2. Open My Account, then API Keys (key management), and create or copy the production client ID and client secret.
3. Paste the client ID into WALMART_CLIENT_ID and the client secret into WALMART_CLIENT_SECRET.

The connector exchanges them at POST /v3/token (HTTP Basic, client credentials) for an access token that lasts 15 minutes, reuses it until shortly before it expires and fetches a new one by itself. Every call carries WM_SEC.ACCESS_TOKEN, WM_SVC.NAME and a new WM_QOS.CORRELATION_ID. Use your own seller client credentials: Delegated Access keys for solution providers are being retired (new ones can no longer be created, existing ones stop working after 30 April 2027).

Where to start: walmart_marketplace_list_released_orders (orders waiting for you), then walmart_marketplace_get_order. walmart_marketplace_list_items lists your catalog and walmart_marketplace_get_inventory the stock of a SKU.

Orders: walmart_marketplace_list_orders (all statuses), walmart_marketplace_list_released_orders (lines in Created), walmart_marketplace_get_order. A line goes Created, Acknowledged, Shipped, Delivered, or Cancelled. Acknowledge new orders promptly with walmart_marketplace_acknowledge_order, then ship each line with walmart_marketplace_ship_order_line (carrier, method, tracking number, ship time in epoch milliseconds); shipping captures the customer payment. walmart_marketplace_cancel_order_line and walmart_marketplace_refund_order_lines are installed switched off: a cancellation hurts your seller metrics and a refund moves money. Order lists reach 180 days back, at most 10,000 orders, and default to the last 7 days.

Paging: orders and returns answer with meta.nextCursor, a ready query string that starts with ?. Pass it unchanged as next_cursor and leave the other filters out. Items use nextCursor (start with *, valid 2 minutes) or limit and offset.

Returns: walmart_marketplace_list_returns (statuses INITIATED, DELIVERED, COMPLETED). walmart_marketplace_refund_return is switched off because it refunds the customer.

Items and catalog: walmart_marketplace_list_items, walmart_marketplace_get_item, walmart_marketplace_count_items, walmart_marketplace_search_my_catalog (your catalog with filters such as UNPUBLISHED items) and walmart_marketplace_search_walmart_catalog (the public Walmart.com catalog by keyword, UPC or GTIN). walmart_marketplace_retire_item is switched off: retiring removes the listing.

Inventory and prices: walmart_marketplace_get_inventory, walmart_marketplace_get_inventory_by_ship_node, walmart_marketplace_update_inventory (absolute quantity, unit EACH), walmart_marketplace_get_wfs_inventory (stock held by WFS). walmart_marketplace_update_price sets the BASE price of one SKU in USD (100 calls per hour); walmart_marketplace_get_promotional_prices shows sale prices.

Feeds: bulk changes go through feeds. walmart_marketplace_submit_item_feed and walmart_marketplace_submit_price_feed are installed switched off, because one feed changes many live listings and bulk price feeds are limited per hour and per day (10 per hour, shared by all price and promotion feeds). Check results with walmart_marketplace_list_feeds and walmart_marketplace_get_feed_status (per-item errors with include_details).

Reports: walmart_marketplace_request_report, then walmart_marketplace_list_report_requests or walmart_marketplace_get_report_request until READY, then walmart_marketplace_get_report_download_url. Status and download calls are limited to 20 per hour each, so wait several minutes between checks. The link is a short-lived zipped CSV.

WFS: walmart_marketplace_list_inbound_shipments, walmart_marketplace_list_inbound_shipment_items, walmart_marketplace_create_inbound_shipment_label (receiving labels as PDF or ZPL, free).

Settings (read only): walmart_marketplace_list_ship_nodes (ship node ids), walmart_marketplace_list_carrier_methods, walmart_marketplace_list_shipping_templates, walmart_marketplace_get_lag_time (20 calls per hour).

Rate limits: each API has its own token bucket (all orders 5,000 per minute, released orders 60 per minute, ship, acknowledge and cancel 60 per minute, inventory 200 per minute, items 300 per minute). A 429 means the bucket is empty; the headers x-current-token-count and X-Next-Replenishment-Time say when to retry.

Formats: dates are ISO 8601 in UTC; order dates in answers are epoch milliseconds. Money is in USD. SKUs are your own seller SKUs; Walmart ids are purchaseOrderId (orders), returnOrderId (returns), wpid and itemId (catalog). Errors come back as errors.error[] with code, field and description; a 400 INVALID_REQUEST_HEADER usually means a token or header problem.

Prerequisites: WALMART_CLIENT_ID, WALMART_CLIENT_SECRET

Install the connector locally

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Open http://localhost:3000/connectors/store, pick Walmart Marketplace and paste in the env vars listed under Prerequisites.

Available tools

Example prompts

• "Which released Walmart orders still need to ship today?"
• "Show purchase order 1234567890123 with the customer's shipping address and lines."
• "Which SKUs have less than 5 units in stock across my ship nodes?"
• "Set the price of SKU WM-1001 to 24.99 USD."
• "Acknowledge all released orders from today and list the ones that are still missing tracking."

Next steps

• Connect to Claude
• Connect to ChatGPT