# Walmart Marketplace MCP

> Walmart Marketplace MCP manages your entire third-party selling operation. Use it to control catalog items, synchronize live inventory across fulfillment centers, and execute dynamic pricing updates directly through AI agents. It lets you automate bulk price changes, set promotions, and keep your listings accurate without leaving your workflow.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** marketplace-management, dynamic-pricing, catalog-management, inventory-sync, seller-tools, product-listings

## Description

Managing a large e-commerce catalog is messy work. You need visibility into stock levels, current prices, and item status—all in one place. This MCP gives your agent full control over your Walmart 3P Seller operations using secure API calls. Instead of jumping between seller portals to manually adjust pricing or publish new items, you simply tell your AI client what needs doing. It handles the complexity behind the scenes.

For instance, if you run a seasonal sale, you can use the agent to both set up markdown promotions and update inventory levels simultaneously. The whole system lives on Vinkius, making it one of the most powerful e-commerce connectors available in the catalog. You manage your entire product life cycle—from listing items to retiring them—with direct data access.

## Tools

### wm_bulk_price_update
Updates prices for many items simultaneously using a structured payload feed.

### wm_get_item_status
Checks the current publishing status, buy-box limits, and any specific errors associated with an SKU.

### wm_get_taxonomy
Retrieves the correct structural category classification nodes needed for product listing data.

### wm_list_items
Extracts a clean list of all actively published third-party seller catalog items.

### wm_retire_item
Securely removes an item from the public marketplace view, masking it completely from customers.

### wm_set_price
Sets a specific retail price for one or more items according to defined market limits.

### wm_setup_promotions
Applies clearance, markdown, and promotional rules by submitting structured sale payloads.

### wm_update_inventory
Changes the physical stock count for an item at a specific fulfillment location.

## Prompt Examples

**Prompt:** 
```
Update the inventory of SKU 8291 to 50 items on fulfillment center 1000.
```

**Response:** 
```
Successfully updated the inventory quantity using `wm_update_inventory`.
```

**Prompt:** 
```
Find the current offer price and publish status of SKU 'LAPTOP-01'.
```

**Response:** 
```
SKU 'LAPTOP-01' is 'PUBLISHED' with a current active offer price of $499.00 on the marketplace.
```

**Prompt:** 
```
Increase the base price of all ASICS sneakers by 5% effectively immediately.
```

**Response:** 
```
Bulk price adjustment initiated. 34 ASICS SKUs have been updated with a 5% markup submitted successfully.
```

## Capabilities

### Manage Stock Levels
Automates physical stock allocation across all your fulfillment centers.

### Bulk Pricing Operations
Applies massive price changes, markups, and cost adjustments across many SKUs at once.

### Catalog Visibility
Retrieves active item lists and checks the specific publishing status or errors of individual products.

### Promotion Setup
Creates structured clearance or markdown sale rules for your product lines.

### Item Lifecycle Control
Publishes new listings, updates existing ones, or completely removes products from the marketplace.

## Use Cases

### Ending a Product Line
A seller needs to pull an item from the market but doesn't want it visible. They ask their agent to run `wm_retire_item` for SKU X, instantly masking it and preventing any customer from finding or buying it.

### Coordinating a Flash Sale
A team needs 50 different items on sale. They ask their agent to run `wm_setup_promotions` first, then use `wm_bulk_price_update` to set the final clearance price for all of them.

### Post-Merger Inventory Sync
After acquiring a new warehouse, an operator needs to verify stock. They run `wm_list_items` to see what's active, then use `wm_update_inventory` to accurately allocate the newly received physical stock.

### Data Cleanup and Audit
A catalog integrator suspects some items are misclassified. They run `wm_get_taxonomy` to get the correct category structure, then use that data to ensure new product listings are correctly placed.

## Benefits

- Stop manually adjusting prices across hundreds of SKUs. Use `wm_bulk_price_update` to send price changes for a massive batch of items in one go.
- Maintain real-time stock accuracy. If your physical counts change, use `wm_update_inventory` to sync the data immediately across all locations.
- Keep listings clean and error-free. Before running big campaigns, check item health using `wm_get_item_status` to find out if any SKU has buy-box limits or publishing errors.
- Manage your product lifecycle efficiently. Use `wm_list_items` to get a master list of everything you sell, and then use `wm_retire_item` when an item is permanently discontinued.
- Run major sales quickly. You can set up markdown rules using `wm_setup_promotions`, ensuring your clearance items are priced correctly right away.

## How It Works

The bottom line is that your AI client runs all the complex API interactions so you just focus on the final result: accurate data.

1. Configure your connection using your Walmart Developer Portal credentials (Client ID and Client Secret) to establish a secure link.
2. Select whether you need to run tests in Sandbox or go live in Production mode.
3. Your agent executes the desired operation, like updating inventory or setting prices, retrieving confirmation immediately.

## Frequently Asked Questions

**How do I check if my product listing is ready for sale using the Walmart Marketplace MCP?**
You use the `wm_get_item_status` tool. This analyzes the item's lifecycle status and reports on any potential errors or buy-box limitations so you know exactly what needs fixing.

**Can I update prices for multiple items at once with wm_bulk_price_update?**
Yes, `wm_bulk_price_update` is designed specifically to handle large volumes of price adjustments using a structured payload. It's much faster than doing it manually.

**What if I need to remove an item from the public listing? Should I use wm_retire_item?**
Yes, `wm_retire_item` is the correct tool. It completely removes the item's presence from the marketplace view, making sure it cannot be purchased.

**Does this MCP help me find the right category structure for a new product?**
You can use `wm_get_taxonomy` to pull safe and dynamic structural node trees. This helps you classify your products correctly before listing them.