Connect Walmart Marketplace to Gemini CLI via MCP

💡 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 + Gemini

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.

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.

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 Gemini

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 shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell) — anythingmcp should show as connected.
4. Start prompting — Gemini CLI can now call the Walmart Marketplace tools.

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."

FAQ

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.

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• Connector landing page
• Connect to Claude