Summary
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.
Guided setup
Connect Walmart Marketplace to Claude in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Walmart Marketplace in the guided setup, then add your MCP URL to Claude. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.
Try asking
Example prompts for Walmart Marketplace
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 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 + Claude
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.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
WALMART_CLIENT_ID, WALMART_CLIENT_SECRET
Step 1 — Get credentials
Setting up takes about 5 minutes.
- Sign in at https://developer.walmart.com with your Seller Center login (choose Marketplace seller).
- Open My Account, then API Keys (key management), and create or copy the production client ID and client secret.
- Paste the client ID into
WALMART_CLIENT_IDand the client secret intoWALMART_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.
Step 2 — Install the adapter
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
Step 3 — Add the connector in Claude
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Recommended path: works on claude.ai web without editing any config file.
- In Claude, open Customize → Connectors.
- Click +, then Add custom connector.
- Enter a name, e.g.
Walmart Marketplace, and the remote MCP server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Add. - Click Connect and sign in to AnythingMCP (OAuth) to allow access.
All tools below appear in your chat: start typing prompts.
Available tools
| Tool | What it does |
|---|---|
walmart_marketplace_list_orders | List purchase orders, newest first: list.meta (totalCount, limit, nextCursor) and list.elements.order[] with purchaseOrderId… |
walmart_marketplace_list_released_orders | List released orders: purchase orders with lines still in Created status, ready for you to acknowledge and ship. Same fields as… |
walmart_marketplace_get_order | Read one purchase order: purchaseOrderId, customerOrderId, customerEmailId (relay address), orderDate, shippingInfo (phone… |
walmart_marketplace_acknowledge_order | Acknowledge a whole purchase order (every line moves from Created to Acknowledged), confirming you will fulfil it. Walmart expects this… |
walmart_marketplace_ship_order_line | Mark one order line as shipped with carrier and tracking number. Walmart then captures the customer payment, so ship only what has really… |
walmart_marketplace_cancel_order_line | Cancel units of one order line you cannot ship, with a reason. It cannot be undone and counts against your cancellation rate; use… |
walmart_marketplace_refund_order_lines | Refund shipped order lines (full or partial) to the customer. This moves money back to the customer and cannot be undone. Lines use… |
walmart_marketplace_list_returns | List return orders (RMAs), newest first: meta (totalCount, limit, nextCursor) and returnOrders[] with returnOrderId, customerOrderId… |
walmart_marketplace_refund_return | Issue the refund for lines of a return order (RMA). This moves money back to the customer and cannot be undone. Returns the refund result… |
walmart_marketplace_list_items | List the items in your Walmart catalog: ItemResponse[] with sku, wpid, upc, gtin, productName, productType, shelf, price (amount… |
walmart_marketplace_get_item | Read one item of your catalog by SKU (default) or by another identifier: sku, wpid, upc, gtin, productName, shelf, productType, price… |
walmart_marketplace_search_my_catalog | Search your own seller catalog with a query, filters and sort: items[] with sku, itemId, productName, brand, price, publishedStatus… |
walmart_marketplace_search_walmart_catalog | Search the public Walmart.com catalog (all sellers) by keyword or by UPC, GTIN, EAN or ISBN, to see whether a product already exists before… |
walmart_marketplace_count_items | Count the items of your catalog in one status (PUBLISHED, UNPUBLISHED, SYSTEM_PROBLEM, IN_PROGRESS or ALL). Read-only, cheap overview… |
walmart_marketplace_retire_item | Retire (permanently remove) one item from Walmart.com by SKU. The listing is taken down; bringing it back needs a new item setup. Returns… |
walmart_marketplace_get_inventory | Read the stock of one SKU at your default ship node, or at the ship node given: sku, quantity (unit EACH, amount = units available to sell)… |
walmart_marketplace_get_inventory_by_ship_node | Read the stock of one SKU at every ship node of your account (or one node): sku and nodes[] with shipNode, inputQty (what you set)… |
walmart_marketplace_update_inventory | Set the stock of one SKU to an absolute quantity at your default ship node (or the ship node given). The amount replaces the current value… |
walmart_marketplace_get_wfs_inventory | Read Walmart Fulfillment Services (WFS) stock: headers (totalCount, limit, offset) and payload.inventory[] with itemInformation (sku, gtin… |
walmart_marketplace_update_price | Set the regular (BASE) selling price of one SKU in USD. Returns an ItemPriceResponse with the sku and a message. Limited to 100 calls per… |
walmart_marketplace_get_promotional_prices | Read the promotional prices of one SKU: payload.itemIdentifier and pricingList.pricing[] with currentPriceType (BASE, REDUCED, CLEARANCE… |
walmart_marketplace_submit_item_feed | Submit a bulk item feed (create or update up to 10,000 items) as a JSON document in Walmart's item spec, e.g. MP_ITEM with… |
walmart_marketplace_submit_price_feed | Submit a bulk price feed (feedType PRICE_AND_PROMOTION, up to 10,000 SKUs, 1,000 recommended)… |
walmart_marketplace_list_feeds | List your recent feeds (or one feed): totalResults and results.feed[] with feedId, feedType, feedSource, feedStatus (RECEIVED, INPROGRESS… |
walmart_marketplace_get_feed_status | Read the status of one feed: feedStatus, itemsReceived, itemsSucceeded, itemsFailed, itemsProcessing and, with include_details… |
walmart_marketplace_request_report | Ask Walmart to generate an on-request report (ITEM catalog, INVENTORY, BUYBOX, CANCELLATION, RETURN_OVERRIDES, ITEM_PERFORMANCE, WFS… |
walmart_marketplace_list_report_requests | List report requests of one type from the last 30 days: requests[] with requestId, requestStatus (RECEIVED, INPROGRESS, READY, ERROR)… |
walmart_marketplace_get_report_request | Read the status of one report request: requestId, requestStatus (RECEIVED, INPROGRESS, READY, ERROR), reportType, reportVersion… |
walmart_marketplace_get_report_download_url | Get the download link of a READY report: downloadURL (pre-signed, a zipped CSV), downloadURLExpirationTime, reportType and… |
walmart_marketplace_list_inbound_shipments | List WFS inbound shipments (your stock on its way to Walmart fulfillment centers): headers.totalCount and payload[] with inboundOrderId… |
walmart_marketplace_list_inbound_shipment_items | List the SKUs of WFS inbound shipments: headers.totalCount and payload[] with inboundOrderId, shipmentId, sku, gtin, itemDesc, itemQty… |
walmart_marketplace_create_inbound_shipment_label | Generate the WFS receiving labels for an inbound shipment (not a carrier label: these let the fulfillment center match boxes or pallets to… |
walmart_marketplace_list_ship_nodes | List your fulfillment centers (ship nodes): shipNode (the id other tools take), shipNodeName, nodeType, status, timeZone, postalAddress… |
walmart_marketplace_list_carrier_methods | List the carrier methods available for your shipping configuration: carrierMethodId, carrierMethodName, carrierMethodType and… |
walmart_marketplace_list_shipping_templates | List your shipping templates: totalRecords and shippingTemplates[] with id, name, type (DEFAULT, CUSTOM, DELIVERR), status (ACTIVE… |
walmart_marketplace_get_lag_time | Read the fulfillment lag time of one SKU: sku and fulfillmentLagTime (days between order and shipment; 2 days or more needs Walmart… |
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."
FAQ
Does it work with Claude Code as well as Claude Desktop? Yes, point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Which Walmart marketplaces does it cover? The US Walmart Marketplace (marketplace.walmartapis.com). Walmart Canada, Mexico and Chile have separate APIs and are not covered.
Do I need a solution provider app or Delegated Access? No. You create your own client ID and secret in the Walmart Developer Portal with your seller login. Walmart no longer issues new Delegated Access keys.
Can it cancel orders or issue refunds? The tools exist but install switched off: walmart_marketplace_cancel_order_line, walmart_marketplace_refund_order_lines and walmart_marketplace_refund_return. Switch them on on the connector page only if the AI should use them; it asks you to confirm every change.
Next steps
- Connector landing page
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
- Connect to Microsoft Copilot
Was this guide helpful?