# BoxHero MCP for AI Agents MCP

> BoxHero connects your inventory management to any AI agent. List items, track every stock transaction—whether it's a shipment in or an item moved location—and keep precise records of storage locations using natural conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** stock-tracking, barcode-scanning, inventory-control, transaction-history, warehouse-management, small-business-tools

## Description

Running a physical store or warehouse means dealing with constant movement: things coming in, getting put away, and eventually shipping out. BoxHero lets your AI agent manage that complexity without you ever touching a dashboard. Instead of digging through spreadsheets to see if 'Keyboard' stock levels are accurate, you just ask your agent. It immediately knows the current count, the full transaction history, and where those items are physically stored in your facility.

It handles everything from creating new item records to logging complex movements using structured data. The entire process is orchestrated through natural conversation. You connect BoxHero via Vinkius, giving your AI agent instant access to all your inventory records—item specifications, location details, and every stock movement that has ever happened. It turns what used to be a massive manual audit into a simple query.

## Tools

### create_item
Registers a brand new item that has not yet been tracked in your inventory system.

### create_transaction
Logs a stock movement, recording if units were added (in), removed (out), or moved internally.

### delete_item
Permanently removes an item record from your inventory catalog.

### get_account_info
Retrieves basic details about the user who authenticated access to the system.

### get_item
Pulls all specific data points for one item by knowing its unique identifier.

### list_attributes
Retrieves a list of custom fields or metadata you've defined across your product catalog.

### list_items
Generates a full list of every item currently managed within the inventory system.

### list_locations
Provides an overview of all designated storage areas and physical warehouses connected to your account.

### list_transactions
Lists past stock movements, showing records of items coming in or going out over time.

### update_item
Modifies existing product details, such as renaming an item or adjusting its description.

## Prompt Examples

**Prompt:** 
```
I need an audit report on all 'Keyboard' units: how many do we have right now and what were their last five movements?
```

**Response:** 
```
**Inventory Audit Report**

*   **Item:** Keyboard (SKU KBD-001)
*   **Current Stock Level:** 80 units
*   **Last Five Transactions:**
    *   ✅ **2024-06-13:** +50 units (Stock In - Supplier Alpha)
    *   ❌ **2024-06-12:** -10 units (Stock Out - Order #998)
    *   🔄 **2024-06-11:** +5 units (Move - From Receiving to Aisle 3)
    *   ✅ **2024-06-10:** +75 units (Stock In - Shipment Beta)
    *   ❌ **2024-06-09:** -15 units (Stock Out - Order #997)
```

**Prompt:** 
```
List all active items that have custom attributes, like 'warranty type' or 'color'.
```

**Response:** 
```
**Active Items with Custom Attributes**

The following 4 items were found matching criteria:

| Item Name | SKU | Stock Level | Warranty Type |
| :--- | :--- | :--- | :--- |
| Monitor Pro | MON-P01 | 25 | 3 Year Extendable |
| Wireless Mouse | MOUSE-W | 150 | 1 Year Basic |
| Laptop X9 | LAPX-9 | 80 | 3 Year Extendable |
| Webcam HD | CAM-HD | 75 | N/A |

*Note: Attributes were pulled using the `list_attributes` tool.*
```

**Prompt:** 
```
We need to move 10 monitors from the main warehouse to the overflow storage room. Can you log that?
```

**Response:** 
```
**Location Transfer Logged**

The following transaction was successfully recorded:

*   **Transaction ID:** TXN-20240614-A
*   **Item:** Monitor Pro (MON-P01)
*   **Quantity Moved:** 10 units
*   **From Location:** Main Warehouse Aisle 1
*   **To Location:** Overflow Storage Room C
*   **Status:** Complete. Stock count updated.
```

## Capabilities

### Inventory Item Creation and Modification
Registers a brand new item that has not yet been tracked in your inventory system, or updates existing product details.

### Stock Movement Logging (In/Out/Move)
Logs every physical movement of units, recording if they were added (stock-in), removed (stock-out), or transferred internally.

### Catalog Detail Retrieval
Pulls all specific data points for one item by knowing its unique identifier, and retrieving custom attributes across the catalog.

### Warehouse Mapping and Listing
Provides an overview of all designated storage locations or generates a full list of every managed inventory item.

### Historical Data Reporting
Retrieves comprehensive lists of past transactions, showing exactly when and why stock levels changed over time.

## Use Cases

### Need a full inventory count before shipping?
The warehouse team asks the agent: 'I need a total count of all monitors.' The agent runs `list_items` to find the SKU and then uses transaction history functions to calculate the precise, real-time stock level.

### A shipment arrived late and needs logging.
The receiving clerk asks: 'Log 50 units of Keyboard that just arrived.' The agent executes `create_transaction` (Stock In), ensuring the item count is accurate immediately upon arrival.

### We need to know if an item was ever moved.
The manager asks: 'Show me all movements for SKU X.' The agent uses `list_transactions` and filters by location, providing a clear audit trail of the product's history.

### We are reorganizing the warehouse layout.
Instead of physically mapping every area, the user asks the agent to list all storage locations. This provides an immediate overview needed for planning and zoning changes.

## Benefits

- Eliminate manual stock audits. Use the `list_transactions` tool to pull a complete history of every item move, giving you instant audit readiness.
- Never lose track of where things are. The MCP lets you list all storage locations via `list_locations`, ensuring your AI agent knows which warehouse floor to check.
- Speed up onboarding new products. Use `create_item` and `list_attributes` together, letting the AI build out item records with custom metadata in seconds.
- Accurate counts are always available. The system allows you to use `get_item` alongside transaction logging (`create_transaction`) for real-time stock verification.
- Streamline updates. Instead of manually changing data, use `update_item` through natural language conversation to modify item descriptions or names.

## How It Works

The bottom line is that once connected, your AI agent handles the connection details and API calls; you just talk to it naturally.

1. Subscribe to the BoxHero MCP on Vinkius.
2. Enter your unique BoxHero API Token into your AI client's settings.
3. Tell your agent what you need—for example, 'Show me all inventory that needs a count audit,' and it executes the necessary operations.

## Frequently Asked Questions

**How can BoxHero help me track stock levels in real-time?**
BoxHero gives you an accurate view of your current inventory counts by tracking every movement. You don't have to guess—your agent uses the MCP tools to pull live data, telling you exactly what's available right now.

**Does BoxHero help me keep track of where my items are in the warehouse?**
Yes. It manages storage locations and tracks item transfers between them. If an item moves from one shelf to another, you can log that movement instantly, keeping your records perfect.

**I'm running a small shop; is BoxHero too complex for me?**
No. You interact with it using natural language through your AI agent. It handles the complexity of tracking items and locations behind the scenes, letting you focus on selling.

**Can BoxHero generate a full audit trail of stock movements?**
Absolutely. The MCP provides a complete log of every item transaction—every time something was added or removed. This history is crucial for audits and figuring out where inventory discrepancies came from.

**What if I need to add custom details like 'color' or 'model number' to an item?**
You can manage those specific details using the MCP. It lets you list available attributes and create new items with all your necessary product metadata included.

**Is BoxHero better than just using a big spreadsheet for inventory?**
Yes, because it's live. A spreadsheet is static; BoxHero updates instantly when an item is moved or shipped out. You get real-time data access through your agent, not old numbers from a file.