Walmart

io.github.markswendsen-codePublished by GitHub account markswendsen-codev0.1.1Updated Oct 24, 2026

MCP server for Walmart - search products, manage cart, track orders

VerifiedSTDIODesktop onlyBrowser AutomationBusiness & Commerce

Overview

AI-generated overview

Local MCP server that drives Walmart.com through a browser so an assistant can search products, manage a cart, and review orders.

What you can do
  • Search and inspect products: search with price, sort and result-limit filters, and fetch product details by URL or item ID
  • Set the delivery or pickup address that determines availability and pricing
  • Manage the cart: add items, view contents and totals, change quantities, remove items
  • Review checkout: get an order summary with subtotal, tax and total without placing the order
  • Track orders: list recent order history
  • Manage the account session: check login status, log in with email and password, log out and clear stored cookies
When to use it
Useful when you want an assistant to help with Walmart grocery or household shopping: building a cart against a budget or dietary preference, comparing products, and summarizing totals or order status for you to confirm.
Requirements
Runs locally via npx or a global npm install; needs Node.js 18 or newer and Chromium, which Playwright installs. A Walmart account email and password are passed to the login tool. Session cookies and auth data are kept in a local directory under the user's home folder.
Before you install
The login tool takes the Walmart account email and password as tool arguments, and the session is persisted to local files, so treat those files as secrets. Cart changes write to the real account. The server uses stealth patches intended to avoid bot detection, which may conflict with Walmart's terms of service. Checkout only previews the order; the purchase is completed manually.

Installation

In SourceWeft

  1. Open Walmart in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@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

bash
npx @striderlabs/mcp-walmart

Or install globally:

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

MCP Configuration

Add to your MCP client configuration:

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

Tools

status

Check Walmart authentication status and session info.

No parameters required.

json
{}

login

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

ParameterTypeRequiredDescription
emailstringYesWalmart account email
passwordstringYesWalmart account password
headlessbooleanNoRun 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.

ParameterTypeRequiredDescription
zip_codestringNo*ZIP code (e.g., "90210")
addressstringNo*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.

ParameterTypeRequiredDescription
querystringYesSearch term
min_pricenumberNoMinimum price filter
max_pricenumberNoMaximum price filter
sort_bystringNoSort order: relevance, price_low, price_high, best_seller, rating_high
limitnumberNoMax results (default: 10, max: 24)

get_product

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

ParameterTypeRequiredDescription
urlstringNo*Full Walmart product URL
item_idstringNo*Walmart product item ID

*At least one of url or item_id is required.

add_to_cart

Add a product to the Walmart cart.

ParameterTypeRequiredDescription
urlstringNo*Walmart product URL
item_idstringNo*Walmart product item ID
quantitynumberNoQuantity 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.

ParameterTypeRequiredDescription
quantitynumberYesNew quantity (must be >= 1)
item_idstringNo*Walmart product item ID
product_namestringNo*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.

ParameterTypeRequiredDescription
item_idstringNo*Walmart product item ID
product_namestringNo*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.

ParameterTypeRequiredDescription
limitnumberNoNumber 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

Source: README.md at commit d8e1deb

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.