# Order Desk MCP

> Order Desk MCP connects your AI agent directly to complex e-commerce operations. Manage orders and inventory across every sales channel—Shopify, Amazon, etc.—without switching apps or writing code. It gives you full control over fulfillment orchestration right from your chat window.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** order-management, orderdesk, inventory-api, shipping-automation, fulfillment-orchestration, multichannel-ecommerce, order-tracking, mcp

## Description

Managing modern e-commerce means juggling dozens of data points: order status in Shopify, stock levels on a separate system, and tracking numbers from FedEx. This MCP lets your AI agent do that heavy lifting for you. You talk naturally to your client—'What orders were placed yesterday, and are they ready to ship?'—and it handles the complexity across multiple connected sales channels. It pulls order metadata, checks inventory, and even adds shipment records, all in one chat session. Instead of logging into three different dashboards just to get a status update, you keep everything centralized within your preferred AI client, accessing this power through Vinkius. It’s like having an operations manager sitting right next to you, ready to execute on anything from listing historical order summaries to updating stock counts instantly.

## Tools

### create_store_order
Generates a completely new order record in the system.

### create_order_shipment
Adds specific shipment details to an existing customer order.

### delete_store_order
Removes a specified order from the store records.

### get_inventory_item
Retrieves detailed information for one specific product SKU.

### get_order_details
Fetches all known details about a single customer order.

### list_inventory_items
Returns a full list of available inventory items and their current stock status.

### list_order_items
Shows all the individual products and quantities purchased within one specific order.

### list_store_orders
Provides a summary list of multiple orders placed at the store.

### list_order_shipments
Lists all known shipment records associated with a single order number.

### test_orderdesk_connection
Verifies that the API connection to the Order Desk platform is working correctly.

### update_store_order
Modifies details of an existing order, such as changing its status or adding metadata.

## Prompt Examples

**Prompt:** 
```
List all active orders in Order Desk.
```

**Response:** 
```
I've retrieved your orders. You have 15 active shipments across your channels. Notable recent orders include #1234 from Shopify and #5678 from Amazon. Which one would you like to see details for?
```

**Prompt:** 
```
Show me all orders placed today and their current fulfillment status.
```

**Response:** 
```
You have 23 orders placed today. 8 are in Processing status, 11 have been Shipped (tracking numbers available), 2 are On Hold awaiting payment confirmation, and 2 are in Partial Fulfillment. Total revenue today: $4,287.50. The largest order is #ORD-9847 for $892 containing 6 line items.
```

**Prompt:** 
```
Check the inventory levels for SKU WIDGET-PRO-BLK and update the stock count to 250.
```

**Response:** 
```
SKU WIDGET-PRO-BLK ("Widget Pro Black Edition") found. Previous stock: 47 units. I have updated the inventory count to 250 units. The item is mapped to 3 active sales channels and has a reorder point set at 25 units. Last shipment received: May 5th (200 units from supplier Acme Widgets).
```

## Capabilities

### Check and update product inventory
List all available products or modify specific stock levels across your entire catalog.

### View and modify customer orders
Retrieve complete details for any order, list line items, or even create a brand new store order record.

### Track and manage shipments
Add tracking numbers to existing orders or get lists of all expected outgoing shipments.

### Update custom order data
Access and modify specific, non-standard data fields attached to an order record.

## Use Cases

### Handling a last-minute fulfillment request
A customer service rep needs to know if a high-value order (#1234) is ready. They ask their agent, and it uses get_order_details combined with list_order_shipments to confirm that the shipment was created and provide the tracking number immediately.

### Performing end-of-day inventory audit
The operations lead needs to check if any product is running low. They run a query using list_inventory_items, identify SKU WIDGET-PRO-BLK has low stock, and then use get_inventory_item to confirm the exact count for reordering.

### Onboarding a new sales channel
A merchant just started selling on Etsy. They ask their agent to list all store orders, verifying that the MCP correctly incorporates data from the new channel alongside existing ones, ensuring no order is missed.

### Correcting an incorrect order detail
An employee realizes a crucial custom field was forgotten on an old order. They use update_store_order to patch the specific metadata directly onto the record without changing any other details.

## Benefits

- Never check an order status dashboard again. You can list store orders or use get_order_details to pull any customer's full history, regardless of which sales channel they bought from.
- Keep stock levels accurate instantly. Use list_inventory_items and then get_inventory_item to verify product availability before promising delivery dates, preventing oversells.
- Automate shipping updates entirely through chat. You can call create_order_shipment or list_order_shipments to add tracking numbers and keep customers informed without manual data entry.
- Handle unexpected changes gracefully. If an order needs modification after it’s placed, you can use update_store_order instead of having to manually delete and recreate the record.
- Build smarter workflows with Vinkius. By connecting this MCP through Vinkius, your agent becomes a single pane of glass for all e-commerce data, whether that's listing orders or checking custom field metadata.

## How It Works

The bottom line is you tell your agent the goal; it handles the complex workflow across every e-commerce system needed to get the answer.

1. Subscribe to this MCP by providing your unique Order Desk Store ID and API Key.
2. Connect these credentials to your AI client (Claude, Cursor, etc.).
3. Tell your agent what you need—for example, 'List all orders that were placed on Amazon last week.' The agent then executes the necessary calls.

## Frequently Asked Questions

**How do I verify if the Order Desk MCP is connected?**
Run the test_orderdesk_connection tool. It verifies the API keys and credentials, letting you know right away if your connection is live or if there's a setup issue.

**Can I update inventory levels using Order Desk MCP?**
Yes, absolutely. Use list_inventory_items to see the current stock count, and then use get_inventory_item to manually adjust or confirm specific product quantities.

**What is the difference between creating an order and updating one?**
Use create_store_order when a brand new sale happens. Use update_store_order if the order already exists but needs changes, like adding metadata or modifying shipping details.

**Does Order Desk MCP handle multiple sales channels?**
Yes. It is designed to pull and manage data from various e-commerce sources, ensuring you see a unified view of all orders placed across your platforms.

**How do I add tracking information using the Order Desk MCP?**
You can use create_order_shipment or list_order_shipments. This allows you to attach necessary shipping records and numbers directly to an existing order record via conversation.

**Can my AI automatically find the details for a specific order by its ID?**
Yes! Use the `get_order` tool with the Order ID. Your agent will respond with complete metadata for the record, including customer information, items, and status in seconds.

**How do I find my Order Desk Store ID and API Key?**
Log in to your Order Desk store, navigate to **Store Settings** > **API**, and you will find your unique Store ID and generate your secret API key there.

**Can I update inventory levels using the AI?**
Absolutely. Use the `update_inventory` tool. Provide the Inventory Item ID and the new stock quantity, and the agent will sync the update to Order Desk immediately.