# Megaventory MCP

> Megaventory connects your AI agent directly to your entire inventory and order management system. Use it to check real-time stock levels across multiple warehouses, list all active products, or get deep details on any sales or purchase order. You can manage suppliers, track product SKUs, and orchestrate complex supply chain queries—all from a simple chat prompt.

## Overview
- **Category:** supply-chain
- **Price:** Free
- **Tags:** inventory-management, order-fulfillment, stock-tracking, warehouse-management, procurement

## Description

Megaventory hooks your AI agent right into your whole inventory and order system. You can use it to check real-time stock levels across multiple warehouses, list every active product, or pull deep details on any sales or purchase order—all from a simple chat prompt.

**Product Details and Search:**
When you need full metadata for one specific item, run `get_product(sku)` and feed it the SKU. If you want to see every single SKU managed by the system, use `list_products`. You don't have the exact code but know what you're looking for? Just use `search_products` with keywords pulled from the product description field.

**Stock Levels and Locations:**
To check how many units of any product are available right now, run `get_product_stock(sku)`; it gives you the live count across all your configured spots. You can see every physical storage location or warehouse set up in Megaventory by calling `list_inventory_locations`.

**Handling Sales Orders:**
If you need to know who bought what, use `get_sales_order(id)` and drop the ID; it fetches all client data and purchased items. To get a quick look at everything that's happened recently, run `list_sales_orders`, which shows recent activity and client details.

**Managing Purchase Orders:**
To track incoming goods, you can pull every detail about one specific purchase order using `get_purchase_order(id)`, including the items listed and when they're expected to arrive. If you just want a list of all pending or completed POs for a general overview, run `list_purchase_orders`.

**Networking and Directory Data:**
It tracks your relationships too: use `list_suppliers_clients()` to pull a directory listing of every registered supplier and customer account. You can manage the full scope of your supply chain queries—from product metadata to order status—all without logging into the web portal.

## Tools

### get_product
Gets all detailed information for one specific product using its SKU.

### get_purchase_order
Pulls all details about one specific purchase order, including items and expected delivery.

### get_sales_order
Fetches full data on a single sales order, showing the client and purchased items.

### get_product_stock
Retrieves the current stock level count for a given product SKU across all locations.

### list_suppliers_clients
Provides a directory listing of every registered supplier and customer account.

### list_inventory_locations
Lists every active physical warehouse or storage location configured in Megaventory.

### list_products
Gives a complete list of all product SKUs managed by the system.

### list_purchase_orders
Lists every purchase order, providing IDs and general status updates for bulk viewing.

### list_sales_orders
Lists all sales orders, showing recent activity and client details.

### search_products
Searches the entire product catalog using keywords found in the description field.

## Prompt Examples

**Prompt:** 
```
List all products in my Megaventory account.
```

**Response:** 
```
Retrieving products... I found several items including 'Standard Widget' (SKU: WID-001) and 'Premium Gadget' (SKU: GAD-999).
```

**Prompt:** 
```
What is the stock level for SKU 'WID-001'?
```

**Response:** 
```
Checking stock levels... SKU 'WID-001' has 150 units available across your 3 inventory locations.
```

**Prompt:** 
```
Show the last 5 sales orders.
```

**Response:** 
```
Querying sales orders... I found your most recent orders, including SO-12345 for Client 'TechCorp' and SO-12344 for 'Global Solutions'.
```

## Capabilities

### Check product details by SKU
The agent retrieves all metadata for a single, specific product identifier.

### Get real-time stock count
You can check how many units of any given product are available across your configured locations.

### Find specific sales orders
The agent fetches all details for a single sales order based on its ID, showing who bought it and when.

### List and search products
You can get a complete list of every product you carry or narrow the list down by keywords in the description using `search_products`.

### Manage supplier/client records
The agent lists and retrieves information for all your registered suppliers and customers.

### Track purchase order status
You can check the status, items, and expected delivery date for any pending or completed purchase order.

## Use Cases

### Investigating a Stockout Mystery
A customer calls about a specific item. You ask your agent: 'Why was SKU WID-001 low last week?' The agent first runs `list_sales_orders` to find recent high-volume orders, then uses `get_product_stock` to see the current count, and finally pulls details from `get_purchase_order` to confirm when more stock is due. You solve the problem in under 30 seconds.

### Onboarding a New Client
A sales rep needs client info for an account that's never worked with you before. They ask: 'What are our records on TechCorp?' The agent uses `list_suppliers_clients` to confirm the client exists, then runs `get_sales_order('TechCorp')` to pull their last three orders and history.

### Comparing Suppliers
You need to switch vendors for a component. You ask: 'List all our suppliers and compare them.' The agent uses `list_suppliers_clients`, allowing you to review the directory of available partners directly in your chat interface.

### Quickly Auditing Inventory Readiness
It's end-of-month audit time. You ask: 'List all products and their current stock status.' The agent runs `list_products` to get every SKU, then iterates through them calling `get_product_stock` for a comprehensive inventory report.

## Benefits

- Instead of logging into the web portal to check product details, ask your agent using `get_product` and get all SKU metadata in one conversational turn. This saves minutes every time you need an item's full specs.
- You stop guessing stock levels. Use `get_product_stock(SKU)` to pull real-time counts instantly, confirming availability across multiple locations without manually checking location by location.
- Needing order history? Running `list_sales_orders` gives you a quick overview of recent client activity, letting you find that specific order ID and status immediately.
- Supplier management gets simple. Instead of clicking through vendor portals, use `list_suppliers_clients` to pull up contact details or check if a new partner is already in the directory.
- Need to know where everything lives? Running `list_inventory_locations` gives you an immediate list of all your physical sites so you can narrow down any subsequent stock checks.
- Boost efficiency by using `search_products`. Don't waste time scrolling through thousands of SKUs; just tell the agent what you need, and it finds the right product.

## How It Works

The bottom line is, your AI client treats Megaventory like a searchable database that speaks English, not API endpoints.

1. Subscribe to this server on Vinkius Marketplace and input your Megaventory API Key.
2. Your AI client (e.g., Claude, Cursor) sends a natural language request to the agent.
3. The agent translates that request into specific tool calls—like `get_product_stock(SKU)`—and returns the structured data to you.

## Frequently Asked Questions

**How do I list all available products with Megaventory MCP Server?**
You use the `list_products` tool. This runs immediately and gives you an exhaustive list of every SKU ID in your catalog, letting you know what data is even available to query.

**Can I check stock levels using get_product_stock?**
Yes. You pass the specific Product SKU into `get_product_stock(SKU)`. The result is a precise unit count for that item across your configured inventory locations.

**Which tool do I use to find a client's order history?**
Start by calling `list_sales_orders` to get a list of recent Order IDs. Then, pass the specific ID you care about into `get_sales_order(ID)` for full details.

**How can I search products if I forget the SKU?**
Use `search_products`. You just need to give it keywords from the product description (e.g., 'Widget' or 'Gadget'), and it finds the matching SKUs for you.

**How do I use list_inventory_locations to check all my warehouse sites?**
The tool returns a list of every configured inventory location. This helps you know exactly which physical locations are tracked by the system.

**Can I get details for a specific purchase order using get_purchase_order?**
Yes, provide the Purchase Order ID to the tool. The result gives full visibility into the PO's status, items ordered, and expected delivery dates.

**What does list_suppliers_clients do if I need a contact directory?**
It provides a comprehensive list of both your suppliers and clients. This tool lets you manage or view core entity data without needing their specific IDs first.

**If I want to see all sales orders, should I use list_sales_orders?**
Using list_sales_orders gives you a summary of every recorded sale. You can then select an order ID to get detailed information about that specific transaction.

**How do I find my Megaventory API Key?**
Log in to Megaventory, go to Settings, and look for the API section to generate or copy your API Key.

**Can I check stock levels for a specific SKU?**
Yes! Use the `get_product_stock` tool and provide the product SKU to see current availability across all locations.

**Is my inventory data secure?**
Absolutely. Your token is encrypted at rest and injected securely at runtime.