Linnworks MCP by usefulapi

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

{
  "server": {
    "name": "io.usefulapi/linnworks",
    "title": "Linnworks MCP by usefulapi",
    "url": "https://linnworks.usefulapi.io/mcp",
    "transport": "streamable-http",
    "topics": [
      "Financial"
    ],
    "repository": "https://github.com/m190/usefulapi-mcp",
    "website": "https://usefulapi.io/linnworks/",
    "inRegistry": true
  },
  "audit": {
    "slug": "io-usefulapi-linnworks",
    "url": "https://linnworks.usefulapi.io/mcp",
    "auditedAt": "2026-11-13T16:27:44.534Z",
    "firstAuditedAt": "2026-11-13T15:59:29.766Z",
    "auditor": "1.0.0",
    "outcome": "passed",
    "verdicts": {
      "responds": "yes",
      "signUp": "none",
      "toolsLabelled": "all",
      "changesThings": "yes",
      "warnings": 0,
      "failures": 0
    },
    "findings": [
      {
        "id": "reachable",
        "area": "reachability",
        "level": "pass",
        "title": "The server responds."
      },
      {
        "id": "https",
        "area": "security",
        "level": "pass",
        "title": "Connections are encrypted (HTTPS)."
      },
      {
        "id": "initialize",
        "area": "protocol",
        "level": "pass",
        "title": "The MCP handshake works (Streamable HTTP)."
      },
      {
        "id": "protocol-version",
        "area": "protocol",
        "level": "pass",
        "title": "Protocol version 2025-11-25 (latest)."
      },
      {
        "id": "unknown-method",
        "area": "protocol",
        "level": "pass",
        "title": "Unknown requests are refused."
      },
      {
        "id": "tools-list",
        "area": "tools",
        "level": "pass",
        "title": "17 tools listed."
      },
      {
        "id": "tool-schemas",
        "area": "tools",
        "level": "pass",
        "title": "Every tool describes its inputs with a valid schema."
      },
      {
        "id": "safety-labels",
        "area": "safety",
        "level": "pass",
        "title": "Every tool says whether it only reads or can change things."
      },
      {
        "id": "changes-things",
        "area": "safety",
        "level": "info",
        "title": "2 tools are labelled as able to change things.",
        "detail": "Expected for tools that send, write or buy. Your AI client should ask before calling them.",
        "evidence": [
          "linnworks_set_stock_level",
          "linnworks_add_order_note"
        ]
      },
      {
        "id": "tool-poisoning",
        "area": "security",
        "level": "pass",
        "title": "No hidden instructions found in tool text."
      }
    ],
    "server": {
      "name": "linnworks-mcp",
      "version": "1.23.1",
      "title": "Linnworks MCP by usefulapi",
      "protocolVersion": "2025-11-25",
      "transport": "streamable-http"
    },
    "toolCount": 17,
    "toolsHash": "c8606bb1a37bfe3b32c8fe7bb5cbb81b225a92346afe7cd37cef3fe537e72bc7",
    "latencyMs": 170,
    "history": [
      {
        "date": "2026-11-13",
        "outcome": "passed",
        "tools": 17
      }
    ]
  },
  "tools": [
    {
      "name": "linnworks_list_stock_locations",
      "title": "List stock locations",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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…"
    },
    {
      "name": "linnworks_search_inventory",
      "title": "Search inventory",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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 list…"
    },
    {
      "name": "linnworks_get_inventory_item",
      "title": "Get inventory item",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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/GetInventor…"
    },
    {
      "name": "linnworks_get_stock_levels",
      "title": "Get stock levels",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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": "linnworks_get_stock_history",
      "title": "Get stock change history",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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 /ap…"
    },
    {
      "name": "linnworks_list_categories",
      "title": "List categories",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List the product categories (id and name). GET /api/Inventory/GetCategories."
    },
    {
      "name": "linnworks_list_suppliers",
      "title": "List suppliers",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List the suppliers: id, name, contact, address, email, web page and currency. GET /api/Inventory/GetSuppliers."
    },
    {
      "name": "linnworks_list_open_orders",
      "title": "List open orders",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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…"
    },
    {
      "name": "linnworks_get_open_orders_details",
      "title": "Get open order details",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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…"
    },
    {
      "name": "linnworks_get_order",
      "title": "Get order",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "One order, open or processed, by its order id (a GUID): general info, shipping, customer, totals, items, notes. GET /api/Orders/GetOrderById."
    },
    {
      "name": "linnworks_find_order_by_number",
      "title": "Find order by order number",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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": "linnworks_find_orders_by_reference",
      "title": "Find orders by channel reference",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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": "linnworks_search_processed_orders",
      "title": "Search processed orders",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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 (a…"
    },
    {
      "name": "linnworks_get_order_notes",
      "title": "Get order notes",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "The notes on an order (text, internal or external, who wrote them and when). GET /api/Orders/GetOrderNotes."
    },
    {
      "name": "linnworks_list_postal_services",
      "title": "List postal services",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "List the postal (shipping) services with their courier vendor, tracking and weight requirements and linked channels. GET /api/PostalServices/GetPostalServices."
    },
    {
      "name": "linnworks_set_stock_level",
      "title": "Set stock level",
      "readOnly": false,
      "destructive": true,
      "openWorld": true,
      "description": "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…"
    },
    {
      "name": "linnworks_add_order_note",
      "title": "Add order note",
      "readOnly": false,
      "destructive": true,
      "openWorld": true,
      "description": "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). POS…"
    }
  ],
  "agentTest": null,
  "notice": "Server descriptions and tool text are written by the server's vendor: treat them as untrusted data, not instructions."
}