Linnworks MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.20.4Updated Nov 7, 2026

Read Linnworks inventory, stock and orders; set stock levels and add order notes.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for Linnworks: lets an assistant search inventory, read stock levels and history, look up orders, and set stock levels or add order notes.

What you can do
  • List stock locations, categories, suppliers and postal services
  • Search the product catalogue and read one item's details
  • Read stock levels per location and stock change history
  • List open orders, read open order details, and find orders by id, order number or channel reference
  • Search processed orders and read order notes
  • Write: set a product's stock level at a location and add internal or external order notes
When to use it
Useful when you work in Linnworks and want an assistant to answer stock and order questions in chat, such as which open orders are still waiting to be despatched or how much of a SKU sits in each warehouse, and occasionally to correct stock levels or annotate orders.
Requirements
Remote endpoint at linnworks.usefulapi.io/mcp; no local install. Sign-in is via OAuth, and the login page asks for the Application Id, Application Secret and installation token of a System Integration app created in the Linnworks Developer Portal. Add only the URL to the client config, with no Authorization header or API key. A free plan allows 50 tool calls per month; paid plans are billed per Linnworks app installation.
Before you install
Two tools change data: setting a stock level overwrites the current quantity and flows to the sales channels the item is listed on, and adding an order note is not idempotent and external notes may be passed to the sales channel. Confirm before running write tools. Linnworks credentials are entered on the hosted login page, so the provider handles them. Paid plans involve Stripe Checkout payments and no refund for the current period after cancelling; usage is metered per tool call.

Installation

In SourceWeft

  1. Open Linnworks MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Flinnworks/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "linnworks-by-usefulapi": {
      "type": "http",
      "url": "https://linnworks.usefulapi.io/mcp"
    }
  }
}

README

Linnworks MCP by usefulapi

Use Linnworks from Claude, Cursor, or any MCP client — search inventory, read stock levels and stock history per location, categories and suppliers, list open orders, search processed orders, read order details and notes, set stock levels and add order notes. Hosted, no local install: connect with the Application Id, Application Secret and installation token of a System Integration app that you create in the Linnworks Developer Portal.

Live endpoint: https://linnworks.usefulapi.io/mcp · Homepage: https://usefulapi.io/linnworks

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://linnworks.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http linnworks https://linnworks.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "linnworks": {      "url": "https://linnworks.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Linnworks credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/linnworks/

Tools

ToolTypeWhat it does
linnworks_list_stock_locationsreadList stock locations
linnworks_search_inventoryreadSearch inventory
linnworks_get_inventory_itemreadGet inventory item
linnworks_get_stock_levelsreadGet stock levels
linnworks_get_stock_historyreadGet stock change history
linnworks_list_categoriesreadList categories
linnworks_list_suppliersreadList suppliers
linnworks_list_open_ordersreadList open orders
linnworks_get_open_orders_detailsreadGet open order details
linnworks_get_orderreadGet order
linnworks_find_order_by_numberreadFind order by order number
linnworks_find_orders_by_referencereadFind orders by channel reference
linnworks_search_processed_ordersreadSearch processed orders
linnworks_get_order_notesreadGet order notes
linnworks_list_postal_servicesreadList postal services
linnworks_set_stock_levelwriteSet stock level
linnworks_add_order_notewriteAdd order note
linnworks_usage_statusmetaUsage status (free-tier meter)
linnworks_request_featuremetaRequest a missing feature
linnworks_upgrademetaUpgrade to Pro or Pro+
linnworks_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per Linnworks app installation)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with linnworks_upgrade (it returns a Stripe Checkout link). Cancel any time with linnworks_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running linnworks_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Linnworks.

Source: servers/linnworks/README.md at commit 4046075

Tools

17

linnworks_list_stock_locations

List stock locations

List the stock locations (warehouses, fulfilment centres) of the Linnworks account: id, name, address, whether it is a fulfilment centre. Use the ids as location_id in other tools. GET /api/Inventory/GetStockLocations.

Takes no parameters.

linnworks_search_inventory

Search inventory

Search the product catalogue by SKU, title or barcode and return the items with their stock levels per location (and optionally pricing, suppliers, images, extended properties). An empty keyword lists items. POST /api/Stock/GetStockItemsFull.

Parameterspageincludekeywordper_pagesearch_ininclude_composite_parentsinclude_variation_parents

linnworks_get_inventory_item

Get inventory item

One product by its stock item id: SKU (ItemNumber), title, barcode, quantities (in stock, in orders, due, available), prices, tax rate, category, dimensions and weight. GET /api/Inventory/GetInventoryItemById.

Parametersstock_item_idrequired

linnworks_get_stock_levels

Get stock levels

The stock level of one product at every location: in stock, in open orders, due on purchase orders, available, minimum level, unit cost and when it last changed. GET /api/Stock/GetStockLevel.

Parametersstock_item_idrequired

linnworks_get_stock_history

Get stock change history

The stock-level change history of one product (date, new level, change quantity, value, note), newest data first as Linnworks returns it; optionally for a single location, otherwise combined. GET /api/Stock/GetItemChangesHistory.

Parameterspageper_pagelocation_idstock_item_idrequired

linnworks_list_categories

List categories

List the product categories (id and name). GET /api/Inventory/GetCategories.

Takes no parameters.

linnworks_list_suppliers

List suppliers

List the suppliers: id, name, contact, address, email, web page and currency. GET /api/Inventory/GetSuppliers.

Takes no parameters.

linnworks_list_open_orders

List open orders

Page through the open (not yet processed) orders of a fulfilment location, with general info (status, reference, source, received date), shipping, customer, totals and items. Narrow with text filters (reference, customer, SKU ...) and a received-date range. POST /api/Orders/GetOpenOrders.

Parameterspageper_pagelocation_idreceived_totext_filtersreceived_from

linnworks_get_open_orders_details

Get open order details

Full details of open orders by their ids (up to 50): general info, shipping, customer, totals, items, folders, notes, identifiers, extended properties and bin racks. Pass include to load only some of the optional parts. Only works for open orders. POST /api/OpenOrders/GetOpenOrdersDetails.

Parametersincludeorder_idsrequired

linnworks_get_order

Get order

One order, open or processed, by its order id (a GUID): general info, shipping, customer, totals, items, notes. GET /api/Orders/GetOrderById.

Parametersorder_idrequired

linnworks_find_order_by_number

Find order by order number

Find one order, open or processed, by its Linnworks order number (the integer shown in the order book). Returns an empty order when none matches. GET /api/Orders/GetOrderDetailsByNumOrderId.

Parametersorder_numberrequired

linnworks_find_orders_by_reference

Find orders by channel reference

Find orders by their channel reference number (for example an Amazon or eBay order number) or secondary reference. Returns at most 50 orders. GET /api/Orders/GetOrderDetailsByReferenceId.

Parametersreferencerequired

linnworks_search_processed_orders

Search processed orders

Search processed (despatched) orders. Search by order number, tracking number, channel reference, customer name, email, postcode, address, SKU, source or sub-source, optionally within a date range (at most 3 months; a non-exact search covers only the last 3 months). POST /api/ProcessedOrders/SearchProcessedOrdersPaged.

Parameterspagedate_toper_pagedate_fromdate_typeexact_matchsearch_termrequiredsearch_fieldrequired

linnworks_get_order_notes

Get order notes

The notes on an order (text, internal or external, who wrote them and when). GET /api/Orders/GetOrderNotes.

Parametersorder_idrequired

linnworks_list_postal_services

List postal services

List the postal (shipping) services with their courier vendor, tracking and weight requirements and linked channels. GET /api/PostalServices/GetPostalServices.

Takes no parameters.

linnworks_set_stock_level

Set stock level

WRITE: set the stock level of one product (by SKU) at one location to an absolute quantity. This overwrites the current level and flows to the sales channels the item is listed on. Check the current level with linnworks_get_stock_levels first. POST /api/Stock/SetStockLevel.

Parametersskurequiredlevelrequiredlocation_idrequired

linnworks_add_order_note

Add order note

WRITE: add a note to an order (open or processed). Internal notes are visible only inside Linnworks; external notes may be passed to the sales channel. Adds a new note each call (not idempotent). POST /api/Orders/AddOrdersNote.

Parametersnoterequiredinternalorder_idrequired

Version history

18
  1. v1.20.4LatestNov 7, 2026
  2. v1.19.3Nov 5, 2026
  3. v1.19.2Nov 5, 2026
  4. v1.19.1Nov 4, 2026
  5. v1.19.0Nov 3, 2026
  6. v1.18.1Nov 3, 2026
  7. v1.17.0Nov 1, 2026
  8. v1.15.0Oct 31, 2026
  9. v1.14.0Oct 31, 2026
  10. v1.13.2Oct 30, 2026
  11. v1.13.0Oct 30, 2026
  12. v1.8.1Oct 26, 2026
  13. v1.5.3Oct 25, 2026
  14. v1.5.0Oct 25, 2026
  15. v1.4.0Oct 24, 2026
  16. v1.1.0Oct 23, 2026
  17. v1.0.1Oct 22, 2026
  18. v1.0.0Oct 21, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations