io.github.markswendsen-code/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.

logout

Clear Walmart session and stored cookies.

No parameters required.

set_address

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

*At least one of zip_code or address is required.

search

Search Walmart products by query with optional filters.

get_product

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

*At least one of url or item_id is required.

add_to_cart

Add a product to the Walmart cart.

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

*At least one of item_id or product_name is required.

remove_from_cart

Remove a specific item from the Walmart cart.

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

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