# Linnworks E-commerce Ops MCP

> Linnworks E-commerce Ops MCP lets your AI agent manage complex multi-channel inventory and orders. Pull real-time stock levels across every warehouse, audit pending shipments from Amazon or Shopify, and check product details by SKU—all without exporting CSV reports.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** multi-channel, sku-tracking, fulfillment, marketplace-integration, stock-levels, automation

## Description

Your agent connects directly to Linnworks, giving you full visibility over all your e-commerce operations. You stop juggling spreadsheets just to know where a product is or if an order shipped correctly. Instead, you talk to your AI client and get instant answers about everything from inventory levels across multiple physical warehouses to the status of open orders on Amazon, Shopify, or eBay. It's like having a dedicated ops specialist who lives inside your chat window. Because this MCP is hosted on Vinkius, your agent can access Linnworks data alongside thousands of tools in one place. You can audit everything needed for fulfillment—check which postal carriers you’re using, verify product attributes by SKU, and even review recent returns to keep track of refunds and supply chain gaps.

## Tools

### list_open_orders
Retrieves full details on all open orders, including customer info and item lines from your integrated marketplaces.

### get_inventory_item
Provides comprehensive product data for a specific SKU, detailing weight, category, and pricing information.

### get_stock_level
Reports real-time stock counts by item ID across all your designated physical locations.

### list_locations
Retrieves a list of every configured warehouse location, including its address and setup details.

### list_postal_services
Lists all active postal services, carriers, tracking features, and associated cost configurations you use.

### list_categories
Provides a hierarchy of product categories, helping you understand how your inventory is grouped for reporting.

### list_channels
Lists all active sales channels connected to Linnworks (like Amazon or Shopify) and their integration status.

### list_suppliers
Retrieves details on configured purchase order suppliers, including contact info and currency settings.

### list_returns
Gathers a record of recent returns over the last 30 days, detailing refund amounts and processing status.

### execute_custom_rpc
Allows you to run any specific custom API method exposed by Linnworks for specialized data requests.

## Prompt Examples

**Prompt:** 
```
List the last 10 open orders from Linnworks
```

**Response:** 
```
I've retrieved the latest 10 open orders. Highlights include Order #12345 (Amazon US, $45.00), Order #12346 (Shopify UK, £120.00), and Order #12347 (eBay DE, €15.50). All orders are currently in the 'Unprocessed' state. Would you like to see the item lines for any of these?
```

**Prompt:** 
```
Show me the stock levels for SKU 'CL-NV-001' across all locations
```

**Response:** 
```
Retrieving stock for SKU 'CL-NV-001' (ID: 98765-guid)… Main Warehouse: 45 available, Staging Area: 12 available, Retail Store: 2 available. Total across all locations: 59. There are 5 units currently in-order. Would you like to see the minimum quantity thresholds?
```

**Prompt:** 
```
What sales channels are currently connected to our account?
```

**Response:** 
```
I've identified 4 active sales channels: 1) Amazon (US Marketplace), 2) Shopify (Main Webstore), 3) eBay (Global), and 4) TikTok Shop (Beta). All integrations are showing 'Healthy' status. Would you like me to check the last sync time for the Shopify channel?
```

## Capabilities

### Track Open Shipments
Your agent compiles a list of all outstanding orders from your connected marketplaces, providing customer names and shipping details.

### Verify Product Details
You can check detailed information for any product using its exact SKU, including weight and category mapping required for listing accuracy.

### Check Multi-Site Stock Levels
The agent reports real-time stock counts by item across all your configured warehouses and virtual locations.

### Audit Logistics Setup
It lists every postal service, shipping method, and active sales channel connected to your account for a quick operational audit.

## Use Cases

### The Rush Order Check
A warehouse lead needs to know if three different items (SKU A, SKU B, and SKU C) are available for a rush order. They simply ask the agent. The agent uses `get_stock_level` multiple times and reports back: 'Item A has 12 units in Warehouse 1 and 5 in Warehouse 3. Item B is low at 2 units total.' This saves them from manually checking three separate location dashboards.

### The Inventory Audit
An e-commerce manager suspects a product listing needs weight updates across all channels. They ask the agent to verify the item data, which runs `get_inventory_item`. The agent confirms the correct weights and category IDs, allowing the manager to update listings quickly without leaving their primary workflow.

### The Fulfillment Gap Analysis
An operations coordinator needs to know if they can ship a custom product that requires specific packaging. They ask for shipping methods using `list_postal_services`. The agent reports the available carriers and cost structures, helping them select the most appropriate method instantly.

### The Return Reconciliation
A finance team member needs to reconcile recent refunds before month-end. They ask the agent for the last 30 days of returns using `list_returns`. The agent compiles a list showing return IDs, original order references, and total refund amounts in one place.

## Benefits

- Get immediate order status: Instead of logging into Amazon, Shopify, and eBay separately to list open shipments, your agent pulls all pending orders in one conversation using `list_open_orders`.
- Pinpoint inventory issues fast: Need to know if a specific SKU has enough stock for the week? Use `get_stock_level` to check units across every single warehouse location immediately.
- Keep product data accurate: Before listing an item, you can run `get_inventory_item` to verify required attributes like weight or category mapping, preventing listing errors.
- Manage supply chain health: Audit your entire network by checking configured suppliers via `list_suppliers` and reviewing recent returns with `list_returns`, giving you full visibility into refunds and reorders.
- Verify system connections: Use `list_channels` to ensure every sales platform is accounted for, confirming that your multichannel sync remains healthy without guesswork.

## How It Works

The bottom line is: Instead of clicking through multiple tabs and running separate reports, you chat with your agent and get consolidated answers about your entire e-commerce business.

1. First, you subscribe to this MCP and provide your Linnworks Server URL and API Token.
2. Next, you connect the MCP to your preferred AI client (Claude, Cursor, etc.) in Vinkius.
3. Finally, you simply ask your agent a question—like 'How many units of SKU X do we have at our main warehouse?'—and get the answer instantly.

## Frequently Asked Questions

**How do I check stock levels using the Linnworks E-commerce Ops MCP?**
You use the `get_stock_level` tool and provide the Item ID. Your agent reports available, in-order, due, and minimum quantities across all locations immediately.

**Can I list open orders using the Linnworks E-commerce Ops MCP?**
Yes, running `list_open_orders` retrieves detailed records for all pending shipments, including order IDs, customer details, and individual item lines from your marketplaces.

**What if I need to check multiple warehouses? Does the Linnworks E-commerce Ops MCP handle that?**
The `get_stock_level` tool retrieves stock counts across all configured physical locations, allowing you to compare inventory levels from a single query.

**Does the Linnworks E-commerce Ops MCP help with returns tracking?**
Yes, running `list_returns` gathers recent return data for the last 30 days. You get key details like refund amounts and original order references in one place.

**Is this only for Amazon orders? Can I use Linnworks E-commerce Ops MCP for Shopify?**
No, it handles multiple channels. Tools like `list_open_orders` pull data from all integrated marketplaces you manage through your account.