# Wherefour MCP

> Wherefour connects your manufacturing data directly to your AI agent. It lets you check inventory levels, track specific product lots for quality control, and manage everything from sales orders to vendor payments without opening a dozen different apps.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** lot-traceability, production-tracking, manufacturing, inventory-control, supply-chain-transparency, erp

## Description

Managing production is messy. You shouldn't need six separate logins just to know if an order can ship or if the books balance. This MCP connects your entire manufacturing workflow—from raw materials to final invoice—into one place.

Need to know how many units are left of a specific product, where they sit in the warehouse, and which batch they belong to? You get that visibility instantly. Need to see if a payment clears or what formula was used to make it? It’s all there. The real value is seeing the entire operational picture: checking stock levels, locating required components, confirming vendor details, and tracking billing records—all through natural conversation.

Because this MCP handles financial and physical goods data together, every single tool call generates a cryptographically signed audit trail in Vinkius. This means you always know exactly who asked for what information and how the numbers flowed, making compliance checks simple. You can use your AI client to manage production recipes, find specific item metadata, or even search through old purchase records—all without leaving your chat window.

## Tools

### get_inventory_item
Retrieves detailed specifications for a single named inventory item.

### get_order
Pulls all specific details associated with one sales or production order number.

### list_customers
Generates a list of every customer record in the system.

### list_formulas
Provides a catalog view of all product recipes or manufacturing formulas used by the company.

### list_inventory_items
Lists every single inventory item currently tracked in your system.

### list_invoices
Retrieves a list of all customer billing invoices for review.

### list_locations
Shows a list of every designated storage area or facility location.

### list_orders
Gets a summary view of all pending and completed sales and production orders.

### list_purchases
Provides an overview of past purchase records and vendor spending.

### list_stock_lots
Lists all recorded batches, allowing you to track specific material groups.

### list_vendors
Generates a full list of all suppliers and vendors in your network.

### search_inventory
Searches the entire item catalog using keywords or metadata filters.

## Prompt Examples

**Prompt:** 
```
Search our inventory for 'Organic Cane Sugar' and pull up the production formula that uses it for the upcoming beverage batch.
```

**Response:** 
```
I found 'Organic Cane Sugar' (Item #8492) in your inventory with 450 lbs currently in stock. It is a primary ingredient in the 'Summer Citrus Kombucha' formula. The formula requires 25 lbs of sugar per production batch. Would you like to view the full recipe?
```

**Prompt:** 
```
Check the lot traceability for batch 'L-2024-QT3' of Arabica Coffee Beans and tell me which warehouse location it is currently stored in.
```

**Response:** 
```
I've retrieved the traceability data for lot 'L-2024-QT3'. This batch of Arabica Coffee Beans was received from 'Highland Roasters' on October 12th. It passed quality inspection and is currently stored in 'Warehouse B, Zone 4, Rack 12'. There are 120 units remaining in this lot.
```

**Prompt:** 
```
List all pending production orders for 'Acme Supermarkets' and verify if their latest invoice from last month has been paid.
```

**Response:** 
```
There are 2 pending production orders for 'Acme Supermarkets': PO-7381 (Organic Oatmeal) and PO-7389 (Almond Milk), both scheduled for completion this Friday. I also checked their billing records; Invoice #INV-5920 from last month is marked as 'Paid in Full'.
```

## Capabilities

### Search inventory items
Find product details and specifications by searching the catalog.

### Retrieve stock lot details
Access batch information to verify quality control or compliance for specific materials.

### Track orders
Get status updates on both sales and internal production orders.

### Manage vendor/customer records
List and access the directory of your suppliers, vendors, or clients.

### View financial history
Fetch detailed lists of customer invoices or past purchase receipts.

### Map production recipes and locations
Check what materials are needed for a product, or where that product is stored in the facility.

## Use Cases

### Need to ship product X, but the customer payment status is unknown.
Instead of logging into accounting and then calling fulfillment, ask your agent: 'Check `get_order` for PO-123. Is it ready? Also, check `list_invoices` to confirm if the latest invoice was paid.' The agent gives a single definitive status.

### A product failure requires tracing back raw materials.
Ask your agent: 'What is the full lot traceability for batch L-2024? Show me where it came from and what formula was used.' The agent uses `list_stock_lots` and `list_formulas` to build a complete audit trail.

### A new product needs to be stocked, but the recipe is unclear.
Use the AI to check all available recipes by calling `list_formulas`, then ask it to compare that list against current stock items using `search_inventory` so you know what ingredients are immediately usable.

### Need a quarterly financial review of spending.
Instead of pulling reports from three different tabs, instruct your agent to pull all purchase records via `list_purchases`, then cross-reference it with the list of vendors using `list_vendors` for a holistic spend overview.

## Benefits

- Track compliance history: Use `list_stock_lots` to immediately check the full batch record for any material, satisfying quality control needs instantly.
- Cross-check billing data: Run `list_invoices` alongside `get_order` details to confirm if a shipment has cleared its payment status.
- Know your components: Check available recipes using `list_formulas`, then cross-reference those ingredients against current stock via `search_inventory`.
- Manage suppliers and buyers: Keep vendor records updated by listing all contacts with `list_vendors` or checking past spending using `list_purchases`.
- Avoid app switching: Get a combined status report on multiple pending tasks simply by calling `list_orders`, pulling together both sales and production data.
- Build automations: Combine multiple MCPs—for example, linking this Wherefour MCP with a messaging MCP—to automatically notify staff when an order requires manual attention.

## How It Works

The bottom line is you manage complex manufacturing processes by talking to the system instead of clicking through multiple dashboards.

1. Connect your Wherefour API Key and Secret to Vinkius. Then, select if you're working with test (Sandbox) or live data (Production).
2. Your AI agent uses the available tools—like `get_order` or `search_inventory`—to pull specific records from your ERP.
3. You get a summarized answer in plain language that combines inventory status, order details, and financial facts into one conversational response.

## Frequently Asked Questions

**How do I check if a specific batch of product was handled correctly? (list_stock_lots)**
Use `list_stock_lots` to see all recorded batches. This tool lets you track the full history, confirming when it arrived and what quality checks were performed on that exact material.

**What if I need to check both sales orders and production needs? (list_orders)**
`list_orders` gives you a unified view of both. You can see which items are reserved for customers (sales) and which materials are needed internally for the next run (production).

**Can I find out what raw materials were used to create an item? (list_formulas)**
Yes, call `list_formulas`. This tool shows all the official recipes. You can then compare those formulas against your current stock levels using other tools.

**Does this MCP handle vendor payments or just sales invoices? (list_purchases)**
It handles both sides. `list_invoices` tracks money owed to you, while `list_purchases` tracks the records of what you paid out to vendors.

**How do I find my Wherefour API Key and Secret?**
Log in to your Wherefour account, navigate to **Settings** > **API**, and generate a new set of credentials for your integration.

**Can the agent check lot availability for a specific item?**
Yes! Use the `list_stock_lots` tool to retrieve all available batches and their current quantities for any item in your catalog.