MCP server

Lightspeed Retail (R-Series) MCP by usefulapi

io.usefulapi/lightspeed-r-series

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

Read Lightspeed R-Series items, stock, sales, customers and POs; create customers and set stock.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

17

Token cost

About 6,215 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-r-series https://lightspeed-r-series.usefulapi.io/mcp

Claude Desktop

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

Codex (config.toml)

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

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add lightspeed-r-series https://lightspeed-r-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-r-series","server_url":"https://lightspeed-r-series.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

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

Tools

• lightspeedrseries_create_customer ~347 tokens
  Create a new customer, optionally with a primary email and one phone number (stored in the customer's Contact). Give at least a first name, last name or company. Returns the new customer with its customerID. POST /Account/{accountID}/Customer.json.
• lightspeedrseries_get_account ~97 tokens
  The connected Lightspeed Retail (R-Series) account: id, name, status, employee count/limit, default and purchasing currencies. Good first call. GET /Account/{accountID}.json.
• lightspeedrseries_get_customer ~264 tokens
  One customer by customerID with Contact (emails, phones, addresses), customer type and notes. GET /Account/{accountID}/Customer/{customerID}.json.
• lightspeedrseries_get_item ~340 tokens
  One item by itemID with its prices, per-shop stock (ItemShops), category and other related records. GET /Account/{accountID}/Item/{itemID}.json.
• lightspeedrseries_get_purchase_order ~246 tokens
  One purchase order by orderID with its lines (OrderLines: itemID, quantity, numReceived, price), vendor and shop. GET /Account/{accountID}/Order/{orderID}.json.
• lightspeedrseries_get_sale ~413 tokens
  One sale by saleID with its line items (SaleLines with Item), payments (SalePayments with PaymentType) and customer. GET /Account/{accountID}/Sale/{saleID}.json.
• lightspeedrseries_list_categories ~298 tokens
  Item categories (hierarchical): categoryID, name, fullPathName, parentID, nodeDepth. GET /Account/{accountID}/Category.json.
• lightspeedrseries_list_customers ~463 tokens
  Search customers by name, company or email: customerID, firstName, lastName, company, customerTypeID, createTime. Email search loads the Contact relation (emails, phones, addresses). Paginate with next_url. GET /Account/{accountID}/Customer.json.
• lightspeedrseries_list_employees ~302 tokens
  Employees: employeeID, firstName, lastName, lockOut, archived, employeeRoleID, limitToShopID. Use employeeID to filter sales. GET /Account/{accountID}/Employee.json.
• lightspeedrseries_list_inventory ~448 tokens
  Stock levels per item per shop (ItemShop records): qoh (quantity on hand), sellable, backorder, reorderPoint, reorderLevel, costs and values. shopID 0 is the all-shops summary. Paginate with next_url. GET /Account/{accountID}/ItemShop.json.
• lightspeedrseries_list_items ~748 tokens
  Search the product catalog. Each item has itemID, description, SKUs (systemSku, customSku, upc, ean, manufacturerSku), defaultCost, categoryID and its Prices (price levels). Set include_stock to add per-shop quantities (ItemShops; shopID 0 = all shops). Paginate with next_url. GET /Account/{accountI
• lightspeedrseries_list_purchase_orders ~389 tokens
  Purchase orders to vendors: orderID, vendorID, shopID, orderedDate, arrivalDate, receivedDate, complete, totalQuantity, shipCost. GET /Account/{accountID}/Order.json.
• lightspeedrseries_list_sales ~658 tokens
  Sales history: saleID, completed/voided flags, completeTime, totals (calcSubtotal, calcTax1/2, total, balance), customerID, employeeID, shopID, registerID. Filter by a date range on completeTime (default) or timeStamp, shop, customer, employee. Set include_lines for SaleLines (items sold). Paginate
• lightspeedrseries_list_shops ~249 tokens
  List the account's shops (store locations): shopID, name, time zone, archived flag. Use shopID to filter sales, inventory and purchase orders. GET /Account/{accountID}/Shop.json.
• lightspeedrseries_list_vendors ~308 tokens
  Suppliers: vendorID, name, accountNumber, archived. GET /Account/{accountID}/Vendor.json.
• lightspeedrseries_update_item ~339 tokens
  Change fields of an existing item: description, default cost, SKUs, category. Only the fields you pass are changed. Prices and stock are not changed here (use lightspeedrseries_update_stock for quantities). PUT /Account/{accountID}/Item/{itemID}.json.
• lightspeedrseries_update_stock ~306 tokens
  CHANGES STOCK COUNTS: sets (does not add to) the quantity on hand of one item in one shop to `qoh`, by updating the item's ItemShop record. Use for correcting a few items; for many items use an inventory count in Lightspeed. Identify the shop by shop_id, or by item_shop_id from lightspeedrseries_get

Browse

• Email
• Payments

Related MCP servers

• Lightspeed Retail (X-Series) MCP by usefulapi
  Read Lightspeed X-Series products, stock, sales, customers, stock orders; one-call sales reports.
• Gingr MCP by usefulapi
  Read Gingr reservations, owners, pets, check-ins, invoices and timeclock for your pet-care business.
• X402 Factory
  200+ x402 paid data APIs for AI agents: prediction markets, verified weather, econ, SEC filings
• PHP Point of Sale MCP by usefulapi
  Read PHP Point of Sale items, sales, customers and 138 reports; manage customers, items, expenses.
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• TexasHomeBills — Texas electricity plans
  Texas electricity plans by real annual cost, plus EIA/ERCOT grid and mobile-phone data (26 tools).
• AlphaYou Market Intelligence
  Impersonal stock and Hyperliquid research, each answer with its source link and date.
• Linnworks MCP by usefulapi
  Read Linnworks inventory, stock and orders; set stock levels and add order notes.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/lightspeed-r-series.svg)](https://aptlynx.net/servers/io.usefulapi/lightspeed-r-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