Linnworks MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.20.5更新於 Nov 8, 2026

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

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

面向 Linnworks 的託管 MCP 伺服器:讓助理搜尋商品、讀取庫存與庫存異動歷史、查詢訂單,並可設定庫存數量或新增訂單備註。

可以做什麼
  • 列出庫存地點、商品分類、供應商與郵寄服務
  • 搜尋商品目錄並讀取單一商品的詳細資料
  • 讀取各地點庫存數量與庫存異動歷史
  • 列出未處理訂單、讀取未處理訂單詳情,並依訂單 ID、訂單編號或通路參考編號查找訂單
  • 搜尋已處理訂單並讀取訂單備註
  • 寫入:設定某商品在某地點的庫存數量,新增內部或外部訂單備註
適用情境
適合在 Linnworks 中工作、希望助理在對話中回答庫存與訂單問題的人,例如今天有哪些未處理訂單仍待出貨、某 SKU 在各倉庫的庫存量,偶爾也用於修正庫存數量或為訂單加註。
執行需求
遠端端點 linnworks.usefulapi.io/mcp,無需本機安裝。透過 OAuth 登入,登入頁要求填寫在 Linnworks 開發者入口網站建立的 System Integration 應用程式之 Application Id、Application Secret 與安裝權杖。用戶端設定只填 URL,不要加入 Authorization 標頭或 API 金鑰。免費方案每月 50 次工具呼叫;付費方案依每個 Linnworks 應用程式安裝計費。
安裝前請注意
有兩個工具會變更資料:設定庫存數量會覆寫目前數量並同步到該商品所在的銷售通路;新增訂單備註每次呼叫都會新增一筆,外部備註可能被傳送到銷售通路。執行寫入工具前應先確認。Linnworks 憑證在託管登入頁輸入,由服務方處理。付費方案透過 Stripe Checkout 付款,取消後當期不退款;用量依工具呼叫次數計算。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Linnworks MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Flinnworks/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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.

來源:servers/linnworks/README.md,提交 4046075

工具

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.

無需輸入參數。

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.

輸入參數pageincludekeywordper_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.

輸入參數stock_item_id必填

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.

輸入參數stock_item_id必填

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.

輸入參數pageper_pagelocation_idstock_item_id必填

linnworks_list_categories

List categories

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

無需輸入參數。

linnworks_list_suppliers

List suppliers

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

無需輸入參數。

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.

輸入參數pageper_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.

輸入參數includeorder_ids必填

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.

輸入參數order_id必填

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.

輸入參數order_number必填

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.

輸入參數reference必填

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.

輸入參數pagedate_toper_pagedate_fromdate_typeexact_matchsearch_term必填search_field必填

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.

輸入參數order_id必填

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.

無需輸入參數。

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.

輸入參數sku必填level必填location_id必填

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.

輸入參數note必填internalorder_id必填

版本歷史

18
  1. v1.20.4Nov 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

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合