fb-image

Explore More Across Our Network

Linnworks MCP Server

Home || Linnworks MCP Server
Linnworks MCP Server

Linnworks MCP Server Connect AI to Linnworks Safely

Connect AI to Linnworks safely. Our Model Context Protocol (MCP) server turns the Linnworks API into 33 business-ready tools for stock, products, orders, sales, purchasing, warehouses and returns, with write access locked down by default.

Key Facts

Read Tools Available
0
Write Tools, Gated
0
Linnworks MCP tools
0
Linnworks MCP Server | On Screen Automation 1
Hyperstock AI | Linnworks AI Agent
Learn More

What is a Linnworks MCP server?

A Linnworks MCP server is a connector that lets AI assistants and agents use Linnworks data through a set of defined, permissioned tools.
MCP, the Model Context Protocol, is an open standard for connecting AI models to business systems. Instead of handing an AI raw API access, the MCP server exposes named actions such as get_low_stock_items or get_purchase_orders, each with a clear purpose and clear limits.
The AI chooses which tools to call, the server talks to Linnworks, and the results come back in a form the model can reason over. You decide which tools are switched on.

Full tool inventory

All 33 Linnworks MCP tools

The complete tool inventory, grouped by operational area. Write operations are marked and are not exposed to the Hyperstock AI chatbot.

Warehouses (3 tools)

1. get_locations: Lists warehouses and locations and resolves location names to IDs.
2. get_location_by_id: Details for one warehouse, including address and fulfilment-centre status.
3. get_stock_by_location: Stock quantity for a specific product at a specific warehouse.

Products (7 tools)

1. get_inventory_items: Searches products by SKU, title or barcode.
2. get_inventory_item_by_id: Full product detail: pricing, dimensions, tax and category.
3. resolve_skus: Converts SKUs into Linnworks stock item IDs.
4. get_inventory_count: Total number of inventory items.
5. get_categories: Product categories with item counts.
6. get_suppliers: Supplier details: contacts, country and currency.
7. get_supplier_terms: Supplier minimum order quantity, pack size and lead time.

Stock (8 tools)

1. get_stock_levels: Stock levels across all locations.
2. get_low_stock_items: Products that need replenishing.
3. get_stock_due: Incoming stock and expected arrival dates.
4. get_stock_consumption: Consumption, sales velocity and estimated stock cover.
5. get_stock_health: Flags zero or negative stock, missing suppliers, stock held nowhere, inactivity, incoming stock, oversold and below-minimum items.
6. get_dead_stock: Products with no sales and the capital tied up in them.
7. get_stock_movement_history: Stock movements and notes for a location.
8. update_stock_levels: Updates stock levels. Write operation, not exposed to the chatbot.

Orders (6 tools)

1. get_open_orders: Open orders, with sorting.
2. get_unfulfilled_orders: Orders awaiting fulfilment, with line items.
3. get_blocked_orders: Orders blocked by stock issues.
4. get_order_by_number: Order detail by human-readable order number.
5. get_order_by_id: Order detail by Linnworks order ID.
6. search_processed_orders: Historical processed orders with revenue and margin.

Sales (4 tools)

1. get_top_products: Top sellers by units or revenue.
2. get_item_sales_stats: SKU-level sales and margin by channel.
3. get_channel_performance: Sales performance by channel.
4. get_sales_trend: Sales trends over time.

Purchasing and aftersales (5 tools)

1. get_purchase_orders: Purchase orders with supplier, value and due date.
2. get_purchase_order_by_id: Full purchase order with line items.
3. create_purchase_order: Creates a purchase order. Write operation, not exposed to the chatbot.
4. get_returns: Returns and return reasons.
5. get_shipping_services: Configured shipping services and couriers.

MCP vs raw API

Why not just use the Linnworks API?

You can, and we build on it. But a raw API is built for developers, not for AI. Rishvi’s MCP layer adds what an AI needs to answer business questions reliably:

  • Business-level tools: “dead stock” or “blocked orders” is one call, not five endpoints and a join.
  • Built-in resolution: SKUs and warehouse names are resolved to Linnworks IDs automatically.
  • Analysis included: consumption, stock cover and stock health are calculated for the model.
  • Guardrails: write operations are separated and kept away from conversational AI.
Power build 2

FAQ's

Linnworks MCP: questions and answers

MCP, the Model Context Protocol, is an open standard for connecting AI models to external systems. An MCP server exposes named tools that an AI client can discover and call, each doing one defined job.
It is an MCP server built by Rishvi Ltd that connects AI to Linnworks through 33 tools covering warehouses, products, stock, orders, sales, purchasing and aftersales. 31 tools read data and 2 write data.
No. The Linnworks MCP server is built and supported by Rishvi Ltd, a Linnworks Certified Partner, using the Linnworks API. It works with your existing Linnworks account.
Only two tools can: update_stock_levels and create_purchase_order. They are not exposed to the Hyperstock AI chatbot and are only enabled for approved workflows you agree with us. All other tools are read-only.
Any AI client that supports the Model Context Protocol can connect, subject to your setup. The fastest route is Hyperstock AI, Rishvi’s ready-made assistant that already uses the server.
Warehouses and locations, products, categories, suppliers and supplier terms, stock levels, low stock, incoming stock, consumption, stock health, dead stock and stock movements. It also covers open, unfulfilled, blocked and processed orders, sales statistics, channel performance, purchase orders, returns and shipping services.
Yes. Rishvi has built Linnworks customisations for over 12 years, including more than 850 custom SQL scripts. We can add tools for your own reports, fields and workflows.
Contact Us
Contact Us

Give your AI safe, structured access to Linnworks

Rishvi’s Linnworks MCP server gives AI assistants and agents 33 tools for stock, orders, sales, purchasing, warehouses and returns, with write access locked down.
Talk to a Rishvi Linnworks specialist about connecting the MCP server, choosing tools or building custom ones.
Scroll to Top