walmart

walmart-mcp exposes a MCP server that lets AI agents like Claude Desktop or Gemini CLI interact with Walmart data through the Model Context Protocol. The server exposes capabilities such as real-time product search, item lookups, stock information, customer reviews, store locations, bestsellers, and smart recommendations. After starting the server, you can direct your MCP-enabled agent to query these capabilities using the standard MCP request format. Typical workflows include searching for products by keyword or category, retrieving detailed item information, checking current stock levels at nearby stores, pulling reviews for a product, locating the nearest Walmart stores, and getting personalized product recommendations based on user preferences. The platform is designed for shopping assistants, e-commerce automation, and retail market analysis, enabling richer, context-aware interactions within your AI agent pipelines.

Prerequisites:

• Node.js 14.x or newer installed on your system
• Access to the walmart-mcp release zip (from the Releases page)

Installation steps:

1. Download the latest walmart-mcp release zip from the project Releases page.
2. Unzip the archive to a working directory, e.g. ~/walmart-mcp
3. Open a terminal and navigate to the project folder: cd ~/walmart-mcp
4. Install dependencies (if a package.json is present): npm install
5. Start the server (choose one of the following commands):
   • If the project defines a start script: npm run start
   • If you rely on a direct entry point like server.js: node server.js
6. Verify the server starts successfully and listens on the expected port (often 3000 or 8000, as configured by the project).

Note: If the release provides additional setup instructions in a user manual or README inside the archive, follow those steps precisely. You may also need to configure environment variables (see additional_notes) before starting the server.

Tips and common considerations:

• If starting via npm start, ensure package.json includes a start script and that all dependencies install without errors.
• The release zip link is the primary source for binaries; avoid using untrusted mirrors.
• Check for environment-specific configuration in the walmart-mcp repository's user manual, especially for API keys or access tokens required to query Walmart data.
• If you encounter connectivity or startup issues, verify Node.js version compatibility and ensure no port conflicts with other services.
• The mcp_config uses a single walmart server in this example; you can add more entries if you host multiple MCP endpoints in your environment.
• For up-to-date usage examples and endpoints, refer to the included user guide within the release package or the project repository.