walmart

@striderlabs/mcp-walmart

MCP server connector for Walmart retail shopping — search products, manage cart, and track orders via browser automation.

For Agents

This connector enables autonomous shopping on behalf of your human. Agents can:

• Know what to buy: Understand shopping lists, dietary preferences, budget constraints, and seasonal needs
• Search intelligently: Find products with filters (price, ratings) and compare options
• Execute efficiently: Build a cart, review totals, and hand off for final purchase confirmation
• Track orders: Monitor delivery status and notify the user when items arrive

Example agent workflow:

User: "I need groceries for the week. My budget is $100, and I need vegetarian options."

Agent executes:

1. set_address → Get local store availability
2. search → "organic vegetables", max_price: 50
3. search → "rice, pasta, beans" with filters
4. get_product → Check nutrition and price for each
5. add_to_cart → Build optimized cart under $100
6. checkout → Review total ($94.32) and return summary to user
7. User approves → Agent completes purchase

All in one seamless agent turn.

Overview

This package provides a Model Context Protocol (MCP) server that enables AI agents to interact with Walmart.com through Playwright browser automation with stealth features to avoid bot detection.

Installation

npx @striderlabs/mcp-walmart

Or install globally:

npm install -g @striderlabs/mcp-walmart
mcp-walmart

MCP Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "walmart": {
      "command": "npx",
      "args": ["@striderlabs/mcp-walmart"]
    }
  }
}

Tools

status

Check Walmart authentication status and session info.

No parameters required.

{}

---

login

Authenticate with your Walmart account using email and password via browser automation.

Parameter	Type	Required	Description
email	string	Yes	Walmart account email
password	string	Yes	Walmart account password
headless	boolean	No	Run browser headless (default: true). Set false to see the browser window.

---

logout

Clear Walmart session and stored cookies.

No parameters required.

---

set_address

Set delivery or pickup address for Walmart. Affects product availability and pricing.

Parameter	Type	Required	Description
zip_code	string	No*	ZIP code (e.g., "90210")
address	string	No*	Full address (e.g., "123 Main St, Chicago, IL 60601")

*At least one of zip_code or address is required.

---

search

Search Walmart products by query with optional filters.

Parameter	Type	Required	Description
query	string	Yes	Search term
min_price	number	No	Minimum price filter
max_price	number	No	Maximum price filter
sort_by	string	No	Sort order: relevance, price_low, price_high, best_seller, rating_high
limit	number	No	Max results (default: 10, max: 24)

---

get_product

Get detailed product information including price, description, and availability.

Parameter	Type	Required	Description
url	string	No*	Full Walmart product URL
item_id	string	No*	Walmart product item ID

*At least one of url or item_id is required.

---

add_to_cart

Add a product to the Walmart cart.

Parameter	Type	Required	Description
url	string	No*	Walmart product URL
item_id	string	No*	Walmart product item ID
quantity	number	No	Quantity to add (default: 1)

*At least one of url or item_id is required.

---

view_cart

View current Walmart cart contents and totals.

No parameters required.

---

update_cart

Update the quantity of an item in the Walmart cart.

Parameter	Type	Required	Description
quantity	number	Yes	New quantity (must be >= 1)
item_id	string	No*	Walmart product item ID
product_name	string	No*	Partial product name to match

*At least one of item_id or product_name is required.

---

remove_from_cart

Remove a specific item from the Walmart cart.

Parameter	Type	Required	Description
item_id	string	No*	Walmart product item ID
product_name	string	No*	Partial product name to match

*At least one of item_id or product_name is required.

---

checkout

Preview checkout summary for the Walmart cart. Returns order details without placing the order.

No parameters required.

Note: This tool intentionally does not place the order. It returns the order summary (items, subtotal, tax, total) so you can review before proceeding manually.

---

get_orders

Get Walmart order history.

Parameter	Type	Required	Description
limit	number	No	Number of recent orders to return (default: 10)

---

Session Persistence

Cookies and auth info are stored in ~/.striderlabs/walmart/ and persist across sessions. Once logged in, subsequent tool calls reuse the existing session without re-authenticating.

Technical Details

• Transport: stdio (standard MCP transport)
• Browser: Chromium via Playwright with stealth patches
• Bot detection bypass: Removes webdriver flag, spoofs plugins/languages, patches permissions API
• Session storage: ~/.striderlabs/walmart/cookies.json and ~/.striderlabs/walmart/auth.json

Requirements

• Node.js >= 18.0.0
• Chromium (installed automatically with Playwright)

License

MIT — Strider Labs