# DCL Logistics MCP

> DCL Logistics connects your AI agent directly to third-party logistics data. Track current shipments, check real-time warehouse stock levels by SKU, list all open fulfillment orders, and monitor customer returns without leaving your chat window.

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

## Description

Managing a supply chain is usually a mess of different dashboards and manual lookups. This MCP connects you right into DCL Logistics' system. Instead of clicking through multiple tabs to find out where an order stands or if enough stock exists for next week’s sales, you simply ask your agent. It pulls the necessary data—whether it's finding a specific shipment ID or listing all low-stock items—and gives you the answer immediately. You can get full oversight of everything from initial order creation to final delivery confirmation. If your AI client works with Vinkius, connecting this MCP lets your agent access critical fulfillment details in one conversation, making operations management fast and accurate.

## Tools

### get_account_details
Pulls metadata about your DCL account, including service tier and active warehouse assignments.

### get_sku_inventory_status
Returns the current stock level, location, and movement status for any given SKU.

### get_order_details
Provides a complete audit trail and line item details for one specific fulfillment order.

### get_shipment_details
Gets tracking status, estimated delivery dates, and proof of delivery for a single shipment ID.

### list_warehouse_inventory
Lists current inventory levels across all items, detailing on-hand, available, and reserved quantities.

### list_low_stock_items
Identifies SKUs whose available quantity has dropped below your set reorder threshold.

### list_fulfillment_orders
Retrieves a list of all fulfillment orders, including their current status and system IDs.

### list_customer_returns
Lists all Return Merchandise Authorizations (RMAs), showing return reasons and credit processing info.

### list_recent_shipments
Returns a collection of recently processed shipments, including carrier info and departure timestamps.

### search_orders_by_keyword
Finds fulfillment records using a keyword matched against customer names or order references.

## Prompt Examples

**Prompt:** 
```
List all fulfillment orders that are 'Awaiting Shipment'.
```

**Response:** 
```
I've found 15 orders awaiting shipment, including 'Order #EF123' and 'Order #EF124'. Most are scheduled to ship later today. Would you like to see the SKU breakdown for these orders?
```

**Prompt:** 
```
What is the inventory status for SKU 'WR-9988'?
```

**Response:** 
```
SKU 'WR-9988' currently has 45 units in stock at the Fremont facility and 12 units at the Kentucky facility. There are 5 units reserved for pending orders. Should I check if there are any inbound shipments for this SKU?
```

**Prompt:** 
```
Show me the tracking details for shipment 'SHP-1001'.
```

**Response:** 
```
Shipment 'SHP-1001' was shipped via UPS Ground on June 12th. The current status is 'Out for Delivery' in Chicago, IL. The estimated arrival is by 5:00 PM today. Would you like the tracking link?
```

## Capabilities

### Check current stock levels
You can get a detailed breakdown of available inventory for specific SKUs or across entire warehouses.

### Track shipments end-to-end
Find carrier details, estimate delivery dates, and confirm proof of delivery for any shipment ID.

### View order history and status
List all fulfillment orders or search for specific records by customer name or reference number.

### Monitor returns processing
Retrieve a list of processed and pending customer return merchandise authorizations (RMAs).

### Identify inventory gaps
Automatically pinpoint SKUs that have fallen below their reorder point or are awaiting shipment.

## Use Cases

### An agent needs to prepare a customer for peak season.
A manager asks the agent: 'What's our readiness?' The agent runs `list_low_stock_items` and `get_sku_inventory_status`. It replies with a list of 12 items below reorder point, allowing the team to prioritize immediate purchases before the rush.

### A customer calls about a missing package.
The support agent asks the agent: 'Track SHP-900.' The system runs `get_shipment_details` and replies with the carrier, current location (e.g., 'Out for Delivery in Miami'), and ETA, solving the problem instantly.

### Investigating a historical order issue.
A developer asks: 'Find all orders from last month involving Acme Corp.' The agent uses `search_orders_by_keyword` to isolate specific fulfillment records and then calls `get_order_details` for the full audit trail.

## Benefits

- Instantly check stock levels. Instead of guessing if you have enough inventory, use `get_sku_inventory_status` to confirm available units and their exact warehouse location before confirming a sale.
- Never miss an order update. Use `list_fulfillment_orders` or `search_orders_by_keyword` to pull up the status of any open order instantly, saving time spent cross-referencing internal systems.
- Handle returns faster. When a customer asks about a return, use `list_customer_returns` to see the RMA status and credit processing details without asking them for an account number first.
- Plan inventory proactively. Run a check using `list_low_stock_items` to see exactly which SKUs need reordering before they run out, letting you manage purchasing cycles better.
- Know where everything is. Need to know what shipped yesterday? Use `list_recent_shipments` or `get_shipment_details` for immediate tracking and carrier updates.

## How It Works

The bottom line is that it turns complex API lookups into simple conversational questions.

1. Connect the DCL Logistics MCP to your AI client and authorize it using your API key.
2. Ask your agent a question, like 'Check inventory for SKU X' or 'List all pending orders.'
3. The MCP executes the necessary tool calls, retrieves raw data from the system, and presents you with an actionable summary.

## Frequently Asked Questions

**How do I check stock using get_sku_inventory_status?**
You give the agent the SKU and ask for its status. The system returns a detailed breakdown, showing not just the total count, but also which warehouse holds how many units and if any are reserved.

**What is the difference between list_fulfillment_orders and search_orders_by_keyword?**
Use `list_fulfillment_orders` when you want a general overview of all open orders. Use `search_orders_by_keyword` when you know part of the information—like a customer name or order reference number—and need to narrow down specific records.

**Can I track multiple shipments at once?**
You can list recent movements using `list_recent_shipments`. To check specific ones, you must use `get_shipment_details` and provide the tracking ID for each shipment.

**Does get_account_details help with inventory?**
No. `get_account_details` only pulls metadata about your corporate account, like your service tier or assigned warehouses. For stock levels, you need the dedicated `list_warehouse_inventory` tool.

**How do I use list_customer_returns to check the status and credit information for an RMA?**
You get a comprehensive list of Return Merchandise Authorizations (RMAs). This tool shows not just if a return was received, but also its current processing status, including reasons for returns and details on any pending credit processing.

**What information does get_order_details provide regarding the full audit trail of an order?**
It provides the complete history for a specific order. Beyond just line items and addresses, you can see the entire audit trail, documenting every event that occurred during the order's fulfillment cycle.

**When should I use list_low_stock_items instead of get_sku_inventory_status?**
Use this when you need to proactively identify items below a predefined reorder point. While `get_sku_inventory_status` tells you the current count, `list_low_stock_items` flags SKUs needing attention based on set thresholds.

**What is the purpose of get_account_details when setting up the DCL Logistics connection?**
This tool retrieves essential metadata about your account, including your company name, active service tier, and which warehouses are assigned to you. It confirms the scope and setup parameters for all subsequent operations.

**How do I get a DCL Logistics API Key?**
Log in to your DCL Logistics eFactory portal and navigate to the API settings or Integrations section to generate your API Key and find your Account ID.

**Is inventory data real-time?**
Yes, this integration retrieves real-time stock levels directly from DCL warehouse management systems, providing accurate data for your planning.

**Can the agent process new RMAs?**
This integration currently focuses on monitoring existing orders, shipments, and returns. Initiating new fulfillment orders or RMAs should be handled via the eFactory dashboard.