# ShipHero MCP for AI Agents AI Agent Connect

> ShipHero MCP lets you manage your entire warehouse and fulfillment operation through your AI agent. You can track orders, adjust stock levels, and sync inventory from CSVs without jumping between tabs. It connects your logistics data directly to your workspace.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_YpUbEn4mTYwE3dvt62lbHREdsSJ9nssgt4etTNGc/ai-agent-connect
- **Tags:** wms, fulfillment, warehouse-operations, order-processing, stock-control

## Description

ShipHero MCP lets you manage your entire warehouse and fulfillment operation through your AI agent. Managing a warehouse usually means living in a sea of browser tabs, constantly switching between your storefront and your fulfillment software to see if an item is actually in stock. It's a headache, especially when you're trying to catch up on a backlog of orders or handle a sudden shipment of new goods. This Connector changes that by bringing ShipHero's data directly into your AI client. Instead of hunting for a specific SKU or digging through order histories, you can just ask your agent to find what you need. You can create new orders with all the shipping details, update stock levels across multiple locations, and pull in bulk inventory updates using a CSV URL. It even handles the messy stuff like converting legacy IDs to UUIDs so your data stays clean. Whether you're checking on a delayed shipment or trying to figure out why a certain item keeps going out of stock, you can get those answers in seconds. Having this in your Vinkius catalog means you don't have to leave your current workflow to keep your warehouse running smoothly.

## Tools

### list_inventory_changes
View the history of stock movements for a SKU to audit warehouse activity.

### list_orders
Retrieve a list of recent orders to monitor your current fulfillment pipeline.

### get_product
Get detailed product information including warehouse-specific availability.

### sync_inventory
Bulk sync your inventory using a CSV URL for rapid warehouse updates.

### add_inventory
Add or remove stock for a specific SKU to keep your warehouse counts accurate.

### create_order
Create a new order with full shipping details to speed up the fulfillment process.

### create_webhook
Register new webhooks to get real-time updates on your inventory and orders.

### get_uuid
Convert legacy numeric IDs into UUIDs to ensure your data remains consistent across systems.

## Prompt Examples

**Prompt:** 
```
Can you check if we have enough 'BLUE-SHIRT-L' in Warehouse A?
```

**Response:** 
```
I checked the inventory for SKU 'BLUE-SHIRT-L'. Here is the current status:

| Warehouse | Units Available |
| :--- | :--- |
| Warehouse A | 45 |
| Warehouse B | 12 |

**Total On-Hand:** 57 units.

Would you like me to move any stock between locations?
```

**Prompt:** 
```
I just got a CSV of 200 new items. Can you sync them to the warehouse?
```

**Response:** 
```
I can certainly help with that. Please provide the **CSV URL** where those 200 items are listed, and I'll start the bulk sync for your warehouse inventory immediately.
```

**Prompt:** 
```
Create an order for customer Jane Doe. They want 2 small hats and 1 large scarf. Ship to 123 Maple St.
```

**Response:** 
```
I've created that order for you. 

**Order Details:**
- **Customer:** Jane Doe
- **Shipping Address:** 123 Maple St
- **Items:**
  - Small Hat (Qty: 2)
  - Large Scarf (Qty: 1)

I've sent the details to ShipHero for fulfillment.
```

## Capabilities

### Create new orders
Generate a full order in ShipHero with shipping and line item details.

### Update stock levels
Add or remove inventory for specific SKUs instantly.

### Bulk sync inventory
Update your entire warehouse stock at once using a CSV URL.

### Track order history
View recent orders to monitor your current fulfillment pipeline.

### Audit inventory changes
See the history of stock movements for any SKU.

### Fetch product metadata
Get deep details on warehouse availability and product IDs.

### Register webhooks
Set up automated alerts for inventory and order updates.

## Use Cases

### Handling a sudden shipment of new goods
A warehouse lead receives a pallet of 500 items. They ask their agent to use sync_inventory to pull the data from a CSV URL and update the warehouse stock levels in one go.

### Resolving a low stock alert for a hot item
An e-commerce manager notices a popular shirt is sold out. They ask the agent to use add_inventory to put 50 more units into the warehouse and then use get_product to confirm the new total.

### Creating a high-priority custom order
A customer calls in a complex order. The manager asks the agent to use create_order to build the shipment with specific shipping notes and multiple line items without opening the ShipHero dashboard.

### Auditing inventory discrepancies
During a monthly audit, an ops lead asks the agent to use list_inventory_changes for a specific SKU to see every time the stock level was adjusted in the last 30 days.

## Benefits

- Stop manual data entry by using create_order to generate shipments with full line item details instantly.
- Keep stock levels accurate across all locations by using add_inventory to update counts as soon as shipments arrive.
- Handle massive updates in seconds by using sync_inventory to pull in data from a CSV URL for bulk warehouse changes.
- Get instant answers on stock status by using get_product to see warehouse-specific availability for any SKU.
- Monitor your fulfillment pipeline in real-time by using list_orders to see the status of every recent shipment.
- Audit warehouse movements with precision by using list_inventory_changes to see exactly how stock levels shifted over time.

## How It Works

The bottom line is you get a direct line to your warehouse data without leaving your chat window.

1. Subscribe to the ShipHero MCP on Vinkius
2. Paste your ShipHero Access Token into your client settings
3. Start asking your agent to manage orders or stock levels

## Frequently Asked Questions

**Can the ShipHero MCP help me manage my warehouse inventory?**
Yes. You can use it to check stock levels, add or remove inventory for specific SKUs, and view history of stock changes. It gives you a direct way to manage your warehouse without leaving your AI client.

**How do I update my stock levels in bulk using ShipHero?**
You can use the sync_inventory tool to update your entire warehouse at once. Just provide your agent with a CSV URL, and it will handle the bulk update for you.

**Can I use ShipHero to create new customer orders?**
Absolutely. You can tell your agent to create a new order with full shipping and line item details. It will then populate that data directly into your ShipHero account.

**Does the ShipHero MCP support webhook integration?**
Yes, you can register new webhooks through the Connector. This allows you to get automated updates on inventory changes or order statuses directly within your workflow.

**Can I use ShipHero to find a product's warehouse availability?**
Yes. You can ask your agent to fetch product details by SKU. It will return the specific availability for each of your warehouses so you can make informed shipping decisions.

**Is ShipHero MCP good for auditing my warehouse movements?**
It's great for audits. You can list inventory changes for any SKU to see a history of how your stock levels have moved over time, making it easy to track adjustments.

**How can I track the history of stock movements for a specific product?**
You can use the `list_inventory_changes` tool by providing the product SKU. It will return a detailed history of inventory adjustments, helping you audit stock movements over time.

**Is it possible to bulk update inventory levels across my warehouse?**
Yes! The `sync_inventory` tool allows you to provide a URL to a CSV file containing your inventory data. The server will process the file and sync the levels for the specified warehouse ID.

**What should I do if I only have a legacy numeric ID for an order or product?**
Use the `get_uuid` tool. It is specifically designed to convert legacy numeric IDs into the opaque UUIDs required by the modern ShipHero API for entities like Orders or Products.