# ShipBob MCP

> ShipBob MCP connects your AI agent directly to your e-commerce fulfillment system, giving you full control over your supply chain. You can manage product records, track inventory across multiple locations, create new orders, and update shipment details—all through natural conversation. It eliminates the need to jump between your store backend and the ShipBob dashboard just to check stock or cancel a shipment.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** fulfillment, order-tracking, supply-chain, warehouse-management, logistics

## Description

Managing e-commerce logistics shouldn't require three different browser tabs and a dedicated operations degree. This MCP connects your AI agent directly to ShipBob, letting you run your entire fulfillment process through conversation. Instead of navigating complex dashboards, you simply ask for what you need: 'What's the stock level for SKU 123?' or 'Can we cancel order 500?'

This tool lets you handle everything from managing product variants and converting items into bundles to tracking down historical inventory movements. If you're looking for a way to put all your supply chain data in one place, check out the Vinkius catalog; connecting this MCP gives your AI client immediate access to deep operational capabilities.

It’s about taking full command of order processing and warehousing visibility. You can create return orders, manage warehouse receiving documents, or just get a detailed status on any shipment without ever leaving your chat interface.

## Tools

### batch_cancel_shipments
Cancels an entire group of shipments simultaneously.

### batch_update_tracking
Marks multiple tracking records as successfully synced to your internal system.

### cancel_order
Cancels a specific order and any associated shipments.

### list_channels
Retrieves a list of all e-commerce sales channels the account is connected to, such as Shopify or Amazon.

### convert_variant_to_bundle
Combines product variants into a single new bundle listing.

### create_order
Generates and submits a new fulfillment order to the warehouse.

### create_product
Sets up entirely new products, including all required variants.

### create_receiving
Generates a formal Warehouse Receiving Order (WRO) for incoming inventory.

### create_return
Initializes and manages a return merchandise authorization (RMA).

### get_inventory_levels_by_location
Retrieves current inventory stock counts, separated by specific fulfillment center locations.

### get_inventory_levels_by_lot
Checks how much inventory is available, grouped specifically by lot or expiration date.

### get_inventory_levels
Gets a comprehensive total count of all inventory items across every location.

### get_order
Fetches detailed information and the current shipping status for any given order number.

### get_product
Retrieves all details associated with a specific product listing.

### get_receiving_labels
Downloads printable PDF box labels required for a Warehouse Receiving Order (WRO).

### get_shipment
Retrieves specific, granular details about an already created shipment.

### list_inventory
Lists all inventory items currently tracked in the system.

### list_invoices
Retrieves a list of invoices based on specified date ranges.

### list_orders
Provides a searchable list of orders, allowing filtering by status or tracking information.

### list_products
Lists all available products in the catalog with advanced filtering options.

### list_receiving
Shows a list of all active Warehouse Receiving Orders (WROs).

### list_returns
Displays a searchable list of all return orders.

### list_transaction_fees
Lists the different types of transaction fees that apply to sales.

### list_product_variants
Gets every size, color, or style variation associated with a particular product.

### query_inventory_history
Queries and reports on all historical inventory movement events for auditing purposes.

### query_transactions
Searches through financial records, including charges and credits.

### set_external_sync_receiving
Marks the Warehouse Receiving Orders (WROs) as having been successfully updated in your external system.

### update_product
Changes and saves modified details for an existing product listing.

### update_return
Modifies the status or details of a return order that is already active.

### update_shipment_address
Corrects and updates the final shipping address for an existing shipment.

## Prompt Examples

**Prompt:** 
```
List all my active ShipBob sales channels.
```

**Response:** 
```
I've retrieved your channels. You have 2 active installations: 'Shopify Store Front' (ID: 4567) and 'Amazon Integration' (ID: 8910).
```

**Prompt:** 
```
What is the current status and tracking for order 123456?
```

**Response:** 
```
Order 123456 is currently 'Shipped'. The tracking number is 1Z999AA10123456789 via UPS. It was dispatched from the Chicago fulfillment center.
```

**Prompt:** 
```
Show me the inventory levels for SKU 'SUMMER-HAT-01'.
```

**Response:** 
```
For SKU 'SUMMER-HAT-01', you have 150 units fulfillable across all locations, with 25 units currently committed to open orders.
```

## Capabilities

### Track Orders and Shipments
Get real-time details, current statuses, and tracking numbers for specific fulfillment orders.

### Manage Inventory Levels
Check stock counts by location, group lot, or get an aggregated overview of all available inventory units.

### Create and Modify Products
Establish new products, manage product variants, or combine existing items into bundles.

### Handle Returns and Receiving
Generate return merchandise authorizations (RMAs) or create warehouse receiving orders (WROs).

### Update Logistics Data
Correct shipping addresses, cancel multiple shipments at once, or update tracking information.

## Use Cases

### A shipment needs an address change before dispatch.
The CS agent realizes the customer gave the wrong zip code. Instead of emailing the ops team to manually correct it, they use their AI client to run `update_shipment_address`, fixing the error instantly and confirming the new delivery details.

### Inventory count is off across different warehouses.
The Ops Manager needs to know if a specific SKU is available at three different fulfillment centers. They prompt the agent to run `get_inventory_levels_by_location` and get immediate, segmented stock numbers.

### A batch of orders must be canceled due to supplier delays.
Instead of going into the dashboard and canceling 20 separate orders one by one, the manager uses `batch_cancel_shipments` with a simple prompt, clearing out all affected shipments in bulk.

### A customer returns an item that needs to be restocked.
The agent initiates the process using `create_return`, logs the incoming goods as a Warehouse Receiving Order (`create_receiving`), and then uses `list_returns` to track its progress through the system.

## Benefits

- Stop bouncing between dashboards. Your AI agent handles complex tasks like generating a return order (`create_return`) or updating an address on the fly.
- Never guess your stock count again. You can get accurate inventory levels by location using `get_inventory_levels_by_location`, so you always know what's available to ship.
- Product maintenance is simple. Instead of manual data entry, you can create new products (`create_product`) or combine variants into bundles (`convert_variant_to_bundle`) with a single prompt.
- Customer service improves instantly. If a customer needs an address change, your agent runs `update_shipment_address` immediately, confirming the fix without manual clicks.
- Audit trails are clean. You can query inventory history using `query_inventory_history` and review all transaction records via `query_transactions`, giving you total accountability.
- Speed up receiving. Instead of printing labels manually, you request them with `get_receiving_labels`, getting the required PDF box labels instantly.

## How It Works

The bottom line is you stop jumping between systems and manage logistics directly through natural conversation with your AI client.

1. Subscribe to the MCP and enter your ShipBob API Token.
2. Connect this MCP to your preferred AI client (Claude, Cursor, etc.).
3. Ask your agent a question or issue a command—for example, 'Show me all inventory levels grouped by lot'—and get instant data back.

## Frequently Asked Questions

**How do I check inventory levels with ShipBob MCP?**
You can use `get_inventory_levels`. This tool lets you see the total stock count across all locations, or if you need more detail, you can specify if you want to view stock grouped by lot using `get_inventory_levels_by_lot`.

**Can I update a shipping address with ShipBob MCP?**
Yes. Use the `update_shipment_address` tool. It lets your agent correct and save a new shipping location for an existing shipment, preventing costly delays.

**What is the best way to handle returns with ShipBob MCP?**
Start by using `create_return`. This generates the necessary return order (RMA) in the system. After the item arrives, you can then manage its intake using `list_returns`.

**Does ShipBob MCP let me create new products?**
Yes. You use `create_product` to set up brand new items and their variants. If you have existing product variations that need grouping, `convert_variant_to_bundle` handles that for you.

**How do I get a list of my active sales channels?**
Simply ask the agent to run `list_channels`. It will pull all connected e-commerce platforms, like your Shopify or Amazon integrations, into one easy response.