Walmart MCP

Connect AI Agents to the Walmart Ecosystem with Model Context Protocol (MCP)

Unleash the power of real-time Walmart data in your LLM applications. The Walmart MCP Server bridges the Walmart Affiliate API, other related APIs, and AI agents like Claude, enabling seamless product search, detailed lookup, review analysis, and store location services directly within your chat interface.

Perfect for building shopping assistants, market analysis bots, and e-commerce automations.

💎 Premium Access

This project operates on a Sponsorware model. To ensure dedicated maintenance, rapid API updates, and priority support, the source code and latest builds are exclusively available to supporters.

| Monthly Subscription ($9) | Lifetime Access ($59) | | :--- | :--- | | • Perfect for ongoing projects | • Pay once, use forever | | • Cancel anytime | • Best value for agencies |

Instant Access: Licenses are delivered immediately via Polar.sh. Setup takes < 2 minutes.

Get Access Now →

⚙️ Configuration

Accessing the Walmart Affiliate API requires authentication. Set these environment variables in your client configuration:

Note: The Walmart Affiliate API credentials are optional. If not provided, the built-in credentials will be used.

1. Generate your keys with the Walmart Key Tutorial.
2. Create your app at the Walmart IO Dashboard.

| Variable | Description | Required | |----------|-------------|:--------:| | WALMART_MCP_LICENSE_KEY | Polar.sh License Key (for Premium Access) | Yes | | WALMART_CONSUMER_ID | Your Walmart Affiliate Consumer ID (UUID) | No | | WALMART_PRIVATE_KEY | Path to your PEM Private Key file (or key content) | No | | WALMART_KEY_VERSION | Private Key Version (e.g., 1 or 2) | No | | WALMART_PUBLISHER_ID | Your Publisher ID for tracking (Impact Radius ID) | No |

🚀 Quick Start

Add this server to your Claude Desktop, Gemini CLI or any other MCP client configuration (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "Walmart": {
      "command": "npx",
      "args": [
        "-y",
        "walmart-mcp@latest"
      ],
      "env": {
        "WALMART_CONSUMER_ID": "<YOUR_CONSUMER_ID>",
        "WALMART_PRIVATE_KEY": "<PATH_TO_PRIVATE_KEY_OR_CONTENT>",
        "WALMART_KEY_VERSION": "<KEY_VERSION_E_G_1>",
        "WALMART_PUBLISHER_ID": "<OPTIONAL_PUBLISHER_ID>",
        "WALMART_MCP_LICENSE_KEY": "<YOUR_LICENSE_KEY>" // Required
      }
    }
  }
}

✨ Key Features

This server exposes a powerful suite of tools designed for AI interactions:

• 🔍 Advanced Product Search: Find products with precision using keywords, price ranges, brands, and category filters.
• 📦 Deep Product Intelligence: Retrieve comprehensive item details, including specifications, high-res images, and stock status.
• ⭐ Sentiment Analysis Ready: Fetch customer reviews to analyze product sentiment and user feedback.
• 📍 Geolocation & Stores: Locate nearby Walmart stores using coordinate-based search (perfect for location-aware bots).
• 📈 Trends & Bestsellers: Access real-time data on trending items, clearance deals, and special buys.
• 📂 Taxonomy Exploration: Navigate the full Walmart category hierarchy for structured data discovery.
• 💡 Smart Recommendations: Get cross-sell and up-sell product suggestions.
• ✨ Formatted Response: LLM-optimized, human-readable formatted responses for easy integration.

🛠️ Usage Guide

Stdio Mode (Default)

Ideal for local integration with Claude Desktop or other MCP-compliant hosts. The server communicates via standard input/output.

HTTP / SSE Mode (Remote)

Run the server as a remote service accessible over Streamable HTTP with Server-Sent Events (SSE).

npx walmart-mcp@latest --sse --port 3000

• Endpoint: http://localhost:3000/mcp
• POST: JSON-RPC 2.0 requests
• GET: SSE stream for server events

🧰 Available Tools

| Tool | Action | Use Case | |------|--------|----------| | walmart_search | Search Catalog | "Find me a gaming laptop under $1000" | | walmart_product_lookup | Get Item Details | "What are the specs for this TV?" | | walmart_reviews | Get Reviews | "Summarize the complaints about this blender" | | walmart_stores | Find Stores | "Where is the nearest Walmart to these coordinates?" | | walmart_feeds | Get Trends | "Show me the current bestsellers in Electronics" | | walmart_taxonomy | Browse Categories | "List all subcategories for 'Home & Garden'" | | walmart_recommendations| Get Similar Items | "Suggest accessories for this camera" |