Linnworks MCP by usefulapi
REMOTE · LINNWORKS.USEFULAPI.IO
Read Linnworks inventory, stock and orders; set stock levels and add order notes.
Available components
Last scanned (5 hours ago)
Scores higher than 47% of remote servers
Reachable. Last reached 25 Oct 2026.
Category E-commerce
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security78
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
- HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
- The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability0
- Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly. See how to fix → View diagnostics → Fail
Schema Quality & AI Usability83
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 2015 tokens (~118/item across 17 items; 17 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management13
- Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 17 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 18 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities60
- Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. See how to fix → Fail
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 24 Oct 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 1.4.0 → 1.5.0 functional
- Server version: 1.3.0 → 1.4.0 functional
- Server version: 1.1.0 → 1.3.0 functional
- 23 Oct 26 +1
- Server version: 1.0.1 → 1.1.0 functional
- 22 Oct 26 0
- Stability: unverified → 0.03 ▲ functional
- Server version: 1.0.0 → 1.0.1 functional
- 21 Oct 26 63
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 25 Oct 2026 · Probed https://linnworks.usefulapi.io/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=usefulapi.io | CN=WE1,O=Google Trust Services,C=US | 13 Sept 2026 | 12 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | d9be3287b0fde9630e825ba1f79bff3f |
| SANs: usefulapi.io, *.usefulapi.io | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of linnworks.usefulapi.io. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| io. | present | 38690, 57355 | 8, 8 | Verified |
| usefulapi.io. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 302 |
WWW-Authenticate challenge Bearer realm="OAuth", resource_metadata="https://linnworks.usefulapi.io/.well-known/oauth-protected-resource/mcp"
Bearer realm="OAuth", resource_metadata="https://linnworks.usefulapi.io/.well-known/oauth-protected-resource/mcp"Protected resource metadata
| Document | https://linnworks.usefulapi.io/.well-known/oauth-protected-resource/mcp |
|---|---|
| Retrieved | Yes |
| Resource | https://linnworks.usefulapi.io/mcp |
| Authorisation server | https://linnworks.usefulapi.io |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://linnworks.usefulapi.io/mcp | Redirected | 302 | https://usefulapi.io/linnworks/ |
| http (plaintext) | http://linnworks.usefulapi.io/mcp | Inconclusive | 302 | http://linnworks.usefulapi.io/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
linnworks_add_order_note Add order note ~104
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.
| Name | Type | Req | Description |
|---|---|---|---|
| internal | boolean | – | Internal note (default true). |
| note | string | yes | The note text. |
| order_id | string | yes | The order id (OrderId / pkOrderId). |
No output schema declared.
No examples provided.
linnworks_find_order_by_number Find order by order number ~74
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.
| Name | Type | Req | Description |
|---|---|---|---|
| order_number | integer | yes | The numeric Linnworks order number (NumOrderId). |
No output schema declared.
No examples provided.
linnworks_find_orders_by_reference Find orders by channel reference ~69
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.
| Name | Type | Req | Description |
|---|---|---|---|
| reference | string | yes | The reference number or secondary reference to look for. |
No output schema declared.
No examples provided.
linnworks_get_inventory_item Get inventory item ~85
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.
| Name | Type | Req | Description |
|---|---|---|---|
| stock_item_id | string | yes | The stock item id (StockItemId) from linnworks_search_inventory. |
No output schema declared.
No examples provided.
linnworks_get_open_orders_details Get open order details ~117
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.
| Name | Type | Req | Description |
|---|---|---|---|
| include | array | – | Limit the optional parts loaded (default: all of them). |
| order_ids | array | yes | Order ids (OrderId, a GUID) from linnworks_list_open_orders. |
No output schema declared.
No examples provided.
linnworks_get_order Get order ~66
One order, open or processed, by its order id (a GUID): general info, shipping, customer, totals, items, notes. GET /api/Orders/GetOrderById.
| Name | Type | Req | Description |
|---|---|---|---|
| order_id | string | yes | The order id (OrderId / pkOrderId). |
No output schema declared.
No examples provided.
linnworks_get_order_notes Get order notes ~56
The notes on an order (text, internal or external, who wrote them and when). GET /api/Orders/GetOrderNotes.
| Name | Type | Req | Description |
|---|---|---|---|
| order_id | string | yes | The order id (OrderId / pkOrderId). |
No output schema declared.
No examples provided.
linnworks_get_stock_history Get stock change history ~141
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.
| Name | Type | Req | Description |
|---|---|---|---|
| location_id | string | – | Limit to one stock location (default: all locations combined). |
| page | integer | – | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | – | Results per page, 1-100 (default 25). |
| stock_item_id | string | yes | The stock item id (StockItemId). |
No output schema declared.
No examples provided.
linnworks_get_stock_levels Get stock levels ~78
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.
| Name | Type | Req | Description |
|---|---|---|---|
| stock_item_id | string | yes | The stock item id (StockItemId) from linnworks_search_inventory. |
No output schema declared.
No examples provided.
linnworks_list_categories List categories ~27
List the product categories (id and name). GET /api/Inventory/GetCategories.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
linnworks_list_open_orders List open orders ~190
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.
| Name | Type | Req | Description |
|---|---|---|---|
| location_id | string | – | Fulfilment location id from linnworks_list_stock_locations (default: the account's default location). |
| page | integer | – | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | – | Results per page, 1-100 (default 25). |
| received_from | string | – | Only orders received on or after this date. |
| received_to | string | – | Only orders received on or before this date. |
| text_filters | array | – | All filters must match. |
No output schema declared.
No examples provided.
linnworks_list_postal_services List postal services ~42
List the postal (shipping) services with their courier vendor, tracking and weight requirements and linked channels. GET /api/PostalServices/GetPostalServices.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
linnworks_list_stock_locations List stock locations ~62
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
linnworks_list_suppliers List suppliers ~39
List the suppliers: id, name, contact, address, email, web page and currency. GET /api/Inventory/GetSuppliers.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
linnworks_search_inventory Search inventory ~201
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.
| Name | Type | Req | Description |
|---|---|---|---|
| include | array | – | Extra data to load per item (default: StockLevels). |
| include_composite_parents | boolean | – | Include composite (bundle) parent items (default true). |
| include_variation_parents | boolean | – | Include variation parent items (default true). |
| keyword | string | – | Text to search for (SKU, title or barcode). Empty = list items. |
| page | integer | – | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | – | Results per page, 1-100 (default 25). |
| search_in | array | – | Fields to search (default: SKU, Title and Barcode). |
No output schema declared.
No examples provided.
linnworks_search_processed_orders Search processed orders ~270
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.
| Name | Type | Req | Description |
|---|---|---|---|
| date_from | string | – | Start of the range (needs date_type other than ALLDATES). |
| date_to | string | – | End of the range. |
| date_type | string | – | Which date the range applies to (default ALLDATES = no range). |
| exact_match | boolean | – | Exact match (default false: partial match over the last 3 months). |
| page | integer | – | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| per_page | integer | – | Results per page, 1-200 (default 25). |
| search_field | string | yes | What to search by: nOrderId (order number), o.PostalTrackingNumber, ReferenceNum, CustomerName, o.cEmailAddress, o.cPostCode, ShippingAddress, SKU (SKU or barcode), Source, SubSource. |
| search_term | string | yes | The text to search for. |
No output schema declared.
No examples provided.
linnworks_set_stock_level Set stock level ~121
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.
| Name | Type | Req | Description |
|---|---|---|---|
| level | integer | yes | The new stock level (units, 0 or more). |
| location_id | string | yes | The stock location id from linnworks_list_stock_locations. |
| sku | string | yes | The product SKU (ItemNumber). |
No output schema declared.
No examples provided.
How do I install the Linnworks MCP by usefulapi server?
Linnworks MCP by usefulapi is a hosted endpoint at https://linnworks.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · linnworks.usefulapi.io
claude mcp add --transport http io-usefulapi-linnworks 'https://linnworks.usefulapi.io/mcp'
What is the Linnworks MCP by usefulapi server?
Linnworks MCP by usefulapi is listed in the public MCP registry as io.usefulapi/linnworks. Read Linnworks inventory, stock and orders; set stock levels and add order notes. This page covers its hosted endpoint (https://linnworks.usefulapi.io/mcp).
Is the Linnworks MCP by usefulapi server safe to use?
Linnworks MCP by usefulapi scores 64 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Linnworks MCP by usefulapi server expose?
Linnworks MCP by usefulapi exposes 17 tools: linnworks_list_stock_locations, linnworks_search_inventory, linnworks_get_inventory_item, linnworks_get_stock_levels, linnworks_get_stock_history, and 12 more. Their descriptions and schemas cost roughly 1,742 tokens of context every time the server is loaded.
Does the Linnworks MCP by usefulapi server require authentication?
Yes. Linnworks MCP by usefulapi asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.
Is the Linnworks MCP by usefulapi server still maintained?
Linnworks MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 25 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.