{
  "markdown": "# @striderlabs/mcp-walmart\n\nMCP server connector for Walmart retail shopping — search products, manage cart, and track orders via browser automation.\n\n## For Agents\n\nThis connector enables autonomous shopping on behalf of your human. Agents can:\n\n- **Know what to buy:** Understand shopping lists, dietary preferences, budget constraints, and seasonal needs\n- **Search intelligently:** Find products with filters (price, ratings) and compare options\n- **Execute efficiently:** Build a cart, review totals, and hand off for final purchase confirmation\n- **Track orders:** Monitor delivery status and notify the user when items arrive\n\n**Example agent workflow:**\n> User: \"I need groceries for the week. My budget is $100, and I need vegetarian options.\"\n\nAgent executes:\n1. `set_address` → Get local store availability\n2. `search` → \"organic vegetables\", `max_price: 50`\n3. `search` → \"rice, pasta, beans\" with filters\n4. `get_product` → Check nutrition and price for each\n5. `add_to_cart` → Build optimized cart under $100\n6. `checkout` → Review total ($94.32) and return summary to user\n7. User approves → Agent completes purchase\n\nAll in one seamless agent turn.\n\n## Overview\n\nThis package provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that enables AI agents to interact with Walmart.com through Playwright browser automation with stealth features to avoid bot detection.\n\n## Installation\n\n```bash\nnpx @striderlabs/mcp-walmart\n```\n\nOr install globally:\n\n```bash\nnpm install -g @striderlabs/mcp-walmart\nmcp-walmart\n```\n\n## MCP Configuration\n\nAdd to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"walmart\": {\n      \"command\": \"npx\",\n      \"args\": [\"@striderlabs/mcp-walmart\"]\n    }\n  }\n}\n```\n\n## Tools\n\n### `status`\nCheck Walmart authentication status and session info.\n\n**No parameters required.**\n\n```json\n{}\n```\n\n---\n\n### `login`\nAuthenticate with your Walmart account using email and password via browser automation.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `email` | string | Yes | Walmart account email |\n| `password` | string | Yes | Walmart account password |\n| `headless` | boolean | No | Run browser headless (default: `true`). Set `false` to see the browser window. |\n\n---\n\n### `logout`\nClear Walmart session and stored cookies.\n\n**No parameters required.**\n\n---\n\n### `set_address`\nSet delivery or pickup address for Walmart. Affects product availability and pricing.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `zip_code` | string | No* | ZIP code (e.g., `\"90210\"`) |\n| `address` | string | No* | Full address (e.g., `\"123 Main St, Chicago, IL 60601\"`) |\n\n*At least one of `zip_code` or `address` is required.\n\n---\n\n### `search`\nSearch Walmart products by query with optional filters.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `query` | string | Yes | Search term |\n| `min_price` | number | No | Minimum price filter |\n| `max_price` | number | No | Maximum price filter |\n| `sort_by` | string | No | Sort order: `relevance`, `price_low`, `price_high`, `best_seller`, `rating_high` |\n| `limit` | number | No | Max results (default: `10`, max: `24`) |\n\n---\n\n### `get_product`\nGet detailed product information including price, description, and availability.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `url` | string | No* | Full Walmart product URL |\n| `item_id` | string | No* | Walmart product item ID |\n\n*At least one of `url` or `item_id` is required.\n\n---\n\n### `add_to_cart`\nAdd a product to the Walmart cart.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `url` | string | No* | Walmart product URL |\n| `item_id` | string | No* | Walmart product item ID |\n| `quantity` | number | No | Quantity to add (default: `1`) |\n\n*At least one of `url` or `item_id` is required.\n\n---\n\n### `view_cart`\nView current Walmart cart contents and totals.\n\n**No parameters required.**\n\n---\n\n### `update_cart`\nUpdate the quantity of an item in the Walmart cart.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `quantity` | number | Yes | New quantity (must be >= 1) |\n| `item_id` | string | No* | Walmart product item ID |\n| `product_name` | string | No* | Partial product name to match |\n\n*At least one of `item_id` or `product_name` is required.\n\n---\n\n### `remove_from_cart`\nRemove a specific item from the Walmart cart.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `item_id` | string | No* | Walmart product item ID |\n| `product_name` | string | No* | Partial product name to match |\n\n*At least one of `item_id` or `product_name` is required.\n\n---\n\n### `checkout`\nPreview checkout summary for the Walmart cart. Returns order details without placing the order.\n\n**No parameters required.**\n\n> 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.\n\n---\n\n### `get_orders`\nGet Walmart order history.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `limit` | number | No | Number of recent orders to return (default: `10`) |\n\n---\n\n## Session Persistence\n\nCookies 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.\n\n## Technical Details\n\n- **Transport**: stdio (standard MCP transport)\n- **Browser**: Chromium via Playwright with stealth patches\n- **Bot detection bypass**: Removes webdriver flag, spoofs plugins/languages, patches permissions API\n- **Session storage**: `~/.striderlabs/walmart/cookies.json` and `~/.striderlabs/walmart/auth.json`\n\n## Requirements\n\n- Node.js >= 18.0.0\n- Chromium (installed automatically with Playwright)\n\n## License\n\nMIT — [Strider Labs](https://striderlabs.ai)\n",
  "bytes": 6080,
  "sha": "296b8b7071fad1eace7989e31baf3a6d100d8bd6d6a03de43fa94e3be3d2b19e",
  "repo_slug": "markswendsen-code/mcp-walmart",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_markswendsen_code_walmart_c8482971/readme"
}