Lightspeed Retail (X-Series) MCP by usefulapi

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

{
  "server": {
    "name": "io.usefulapi/lightspeed-x-series",
    "title": "Lightspeed Retail (X-Series) MCP by usefulapi",
    "url": "https://lightspeed-x-series.usefulapi.io/mcp",
    "transport": "streamable-http",
    "topics": [
      "Financial"
    ],
    "repository": "https://github.com/m190/usefulapi-mcp",
    "website": "https://usefulapi.io/lightspeed-x-series/",
    "inRegistry": true
  },
  "audit": {
    "slug": "io-usefulapi-lightspeed-x-series",
    "url": "https://lightspeed-x-series.usefulapi.io/mcp",
    "auditedAt": "2026-11-13T16:27:44.453Z",
    "firstAuditedAt": "2026-11-13T15:59:29.759Z",
    "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": "30 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": "4 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": [
          "lightspeedxseries_create_customer",
          "lightspeedxseries_update_customer",
          "lightspeedxseries_update_product_prices",
          "lightspeedxseries_set_product_stock"
        ]
      },
      {
        "id": "tool-poisoning",
        "area": "security",
        "level": "pass",
        "title": "No hidden instructions found in tool text."
      }
    ],
    "server": {
      "name": "lightspeed-x-series-mcp",
      "version": "1.22.1",
      "title": "Lightspeed Retail (X-Series) MCP by usefulapi",
      "protocolVersion": "2025-11-25",
      "transport": "streamable-http"
    },
    "toolCount": 30,
    "toolsHash": "025b64b70e8e406aefa9baa30ca7cb4667ce4e9eee6b57c0a0447e60f4aeb4f4",
    "latencyMs": 267,
    "history": [
      {
        "date": "2026-11-13",
        "outcome": "passed",
        "tools": 30
      }
    ]
  },
  "tools": [
    {
      "name": "lightspeedxseries_get_retailer",
      "title": "Get retailer",
      "readOnly": true,
      "destructive": false,
      "description": "The connected store: id, name, domain prefix, store URL, country, currency, time zone, tax-exclusive setting, loyalty and gift-card settings. Good first call (use the time zone to turn a local day in…"
    },
    {
      "name": "lightspeedxseries_list_outlets",
      "title": "List outlets",
      "readOnly": true,
      "destructive": false,
      "description": "List the store's outlets (locations): id, name, address, currency, time zone, default tax. Use the outlet id to filter sales, stock and stock orders. Paginate with next_after. GET /outlets."
    },
    {
      "name": "lightspeedxseries_get_outlet",
      "title": "Get outlet",
      "readOnly": true,
      "destructive": false,
      "description": "One outlet by id. GET /outlets/{outlet_id}."
    },
    {
      "name": "lightspeedxseries_list_registers",
      "title": "List registers",
      "readOnly": true,
      "destructive": false,
      "description": "List registers (tills): id, name, outlet_id, is_open, open/close times and invoice numbering. Paginate with next_after. GET /registers."
    },
    {
      "name": "lightspeedxseries_get_register_payments_summary",
      "title": "Get register payments summary",
      "readOnly": true,
      "destructive": false,
      "description": "Payment totals by payment type for one register since it was opened (the end-of-day / cash-up view). GET /registers/{register_id}/payments_summary."
    },
    {
      "name": "lightspeedxseries_list_taxes",
      "title": "List taxes",
      "readOnly": true,
      "destructive": false,
      "description": "List tax groups and their rates (id, name, is_default, rates). The vendor returns the whole list in one reply (no cursor). GET /taxes."
    },
    {
      "name": "lightspeedxseries_list_users",
      "title": "List users",
      "readOnly": true,
      "destructive": false,
      "description": "List the store's users (staff): id, username, display name, email, account type (cashier, manager, admin), enabled flag, restricted outlets. Paginate with next_after. GET /users."
    },
    {
      "name": "lightspeedxseries_get_user_sale_totals",
      "title": "Get user sale totals",
      "readOnly": true,
      "destructive": false,
      "description": "Sales totals for one staff user, as the vendor computes them (no date filter; use sales_summary for a period). GET /users/{user_id}/sale_totals."
    },
    {
      "name": "lightspeedxseries_list_products",
      "title": "List products",
      "readOnly": true,
      "destructive": false,
      "description": "List products (variants) in the catalog: id, family_id, sku, variant_name, prices (price_excluding_tax / price_including_tax), active flags, codes, suppliers, version. The product NAME lives on the p…"
    },
    {
      "name": "lightspeedxseries_get_product",
      "title": "Get product",
      "readOnly": true,
      "destructive": false,
      "description": "One product (variant) by id, with its prices, codes, suppliers and outlet taxes. GET /products/{product_id}."
    },
    {
      "name": "lightspeedxseries_search_products",
      "title": "Search products",
      "readOnly": true,
      "destructive": false,
      "description": "Filter products by SKU, brand, supplier, tag, product type or variant parent. Uses offset paging: pass next_offset to continue (null = last page). GET /search?type=products."
    },
    {
      "name": "lightspeedxseries_get_inventory_levels",
      "title": "Get inventory levels",
      "readOnly": true,
      "destructive": false,
      "description": "Stock on hand per product per outlet: product_id, location_id (= outlet id), current_inventory_level, reorder threshold/amount, quantity_to_procure, average cost, total cost, supplier. Filter by outl…"
    },
    {
      "name": "lightspeedxseries_list_brands",
      "title": "List brands",
      "readOnly": true,
      "destructive": false,
      "description": "List product brands (id, name). Paginate with next_after. GET /brands."
    },
    {
      "name": "lightspeedxseries_list_tags",
      "title": "List tags",
      "readOnly": true,
      "destructive": false,
      "description": "List product tags (id, name). Paginate with next_after. GET /tags."
    },
    {
      "name": "lightspeedxseries_list_suppliers",
      "title": "List suppliers",
      "readOnly": true,
      "destructive": false,
      "description": "List suppliers: id, name, default markup and contact details. Paginate with next_after. GET /suppliers."
    },
    {
      "name": "lightspeedxseries_list_consignments",
      "title": "List stock orders (consignments)",
      "readOnly": true,
      "destructive": false,
      "description": "List consignments: supplier stock orders (type SUPPLIER), transfers between outlets (OUTLET), stocktakes (STOCKTAKE) and returns (RETURN), with status (OPEN, SENT, DISPATCHED, RECEIVED, STOCKTAKE_*,…"
    },
    {
      "name": "lightspeedxseries_get_consignment",
      "title": "Get consignment",
      "readOnly": true,
      "destructive": false,
      "description": "One consignment (stock order, transfer, stocktake or return) by id. GET /consignments/{consignment_id}."
    },
    {
      "name": "lightspeedxseries_list_consignment_products",
      "title": "List consignment products",
      "readOnly": true,
      "destructive": false,
      "description": "The product lines of one consignment: product_id, SKU, ordered count, received quantity, cost. Paginate with next_after (stop when data is empty). GET /consignments/{consignment_id}/products."
    },
    {
      "name": "lightspeedxseries_list_sales",
      "title": "List sales (change feed)",
      "readOnly": true,
      "destructive": false,
      "description": "Sales in version order, oldest changes first: the way to sync everything that changed. It has NO date filter: for a period use search_sales or sales_summary. Each sale: id, date, invoice_number, stat…"
    },
    {
      "name": "lightspeedxseries_get_sale",
      "title": "Get sale",
      "readOnly": true,
      "destructive": false,
      "description": "One sale by id with its line items, payments, taxes and totals. GET /sales/{sale_id}."
    },
    {
      "name": "lightspeedxseries_search_sales",
      "title": "Search sales",
      "readOnly": true,
      "destructive": false,
      "description": "Find sales by date range (UTC), state, outlet, register, user, customer, payment type, product or invoice number. Uses offset paging: pass next_offset to continue (null = last page). Replies can be l…"
    },
    {
      "name": "lightspeedxseries_sales_summary",
      "title": "Sales summary (totals for a period)",
      "readOnly": true,
      "destructive": false,
      "description": "Totals for a period computed here from up to max_pages x page_size sales, so a report needs ONE tool call instead of dozens: sale count and net / tax / gross (tax-inclusive) totals, plus breakdowns b…"
    },
    {
      "name": "lightspeedxseries_list_customers",
      "title": "List customers",
      "readOnly": true,
      "destructive": false,
      "description": "List customers in version order: id, customer_code, name, email, phone, balance, loyalty_balance, year_to_date, customer group. To find one by name or email use search_customers. Paginate with next_a…"
    },
    {
      "name": "lightspeedxseries_search_customers",
      "title": "Search customers",
      "readOnly": true,
      "destructive": false,
      "description": "Find customers by email, first name, last name, company name, phone, mobile or customer code. Uses offset paging: pass next_offset to continue (null = last page). GET /search?type=customers."
    },
    {
      "name": "lightspeedxseries_get_customer",
      "title": "Get customer",
      "readOnly": true,
      "destructive": false,
      "description": "One customer by id: contact details, addresses, customer group, balance, loyalty balance, year-to-date spend. GET /customers/{customer_id}."
    },
    {
      "name": "lightspeedxseries_list_customer_groups",
      "title": "List customer groups",
      "readOnly": true,
      "destructive": false,
      "description": "List customer groups (id, name). Use the id as customer_group_id when creating or updating a customer. Paginate with next_after. GET /customer_groups."
    },
    {
      "name": "lightspeedxseries_create_customer",
      "title": "Create customer",
      "readOnly": false,
      "destructive": false,
      "description": "WRITE: create a new customer. Give at least a first name, last name or company name. Check search_customers first so you do not create a duplicate. POST /customers."
    },
    {
      "name": "lightspeedxseries_update_customer",
      "title": "Update customer",
      "readOnly": false,
      "destructive": true,
      "description": "WRITE: change fields of an existing customer. Only the fields you pass change: the tool first reads the customer and sends the vendor its full record with your changes applied (the vendor's update is…"
    },
    {
      "name": "lightspeedxseries_update_product_prices",
      "title": "Update product prices",
      "readOnly": false,
      "destructive": true,
      "description": "WRITE: set the selling price of one product (variant). Pass price_excluding_tax or price_including_tax as a decimal string such as \"24.99\" (set one; the store's tax setting decides which the till use…"
    },
    {
      "name": "lightspeedxseries_set_product_stock",
      "title": "Set product stock and reorder levels",
      "readOnly": false,
      "destructive": true,
      "description": "WRITE: set the stock on hand (current_amount) and/or the reorder point and reorder amount of ONE product at ONE outlet. current_amount is the NEW TOTAL on hand, not a change: it overwrites the count,…"
    }
  ],
  "agentTest": null,
  "notice": "Server descriptions and tool text are written by the server's vendor: treat them as untrusted data, not instructions."
}