# WooCommerce Inventory Updater MCP

> WooCommerce Inventory Updater lets your AI agent automatically update stock levels for any product or variation in your online store. It reads supplier PDFs, invoices, and spreadsheets, syncing inventory counts instantly without you touching a single data field.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** stock-management, inventory-sync, product-data, automation, supply-chain

## Description

Stop copying numbers from messy supplier PDFs or giant Excel sheets into WooCommerce's backend. This MCP gives your AI the ability to read external documentation and perform precise stock updates for your store. When connecting this through Vinkius, you get access to critical inventory control without ever needing to write code.

It works by taking data—say, a new invoice from your main supplier—and extracting the product IDs along with the new quantities. Your agent then uses that clean information to execute the changes directly into WooCommerce. Crucially, this tool is surgical: it only updates the stock quantity. It won't change prices or descriptions; it just makes sure the right count shows up for the right item, every time.

## Tools

### update_woocommerce_inventory
This function updates a product's or variation's current inventory count, requiring the numeric ID of the item and its new stock quantity.

## Prompt Examples

**Prompt:** 
```
Update the stock of product 402 to 150 units.
```

**Response:** 
```
I've successfully updated the inventory for Product #402. The new stock quantity is 150 (Status: instock).
```

## Capabilities

### Synchronize Product Stock Counts
The agent can update the current inventory levels for any core product in your WooCommerce store.

### Manage Variations
It handles complex products, ensuring that specific variations (like a blue size medium shirt) receive their own correct stock count.

### Process External Inventory Data
Your agent can read data from sources like PDFs or spreadsheets to generate the necessary updates for your store.

## Use Cases

### Receiving a large shipment manifest
A warehouse worker gets a spreadsheet listing 500 incoming SKUs and their new counts. They tell their agent to 'Update the WooCommerce stock using this sheet.' The agent parses the file, uses update_woocommerce_inventory for every product, and confirms all changes are live.

### Supplier sends a PDF invoice
The Inventory Manager receives a multi-page PDF from a primary vendor. They pass the document to their agent, which extracts every item and its new stock count before calling update_woocommerce_inventory across the board.

### Correcting an online error
A product's stock was manually set incorrectly in WooCommerce. Instead of logging into the dashboard, the Ops Specialist uses the agent to correct the single item using update_woocommerce_inventory with only the corrected count.

## Benefits

- Eliminate manual data entry. Instead of copying numbers from supplier invoices into WooCommerce, your agent reads the PDF and updates stock automatically.
- Handle product variations easily. You can ensure that specific items—like a red size small shirt—get their own accurate count using variation IDs.
- Speed up receiving processes. When new inventory arrives, you simply feed the manifest to the MCP; it handles the entire update process instantly.
- Maintain data safety. This tool is strictly limited to stock quantity updates. It can't accidentally change your prices or descriptions.
- Centralize workflow management. By connecting this through Vinkius, all your inventory tools live in one place, accessible from any MCP-compatible client.

## How It Works

The bottom line is you feed it a list of changes, and it applies those changes accurately, without risk of changing anything else on the product page.

1. You hand the AI client a source document, such as an updated PDF invoice or a spreadsheet listing new stock counts.
2. Your agent reads the file, identifying product IDs and determining the exact numeric quantity that needs to be set for each item.
3. The MCP executes the update using the collected data, confirming the new stock level (and status) directly in WooCommerce.

## Frequently Asked Questions

**Can WooCommerce Inventory Updater handle multiple product variations?**
Yes, it can. You must provide the specific variation ID along with the product ID and stock count so the agent knows exactly which size or color to update.

**Does this MCP change my product prices?**
No. The tool is designed only for updating `stock_quantity`. It cannot alter pricing, descriptions, or any other core product metadata.

**What format does the source data need to be in for WooCommerce Inventory Updater?**
It can read common formats like PDFs and spreadsheets. However, you must ensure that the document clearly contains both the numeric Product ID and the new stock count.

**If I only update one product, do I still use this MCP?**
Yes. You don't need a bulk shipment to use it; you just need the specific Product ID, the desired stock count, and your agent will run the single update.

**Can WooCommerce Inventory Updater handle products that are out of stock?**
Yes. You simply provide '0' as the new stock quantity, and the MCP updates the product status correctly for you.

**Will it enable stock management if it is turned off?**
Yes. When this tool updates the quantity, it automatically sends `manage_stock: true` to the WooCommerce API, ensuring the new stock quantity is actually tracked by the system.