@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 full README on GitHub