MCP server

Lightspeed Retail (X-Series) MCP by usefulapi

io.usefulapi/lightspeed-x-series

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

30

Token cost

About 9,262 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http lightspeed-x-series https://lightspeed-x-series.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.lightspeed-x-series]
url = "https://lightspeed-x-series.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"lightspeed-x-series":{"httpUrl":"https://lightspeed-x-series.usefulapi.io/mcp"}}}

Cursor

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

VS Code

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

Antigravity

agy mcp add lightspeed-x-series https://lightspeed-x-series.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"lightspeed-x-series","server_url":"https://lightspeed-x-series.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"lightspeed-x-series","server_url":"https://lightspeed-x-series.usefulapi.io/mcp"}

Tools

• lightspeedxseries_create_customer ~478 tokens
  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.
• lightspeedxseries_get_consignment ~122 tokens
  One consignment (stock order, transfer, stocktake or return) by id. GET /consignments/{consignment_id}.
• lightspeedxseries_get_customer ~134 tokens
  One customer by id: contact details, addresses, customer group, balance, loyalty balance, year-to-date spend. GET /customers/{customer_id}.
• lightspeedxseries_get_inventory_levels ~718 tokens
  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 kee
• lightspeedxseries_get_outlet ~98 tokens
  One outlet by id. GET /outlets/{outlet_id}.
• lightspeedxseries_get_product ~216 tokens
  One product (variant) by id, with its prices, codes, suppliers and outlet taxes. GET /products/{product_id}.
• lightspeedxseries_get_register_payments_summary ~135 tokens
  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.
• lightspeedxseries_get_retailer ~116 tokens
  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.
• lightspeedxseries_get_sale ~111 tokens
  One sale by id with its line items, payments, taxes and totals. GET /sales/{sale_id}.
• lightspeedxseries_get_user_sale_totals ~127 tokens
  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.
• lightspeedxseries_list_brands ~252 tokens
  List product brands (id, name). Paginate with next_after. GET /brands.
• lightspeedxseries_list_consignment_products ~299 tokens
  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.
• lightspeedxseries_list_consignments ~419 tokens
  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 /
• lightspeedxseries_list_customer_groups ~277 tokens
  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.
• lightspeedxseries_list_customers ~303 tokens
  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.
• lightspeedxseries_list_outlets ~286 tokens
  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.
• lightspeedxseries_list_products ~428 tokens
  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
• lightspeedxseries_list_registers ~271 tokens
  List registers (tills): id, name, outlet_id, is_open, open/close times and invoice numbering. Paginate with next_after. GET /registers.
• lightspeedxseries_list_sales ~300 tokens
  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_aft
• lightspeedxseries_list_suppliers ~262 tokens
  List suppliers: id, name, default markup and contact details. Paginate with next_after. GET /suppliers.
• lightspeedxseries_list_tags ~250 tokens
  List product tags (id, name). Paginate with next_after. GET /tags.
• lightspeedxseries_list_taxes ~85 tokens
  List tax groups and their rates (id, name, is_default, rates). The vendor returns the whole list in one reply (no cursor). GET /taxes.
• lightspeedxseries_list_users ~254 tokens
  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.
• lightspeedxseries_sales_summary ~790 tokens
  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 clo
• lightspeedxseries_search_customers ~297 tokens
  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.
• lightspeedxseries_search_products ~379 tokens
  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.
• lightspeedxseries_search_sales ~615 tokens
  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=sal
• lightspeedxseries_set_product_stock ~354 tokens
  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 co
• lightspeedxseries_update_customer ~593 tokens
  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 cu
• lightspeedxseries_update_product_prices ~293 tokens
  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 us

Browse

• Email
• Payments
• Invoicing and accounting

Related MCP servers

• Lightspeed Retail (R-Series) MCP by usefulapi
  Read Lightspeed R-Series items, stock, sales, customers and POs; create customers and set stock.
• X402 Factory
  200+ x402 paid data APIs for AI agents: prediction markets, verified weather, econ, SEC filings
• AgendaPro MCP by usefulapi
  Read AgendaPro bookings, slots, clients, services and sales; create, update and cancel bookings.
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• Bukku MCP by usefulapi
  Read Bukku contacts, accounts, invoices, bills and journals; create contacts and sales invoices.
• Smaregi MCP by usefulapi
  Read Smaregi stores, products, customers, stock and transactions; manage customers, products, stock.
• Eia Energy
  Browse and query the EIA API v2 — electricity, petroleum, natural gas, coal, forecasts via MCP.
• Laudus MCP by usefulapi
  Read Laudus ERP customers, sales, purchases, stock and accounting reports; create customers.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/lightspeed-x-series.svg)](https://aptlynx.net/servers/io.usefulapi/lightspeed-x-series)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents