Walmart MCP server

@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. addtocart → 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 zipcode 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 itemid is required.

addtocart

Add a product to the Walmart cart.

At least one of url or itemid is required.

Shortened. The full README is on GitHub.