# ShipHero MCP > ShipHero MCP manages your entire e-commerce fulfillment chain directly through your agent. You can track orders, check real-time stock levels across multiple warehouses, and perform bulk inventory updates without leaving your workflow. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** wms, fulfillment, warehouse-operations, order-processing, stock-control ## Description This connector links your ShipHero account to any compatible AI client, letting you manage complex warehouse and order tasks using natural language. Need to know how many blue shirts are left in Warehouse A? Ask your agent. Want to create a new high-value order for a client? Send the details over. It handles everything from checking stock by SKU to syncing massive inventory adjustments via CSV URLs. Because Vinkius hosts this MCP, you connect once and gain access to all these critical logistics tools right alongside your other business processes. You can even set up webhooks so your agent automatically updates when an order status changes or stock levels shift. ## Tools ### add_inventory Adjusts the stock count by adding or removing units for a specific SKU. ### create_order Generates and submits an entirely new order record into ShipHero's system. ### create_webhook Sets up a notification endpoint so your agent knows when specific inventory or order events occur. ### get_uuid Converts an old, numeric product ID into the modern UUID format used by ShipHero. ### list_inventory_changes Retrieves a detailed log showing every change that has happened to a specific SKU's stock level. ### list_orders Fetches a list of all orders associated with your ShipHero account. ### get_product Retrieves detailed product information, including its current stock status and warehouse availability by SKU. ### sync_inventory Updates inventory levels across your system using a provided CSV data URL for large-scale changes. ## Prompt Examples **Prompt:** ``` List the 10 most recent orders from my primary warehouse. ``` **Response:** ``` I've retrieved the latest orders. You have 10 recent records, including Order #SH-1029 (Status: Pending) and Order #SH-1030 (Status: Fulfilled). Would you like details on a specific one? ``` **Prompt:** ``` Check the current inventory level and warehouse details for SKU 'BLUE-SHIRT-L'. ``` **Response:** ``` For SKU 'BLUE-SHIRT-L', I found 45 units available in Warehouse A and 12 units in Warehouse B. The total on-hand inventory is 57 units. ``` **Prompt:** ``` Add 25 units to SKU 'GIFT-WRAP' in warehouse 'WH-99' because of a new shipment. ``` **Response:** ``` Successfully updated inventory for 'GIFT-WRAP'. Added 25 units to warehouse 'WH-99'. The new balance has been synchronized. ``` ## Capabilities ### Manage Inventory Levels Check current product availability by SKU, track the history of inventory movements, and adjust stock counts instantly for specific items. ### Process Orders Retrieve a list of recent orders or build entirely new ones within your fulfillment system using full line item details. ### Automate Warehouse Processes Upload bulk CSV files to update inventory levels across multiple SKUs, or register webhooks to keep your agent updated on status changes. ## Use Cases ### Fulfillment Audit The operations coordinator needs to know if the physical stock matches the system records. They ask their agent to list_inventory_changes for SKU 'BLUE-SHIRT-L' and then use get_product to confirm the current warehouse breakdown, making sure every unit is accounted for. ### Bulk Replenishment A supplier just sent 500 boxes of merchandise. Instead of manually entering each item, the manager uses sync_inventory and points it at a CSV URL containing all the new stock data, completing the update in seconds. ### New Client Onboarding A sales rep needs to place an order for a major client. They simply tell their agent to create_order, providing the full list of items and quantities, which then generates a valid record immediately. ### Automation Setup The development team wants alerts when stock dips below 10 units. They use create_webhook to register an event listener, so their agent automatically knows when inventory levels drop and can flag it for review. ## Benefits - Track order status without leaving your platform. You can use list_orders to get a quick overview of recent shipments or create_order if you need to place an emergency purchase. - Stop manually counting inventory. Use add_inventory to adjust stock when receiving new goods, and list_inventory_changes tracks exactly how many units left the shelf and why. - Handling big data dumps is easy. The sync_inventory tool lets you upload a CSV URL to update thousands of items at once, which is way faster than manual entry. - Know what your products are worth before they sell. get_product provides deep metadata, even showing legacy ID conversion via get_uuid if needed for old records. - Keep your workflow running automatically. You can use create_webhook to make sure that when an order ships, your agent gets a notification right away. ## How It Works The bottom line is you get to manage real-time logistics data through simple prompts in whatever application your AI client supports. 1. Subscribe to the ShipHero MCP and enter your personal Access Token. 2. Your AI client connects this token and authenticates your connection with ShipHero. 3. You ask your agent to perform a task, like checking product details or listing orders. The agent executes the action using the connected tools. ## Frequently Asked Questions **Can ShipHero MCP list all my orders?** Yes. The tool uses list_orders to retrieve a full list of your recent shipments directly through the MCP, so you don't have to navigate the portal. **How do I update stock levels using ShipHero MCP?** You can use add_inventory for small changes or sync_inventory if you have a CSV file with many products that need updating. Both options keep your records accurate fast. **Does the ShipHero MCP help me automate alerts?** Yes. You can run create_webhook to set up automatic notifications within your agent's workflow. This way, you get an immediate alert when a key event happens, like a low stock warning. **What if I have old product IDs?** No sweat. You can use the get_uuid tool to convert any legacy numeric ID into the modern UUID format, letting you keep using old data records without issue. **Can I create an order through ShipHero MCP?** Absolutely. The create_order tool lets your agent build and submit a completely new customer order right from your prompt, including all necessary line item details.