Name: Lightspeed Retail (X-Series) MCP by usefulapi
Author: usefulapi

Lightspeed Retail (X-Series) MCP by usefulapi

Read Lightspeed X-Series products, stock, sales, customers, stock orders; one-call sales reports.

Tool-list grade A Remote · Streamable HTTP No auth needed 30 tools v1.18.3 MIT

No reviews yet by usefulapiGitHub The publisher’s own endpoint — this marketplace is not in the path

93/100

tool-list score

tools declared

remote

at its publisher

—

calls last 7d

What it does

Read Lightspeed X-Series products, stock, sales, customers, stock orders; one-call sales reports.

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --transport http lightspeed-retail-x-series-mcp-by-usefulapi https://lightspeed-x-series.usefulapi.io/mcp

# 2 — ask your agent for something these tools do
#   lightspeedxseries_get_retailer, lightspeedxseries_list_outlets, lightspeedxseries_get_outlet and 27 more

Lightspeed Retail (X-Series) MCP by usefulapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

usefulapi578 servers

25 categories

All 578 servers

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

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 into UTC for sales searches). GET /retailer.

No parameter schema on file.

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.

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).
deleted	boolean	no	true = include deleted records (default: active only).

One outlet by id. GET /outlets/{outlet_id}.

Parameter	Type	Required	Notes
outlet_id	string	yes	Outlet id (from list_outlets).

List registers (tills): id, name, outlet_id, is_open, open/close times and invoice numbering. Paginate with next_after. GET /registers.

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).
deleted	boolean	no	true = include deleted records (default: active only).

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.

Parameter	Type	Required	Notes
register_id	string	yes	Register id (from list_registers).

List tax groups and their rates (id, name, is_default, rates). The vendor returns the whole list in one reply (no cursor). GET /taxes.

No parameter schema on file.

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.

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).

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.

Parameter	Type	Required	Notes
user_id	string	yes	User id (from list_users).

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 product family: add includes=["families"] to get it. Paginate with next_after (stop when data is empty). With sku set, only that SKU is looked up and the other filters are ignored. For text/brand/suppli

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).
sku	string	no	Exact SKU (other filters are ignored when set).
includes	array	no	Related records to include. 'families' is required together with brands, categories, suppliers, tags, variant_attributes or customizations.

One product (variant) by id, with its prices, codes, suppliers and outlet taxes. GET /products/{product_id}.

Parameter	Type	Required	Notes
product_id	string	yes	Product id (from list_products).
includes	array	no	Related records to include. 'families' is required together with brands, categories, suppliers, tags, variant_attributes or customizations.

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.

Parameter	Type	Required	Notes
sku	string	no	SKU filter (sent in lowercase, as the vendor search requires).
brand_id	string	no	Brand id.
supplier_id	string	no	Supplier id.
tag_id	string	no	Tag id.
product_type_id	string	no	Product type id.
variant_parent_id	string	no	Only the variants of this parent product.
deleted	boolean	no	true = include deleted records (default: active only).
page_size	integer	no	Records per page (max 1000).
offset	integer	no	Offset for the next page: pass next_offset from the previous call (default 0).

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 outlet_ids, product_ids (or root_product_ids for variant families), supplier_ids; to_be_procured_only keeps products with a positive quantity_to_procure (the vendor's re-order suggestion, which accounts fo

Parameter	Type	Required	Notes
outlet_ids	array	no	Only these outlets (the vendor calls them location_ids).
product_ids	array	no	Only these products. Not together with root_product_ids.
root_product_ids	array	no	Only these variant families (use with group_variants). Not together with product_ids.
supplier_ids	array	no	—
to_be_procured_only	boolean	no	true = only products with a positive quantity_to_procure (not the same as below the reorder point).
include_inactive	boolean	no	true = include inactive products.
include_composites	boolean	no	—
group_variants	boolean	no	Aggregate variant families when filtering by root_product_ids.
sort_type	string	no	—
sort_direction	string	no	—
size	integer	no	Records per page (default 100, max 500 here).
offset	integer	no	Offset for the next page: pass next_offset from the previous call (default 0).

List product brands (id, name). Paginate with next_after. GET /brands.

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).
deleted	boolean	no	true = include deleted records (default: active only).

List product tags (id, name). Paginate with next_after. GET /tags.

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).
deleted	boolean	no	true = include deleted records (default: active only).

List suppliers: id, name, default markup and contact details. Paginate with next_after. GET /suppliers.

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).
deleted	boolean	no	true = include deleted records (default: active only).

List consignments: supplier stock orders (type SUPPLIER), transfers between outlets (OUTLET), stocktakes (STOCKTAKE) and returns (RETURN), with status (OPEN, SENT, DISPATCHED, RECEIVED, STOCKTAKE_*, CLOSED, CANCELLED), outlet, supplier, due and received dates, totals. Paginate with next_after. GET /consignments.

Parameter	Type	Required	Notes
type	string	no	SUPPLIER = purchase / stock orders.
status	string	no	—
outlet_id	string	no	Only consignments of this outlet.
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).

One consignment (stock order, transfer, stocktake or return) by id. GET /consignments/{consignment_id}.

Parameter	Type	Required	Notes
consignment_id	string	yes	Consignment id (from list_consignments).

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.

Parameter	Type	Required	Notes
consignment_id	string	yes	Consignment id.
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).

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, state, customer_id, source (outlet, register, user), payments, line_items, totals. Paginate with next_after (stop when data is empty). GET /sales.

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).

One sale by id with its line items, payments, taxes and totals. GET /sales/{sale_id}.

Parameter	Type	Required	Notes
sale_id	string	yes	Sale id (from list_sales or search_sales).

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 large: for totals over a period use sales_summary instead of paging through this. GET /search?type=sales.

Parameter	Type	Required	Notes
date_from	string	no	Sales from this UTC time. YYYY-MM-DD means the start of that UTC day; or 2026-10-01T00:00:00Z. Convert local days to UTC with the retailer's time zone.
date_to	string	no	Sales up to this UTC time. YYYY-MM-DD means the END of that UTC day (23:59:59Z).
state	string	no	Sale state. On-account and layby sales are state closed (they differ by attributes).
outlet_id	string	no	Only sales at this outlet.
register_id	string	no	Only sales on this register.
user_id	string	no	Only sales by this staff user.
customer_id	string	no	Only sales to this customer.
payment_type_id	string	no	Only sales with this payment type (the payment type's config_id, shown as payments[].type.config_id in a sale).
product_id	string	no	Only sales containing this product.
invoice_number	string	no	—
page_size	integer	no	Records per page (max 1000).
offset	integer	no	Offset for the next page: pass next_offset from the previous call (default 0).

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 by state, UTC day, outlet and payment type name, and the top products by quantity. By default only closed sales are counted (states containing 'closed'); set counted_states to change that. Dates are UTC

Parameter	Type	Required	Notes
date_from	string	no	Sales from this UTC time. YYYY-MM-DD means the start of that UTC day; or 2026-10-01T00:00:00Z. Convert local days to UTC with the retailer's time zone.
date_to	string	no	Sales up to this UTC time. YYYY-MM-DD means the END of that UTC day (23:59:59Z).
state	string	no	Sale state. On-account and layby sales are state closed (they differ by attributes).
outlet_id	string	no	Only sales at this outlet.
register_id	string	no	Only sales on this register.
user_id	string	no	Only sales by this staff user.
customer_id	string	no	Only sales to this customer.
payment_type_id	string	no	Only sales with this payment type (the payment type's config_id, shown as payments[].type.config_id in a sale).
product_id	string	no	Only sales containing this product.
invoice_number	string	no	—
counted_states	array	no	Sale states that count towards the totals (exact, case-insensitive). Default: every state containing 'closed'.
max_pages	integer	no	Pages of page_size sales to read (default 5, max 20).
page_size	integer	no	Sales per page (default 1000).
offset	integer	no	Offset for the next page: pass next_offset from the previous call (default 0).

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_after (stop when data is empty). GET /customers.

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).
deleted	boolean	no	true = include deleted records (default: active only).

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.

Parameter	Type	Required	Notes
email	string	no	—
first_name	string	no	—
last_name	string	no	—
company_name	string	no	—
phone	string	no	—
mobile	string	no	—
customer_code	string	no	—
deleted	boolean	no	true = include deleted records (default: active only).
page_size	integer	no	Records per page (max 1000).
offset	integer	no	Offset for the next page: pass next_offset from the previous call (default 0).

One customer by id: contact details, addresses, customer group, balance, loyalty balance, year-to-date spend. GET /customers/{customer_id}.

Parameter	Type	Required	Notes
customer_id	string	yes	Customer id (from search_customers or list_customers).

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.

Parameter	Type	Required	Notes
after	integer	no	Cursor: only records with a version number greater than this. Omit for the first page; then pass next_after from the previous call. Stop when data is empty.
before	integer	no	Only records with a version number up to this (rarely needed).
page_size	integer	no	Records per page (the vendor default applies when omitted; 50-100 keeps replies short).
deleted	boolean	no	true = include deleted records (default: active only).

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.

Parameter	Type	Required	Notes
first_name	string	no	First name.
last_name	string	no	Last name.
company_name	string	no	—
customer_code	string	no	Unique customer code (generated when omitted on create).
customer_group_id	string	no	Customer group id (see list_customer_groups).
email	string	no	—
phone	string	no	—
mobile	string	no	—
note	string	no	—
date_of_birth	string	no	—
do_not_email	boolean	no	—
enable_promotional_sms	boolean	no	—
enable_loyalty	boolean	no	—
physical_address_1	string	no	—
physical_address_2	string	no	—
physical_suburb	string	no	—
physical_city	string	no	—
physical_state	string	no	—
physical_postcode	string	no	—
physical_country_id	string	no	Country code such as US, CA, AU.

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 a full PUT). Cannot delete a customer or change balances. Lightspeed offers no partial update for customers, so a change made by someone else in the moments between the tool's read and its write can b

Parameter	Type	Required	Notes
customer_id	string	yes	Customer id.
first_name	string	no	First name.
last_name	string	no	Last name.
company_name	string	no	—
customer_code	string	no	Unique customer code (generated when omitted on create).
customer_group_id	string	no	Customer group id (see list_customer_groups).
email	string	no	—
phone	string	no	—
mobile	string	no	—
note	string	no	—
date_of_birth	string	no	—
do_not_email	boolean	no	—
enable_promotional_sms	boolean	no	—
enable_loyalty	boolean	no	—
physical_address_1	string	no	—
physical_address_2	string	no	—
physical_suburb	string	no	—
physical_city	string	no	—
physical_state	string	no	—
physical_postcode	string	no	—

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 uses). Nothing else on the product changes. Read the product first and confirm the new price with the user. PATCH /products/{product_id}.

Parameter	Type	Required	Notes
product_id	string	yes	Product id (from list_products).
price_excluding_tax	string	no	New price before tax, e.g. "24.99".
price_including_tax	string	no	New price including tax, e.g. "29.99".
loyalty_amount	string	no	New loyalty amount.

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, so sales made since you last read it are lost from the count. Read get_inventory_levels first and confirm the number with the user. Other outlets and all other product fields stay as they are. PATCH /

Parameter	Type	Required	Notes
product_id	string	yes	Product id (from list_products).
outlet_id	string	yes	Outlet id (from list_outlets).
current_amount	number	no	New stock on hand at this outlet (the total, not a delta).
reorder_point	number	no	Re-order when stock falls to this level.
reorder_amount	number	no	How many to re-order.

Free

$0 forever

Every tool — any call limit is its publisher’s, not ours
No card, and mcprush charges nothing for it
Runs at its publisher’s own address — this marketplace is not in the path
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install Lightspeed Retail (X-Series) MCP by usefulapi or to call it, at any volume.

ATool-list grade · score 93 / 100

Release 1.18.3 · scanned 6 Nov 2026

Graded from the tools this server lists, not from its source code.

Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.

Threat score100

Client score93

Findings0 threat · 0 capability

Capabilitymoderate

Coveragemanifest

Verificationnot in this report

Surface digest4b3d23fa8bd0ab69f5f2575b0e721099367e83a4b9b40fefacd757df280a6b06

Score vectorthreat 100 → client 93

Term	Level	What it prices	Points
capability-exposure	moderate	capability blast radius (moderate) — client exposure if the model is manipulated	−3
coverage-honesty	manifest	inspection depth (manifest) — how much of the target the scan could see	−4

score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.

What the scan could actually read

A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.

The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.

Tool surfaceread

Implementation sourcenot available

Package metadatanot available

Live transportnot available

The implementation source was not read — this reflects the declared tool metadata only.

Capability — what it could do if the model were manipulated

Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.

Tool	Capability tags	Why the tag was assigned
lightspeedxseries_get_retailer	no tags
lightspeedxseries_list_outlets	no tags
lightspeedxseries_get_outlet	no tags
lightspeedxseries_list_registers	no tags
lightspeedxseries_get_register_payments_summary	no tags
lightspeedxseries_list_taxes	no tags
lightspeedxseries_list_users	no tags
lightspeedxseries_get_user_sale_totals	no tags
lightspeedxseries_list_products	no tags
lightspeedxseries_get_product	no tags
lightspeedxseries_search_products	no tags
lightspeedxseries_get_inventory_levels	no tags
lightspeedxseries_list_brands	no tags
lightspeedxseries_list_tags	no tags
lightspeedxseries_list_suppliers	no tags
lightspeedxseries_list_consignments	no tags
lightspeedxseries_get_consignment	no tags
lightspeedxseries_list_consignment_products	no tags
lightspeedxseries_list_sales	no tags
lightspeedxseries_get_sale	no tags
lightspeedxseries_search_sales	no tags
lightspeedxseries_sales_summary	no tags
lightspeedxseries_list_customers	no tags
lightspeedxseries_search_customers	no tags
lightspeedxseries_get_customer	no tags
lightspeedxseries_list_customer_groups	no tags
lightspeedxseries_create_customer	state-write	state-write: declares readOnlyHint: false
lightspeedxseries_update_customer	state-write	state-write: declares readOnlyHint: false, destructiveHint: true
lightspeedxseries_update_product_prices	state-write	state-write: declares readOnlyHint: false, destructiveHint: true
lightspeedxseries_set_product_stock	state-write	state-write: declares readOnlyHint: false, destructiveHint: true

Toxic-flow graph

The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.

The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.

Supply chain and provenance

Integrityfirst-seen

Surface digest4b3d23fa8bd0ab69

Scanned2026-11-06

This is the first scan of this surface here, so there is nothing yet to compare it against.

Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.

Where are you running it?

Tool surface

Release history

Lightspeed Retail (X-Series) MCP by usefulapi

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

What the scan could actually read

Capability — what it could do if the model were manipulated

Toxic-flow graph

Supply chain and provenance

Release history

See also