# Deck Commerce MCP MCP

> Deck Commerce manages order fulfillment, inventory levels, and shipment tracking for e-commerce businesses. Connect your AI agent to manage customer orders, check real-time stock across multiple nodes, monitor returns, and track shipments—all through conversation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** omnichannel, retail-operations, order-fulfillment, inventory-tracking, returns-management, d2c

## Description

This MCP hooks up directly with Deck Commerce, the kind of system retailers use to handle everything from taking an order to getting it into a customer's hands. Instead of hopping between dashboards or manually checking APIs for every status update, your agent handles all that heavy lifting. You can ask it to list out all pending orders, pull the current stock level for any SKU across all facilities, and even track exactly where a package is right now. It makes managing complex e-commerce logistics feel as easy as talking to a coworker. When you connect this MCP through Vinkius, your AI client gets instant access to core operations data, letting you focus on selling stuff instead of managing spreadsheets. You'll know the status of orders and inventory immediately.

## Tools

### get_account_metadata
Retrieves general information about your Deck Commerce account, like the organization name and current setup settings.

### get_sku_stock_level
Returns precise quantities available for one specific SKU across all different fulfillment nodes.

### get_order_details
Gets deep details on one specific order, including line items, tax info, and shipping addresses.

### get_shipment_tracking
Provides the latest carrier status updates, estimated delivery time, and current shipment location for a package.

### list_backordered_items
Identifies all products that are currently selling faster than they can be stocked right now.

### list_available_inventory
Gives a full list of SKUs, detailing total sellable, on-hand, and reserved stock across the whole system.

### list_oms_orders
Returns a list of order metadata, including the order number, current status, and who placed it.

### list_order_returns
Lists all customer return requests, showing the reason for the return and its processing state.

### list_processed_shipments
Gathers metadata on every shipment processed by Deck Commerce, including carrier data and timestamps.

### search_orders_by_number
Finds specific orders using keywords from the order number, customer name, or email address.

## Prompt Examples

**Prompt:** 
```
List all customer orders from today that are 'Pending'.
```

**Response:** 
```
I've found 8 pending orders from today, including 'Order #DC123' and 'Order #DC124'. All are awaiting inventory verification. Would you like to see the items in the largest pending order?
```

**Prompt:** 
```
What is the stock level for 'Blue Runner Shoes' (SKU: RUN-99)?
```

**Response:** 
```
The SKU 'RUN-99' (Blue Runner Shoes) currently has 45 units available across all facilities. 30 units are in the 'Main Node' and 15 are in 'Regional Node 2'. Should I check if there are any backorders for this SKU?
```

**Prompt:** 
```
Show me the tracking info for Order #DC123.
```

**Response:** 
```
Order #DC123 was shipped via FedEx on June 12th. The tracking number is 1234567890. The current status is 'Delivered' in New York, NY. Would you like the full shipment history?
```

## Capabilities

### Check order details
It pulls comprehensive information for a specific customer order, including addresses and tax info.

### Track package location
The agent resolves carrier updates, estimates delivery dates, and pinpoints the current shipment location.

### View stock levels by item
You get a detailed breakdown of how many units are available for an SKU at different fulfillment sites.

### List all inventory items
It returns a complete list, showing the total on-hand, reserved, and sellable quantities across every node.

### Identify backordered goods
The agent lists specific products where demand is higher than available stock.

## Use Cases

### The customer calls asking about a shipment delay.
Instead of reading vague updates, your agent uses `get_shipment_tracking`. It finds the order number and tells the customer exactly what carrier is doing and when to expect it.

### A sales rep needs to quote a large B2B client on stock.
They ask the agent for `list_available_inventory`. The MCP immediately returns total quantities across all nodes, letting them give an accurate answer right away.

### The warehouse manager is preparing for peak season and needs a full count.
He runs `list_oms_orders` to see the volume of pending orders and then uses `get_order_details` on a sample order to validate fulfillment requirements.

### A team member suspects an item is missing from inventory records.
They run `list_available_inventory`, cross-reference the data, and if necessary, use `get_account_metadata` to check system configurations for discrepancies.

## Benefits

- Saves time on tracking. Instead of manually checking a carrier website, you ask the agent for `get_shipment_tracking` and get the status instantly.
- Instant stock visibility: Need to know if you can sell it? Use `list_available_inventory` to see total counts or check one item with `get_sku_stock_level` in seconds.
- Better customer support. When a customer calls about an order, your agent uses `search_orders_by_number` and `get_order_details` to pull up all history without you lifting a finger.
- Fulfillment planning is faster. You can run `list_backordered_items` to immediately see which products are causing bottlenecks before they become emergencies.
- Handles returns easily. Instead of digging through invoices, the agent runs `list_order_returns` and tells you exactly where that return stands.

## How It Works

The bottom line is that your AI client turns complex e-commerce API calls into simple questions you ask it.

1. First, connect this MCP to your AI client in Vinkius and authenticate using your Deck Commerce API Key and Site ID.
2. Next, prompt your agent with a specific request, like 'What's the stock for SKU 123?' or 'List all pending orders.'
3. The agent executes the required tool call, pulls the raw data from Deck Commerce, and presents you with a clear, natural language answer.

## Frequently Asked Questions

**How do I check order details using get_order_details?**
You simply tell your agent to 'get the details for Order #DC123.' The tool resolves all line items, tax info, and shipping addresses in one go.

**Can I find out what's backordered using list_backordered_items?**
Yes. Running `list_backordered_items` shows you exactly which products have demand higher than current stock, letting you prioritize restocking efforts immediately.

**What is the difference between getting order details and searching orders by number?**
`search_orders_by_number` finds records using keywords (like a name or partial number). `get_order_details` pulls all the granular information for a specific order you already found.

**Does get_sku_stock_level show total inventory?**
No, it is more precise. It shows the breakdown of quantities for one SKU at individual fulfillment nodes, which is better than just seeing the grand total.

**If I need to know the system settings before running any commands, how do I use `get_account_metadata`?**
It retrieves core account information like your organization name and active integrations. This tool confirms that all necessary setup data is available for your agent to connect with Deck Commerce.

**What's the best way to get a total inventory picture using `list_available_inventory`?**
This function returns a list of SKUs showing their aggregated quantities: available-to-sell, on-hand, and reserved across every location. It gives you the full scope of what you have in stock.

**If I'm looking for one specific order record, should I use `search_orders_by_number` instead of listing all orders with `list_oms_orders`?**
Yes. While `list_oms_orders` provides a full list of metadata, `search_orders_by_number` is much faster for targeting specific records using keywords like customer names or emails.

**How does the MCP handle tracking and managing product returns via `list_order_returns`?**
It compiles a list of all return requests, providing details on why they were returned and the current status. You can use this to monitor the full processing lifecycle right through your conversation.

**How do I get Deck Commerce API credentials?**
Log in to your Deck Commerce admin portal, navigate to the API settings or Integrations section to generate your API Key and find your Site ID.

**Can the agent check backordered items?**
Yes, you can use the list_backordered_items tool to identify which SKUs are currently on backorder and monitor their fulfillment status.

**Does the integration support tracking numbers?**
Yes, when retrieving shipment details, the agent provides carrier information and tracking numbers for your customer orders.