# CartonCloud MCP

> CartonCloud connects your warehouse and transport systems directly into your AI agent. You can check real-time stock levels, pull full lists of inbound and outbound orders, track specific shipments by ID, and audit logistics invoices—all through natural conversation.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** wms, tms, 3pl, order-fulfillment, warehouse-management, supply-chain

## Description

Running a 3PL operation means dealing with data that lives everywhere: the warehouse database, the sales platform, the carrier API, and finance. This MCP handles all of it. You connect your CartonCloud account via Vinkius and give your AI agent direct access to your WMS and TMS functions. Instead of logging into five different dashboards just to answer a customer's question about their shipment status, you ask your agent directly. It pulls the necessary information—like retrieving generated invoices or listing inbound purchase orders—and gives you one clean summary. You can check current stock levels by product ID and even manage master data for customers without ever leaving your chat window. This is how you stop wasting time switching tabs and start getting actual answers.

## Tools

### get_sale_order_details
Pulls every detail for a single, specific outbound sale order number.

### get_product_stock
Checks and returns the available quantity for a specific product SKU in your warehouse.

### list_consignments
Shows all currently active transport shipments and their latest delivery status.

### list_logistics_customers
Provides a complete list of customer accounts associated with the logistics service.

### list_logistics_invoices
Generates and lists specific invoices for services provided by CartonCloud.

### list_warehouse_products
Lists the official product catalog and master data definitions used across your warehouse.

### list_purchase_orders
Lists all incoming goods orders, showing what products are expected to arrive at the warehouse.

### list_sale_orders
Retrieves a list of outbound customer orders that are ready or pending fulfillment.

## Prompt Examples

**Prompt:** 
```
List my last 10 sale orders in CartonCloud.
```

**Response:** 
```
Retrieving your recent sale orders... I found 10 orders including #SO-123 (Picking) and #SO-124 (Dispatched). Would you like the details for any specific order?
```

**Prompt:** 
```
What is the current stock for product ID 555?
```

**Response:** 
```
Checking stock for product 555... You currently have 150 units available in the North Warehouse and 45 units in the South Warehouse.
```

**Prompt:** 
```
Show me the transport consignments for today.
```

**Response:** 
```
Retrieving today's consignments... I found 5 active shipments. 3 are 'Out for Delivery' and 2 are 'Booked'. Should I check the status of a specific tracking number?
```

## Capabilities

### Check Stock Levels
It pulls the precise, real-time stock count for any specific product SKU.

### Track Shipments
You can list transport consignments and get current delivery statuses without needing a tracking number upfront.

### View Order History
The agent pulls details for both outbound sale orders and inbound purchase orders, letting you see the full order flow.

### Audit Finances
It retrieves generated invoices related to logistics services, giving you immediate financial visibility.

### Manage Core Data
You can list and update customer profiles or access master product details like SKUs and unit of measure metadata.

## Use Cases

### The Customer Calls with an Urgent Status Check
A customer calls asking where their shipment is. Instead of reading a vague tracking number, you ask your agent to use `list_consignments` and then pull the full details using `get_sale_order_details`. Your agent responds immediately: 'It's out for delivery from location XYZ.' You solve it in seconds.

### Reconciling Inventory Shortages
The sales team notes an order discrepancy. The planner asks the agent to check `list_purchase_orders` and compare those expected items against what the system reports with `get_product_stock`. This quickly flags if goods are delayed or miscounted.

### Quarterly Financial Review
The accounting team needs to audit fulfillment costs. They ask the agent to pull all relevant invoices using `list_logistics_invoices` and then cross-reference the customer data using `list_logistics_customers`. This builds a complete, verifiable report.

### Checking Master Data Integrity
A new warehouse product is added. Rather than updating three separate systems, you use the agent to access the master catalog via `list_warehouse_products`, ensuring SKUs and unit of measure are correct before listing any sale orders.

## Benefits

- Know inventory status instantly. Instead of logging into a WMS dashboard just to check stock, use the `get_product_stock` tool via chat. You get immediate confirmation on availability.
- Track shipments without friction. Use `list_consignments` to see all active transport runs and their progress. No need to open carrier websites or call dispatchers.
- Audit billing easily. When reviewing costs, the agent uses `list_logistics_invoices` so you can pull service invoices immediately alongside customer profiles from `list_logistics_customers`.
- Manage the full cycle. You can compare pending goods using `list_purchase_orders` against what was actually sold via `list_sale_orders`, helping catch discrepancies early.
- Get deep order visibility. Instead of just seeing a list, you can use `get_sale_order_details` to get all the specifics on one single outgoing shipment.

## How It Works

The bottom line is that you talk to one interface, and it talks to all your logistics systems.

1. First, subscribe to this MCP on Vinkius and input your specific CartonCloud credentials (Client ID, Secret, Region).
2. Next, activate the connector within your AI client. This gives your agent permission to run logistics queries against your live system.
3. Finally, just ask your agent a question, like 'What's the stock for product X?' or 'List my pending shipments.' The agent executes the tool call and returns the answer.

## Frequently Asked Questions

**How do I check stock for a product using get_product_stock?**
You simply ask your agent, 'What's the stock level for SKU 456?' It executes `get_product_stock` and gives you the available count immediately. You don't need to provide any complex parameters.

**Can list_purchase_orders help with current inventory counts?**
Yes, it helps by showing what goods are expected soon. By comparing `list_purchase_orders` results against the data from `get_product_stock`, you can predict future stock levels.

**What is the difference between list_sale_orders and get_sale_order_details?**
`list_sale_orders` gives you a quick view of many orders, like an index. `get_sale_order_details` lets you drill down into one specific order ID to see every line item and status.

**Do I need list_logistics_invoices to know if I was paid?**
It's the best way. Running `list_logistics_invoices` gives you a direct, auditable record of services rendered and billed through CartonCloud.

**What does the status code mean if I use list_consignments?**
The statuses are definitive indicators of shipment progress. 'Out for Delivery' means it has left the depot and is with the local courier, while 'Booked' indicates the shipment is scheduled but hasn't departed yet.

**Can I use list_warehouse_products to filter by specific SKUs or units of measure?**
Yes, you can include filtering parameters when calling this tool. This limits the results to only show products matching your exact SKU or required unit metadata.

**If I run list_logistics_customers, what unique identifier do I need for future actions?**
The Customer ID is the primary key you must extract from this listing. You use that specific ID whenever referencing a customer in other tools, such as checking invoices or placing orders.

**How can I compare inbound stock using list_purchase_orders against current needs?**
First, run list_purchase_orders to get the expected inventory arrivals. Then, you pass those item IDs into other tools to reconcile what's coming in versus what your sales orders require.

**Can I check stock levels for a specific SKU?**
Yes! Use the `get_product_stock` tool with the product's unique ID. The agent will return the current available quantities across your warehouses.

**How do I see all pending sale orders?**
Use the `list_sale_orders` tool. Your agent will fetch the list of outbound orders along with their current status and customer information.

**Which regions does this integration support?**
It supports all CartonCloud regions. You just need to specify your region subdomain (e.g., `api-au` for Australia, `api-us` for United States) during setup.