Live 75 Actions

Lightspeed Retail X-Series MCP Server
for AI Agents

Connect your AI agent to StackOne's Lightspeed Retail X-Series MCP server and give it 75 MCP tools out of the box. Auth, tool execution, and security all managed.

Start Free Book Demo Read Docs →

Lightspeed Retail X-Series MCP Server

Built by

StackOne

Coverage

75 Agent Actions

Agents can read, write and delete in Lightspeed Retail X-Series. Extend your agent's capabilities with custom actions.

MCP Actions → Build Actions →

Authentication

Agent Tool Authentication

Per-user OAuth in one call. Your Lightspeed Retail X-Series MCP server gets session-scoped tokens with zero credentials stored on your infra.

Agent Auth →

Security

Agent Protection

Every Lightspeed Retail X-Series tool response scanned for prompt injection in milliseconds, with 88.7% accuracy, all running on CPU.

Prompt Injection Defense →

Performance

Max Agent Context. Min Cost.

Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every Lightspeed Retail X-Series call.

Tools Discovery →

What is the Lightspeed Retail X-Series MCP Server?

A Lightspeed Retail X-Series MCP server lets AI agents read and write Lightspeed Retail X-Series data through the Model Context Protocol, Anthropic's open standard for connecting LLMs to external tools. StackOne's Lightspeed Retail X-Series MCP server ships with 75 pre-built actions, fully extensible via the Connector Builder, plus managed authentication, prompt injection defense, observability, and agent execution runtime. Connect it from MCP clients like Claude Desktop, Claude Code, Cursor, Goose, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.

All Lightspeed Retail X-Series MCP Tools

Every StackOne action for Lightspeed Retail X-Series, ready for your agent. Read, write and delete, scoped to exactly what you need.

Brands

Create Brand
Creates a new brand.
List Brands
Returns a paginated list of brands.

A Consignments

Create A Consignment
Creates a new consignment.
Update A Consignment
Updates the given consignment.

A Customers

Update A Customer
Updates the customer with the requested ID.
Delete A Customer
Schedules the customer for deletion.

Gift Cards

Create Gift Card
Create a gift card
List Gift Cards
Returns a paginated list of gift cards.

Stock Adjustments

Create Stock Adjustments
Creates one or more stock adjustments in a single batch (1–1000 items per request).
List Stock Adjustments
Returns a paginated list of stock adjustments for the authenticated retailer.

A Single Price Books

Create A Single Price Book
Create a single price book
Get A Single Price Book
Returns a single price book with a requested ID

Products

Create Product
Creates a new product.
List Products
Returns a paginated list of products.

A Single Products

Get A Single Product
Returns a single product object with a given ID.
Delete A Single Product
Deletes a single product. If a variant ID is provided, that single variant is removed.

A Sales

Create A Sale
Create a sale. Returns the ID of the created sale. See [Sales 101](/docs/sales_101) for usage information.
Update A Sale
Update an existing sale by ID.

Webhooks

Create Webhook
Create a webhook.
List Webhooks
List all webhooks.
Delete Webhook
Delete a webhook

Other (54)

Add A Product To A Consignment
Add a product to a consignment
Create A New Customer
Creates a new customer.
Create A Custom Inventory Adjustment Reason
Creates a custom reason that stock adjustments can reference.
Create And Update A Product Category Hierarchy
Create and update a product category hierarchy
Upload An Image
Upload a product image
Create A Promotion
This endpoint creates a new promotion.
Create A Store Credit Transaction
Create a store credit transaction
Create A Store Credit HOLD Transaction
Places a hold on a customer's store credit.
Create New Supplier
Creates a new supplier.
Create Tax
Create a tax
Get A Single Brand
Returns a single brand with a requested ID
List Channels
Returns a list of configured e-commerce channels.
List Consignments
Return a paginated list of consignments.
Get A Single Consignment
Returns a single consignment with the requested ID.
List All Products For A Specific Consignment
Returns the line items of a consignment.
List Customers
Returns a paginated list of customers.
Get A Single Customer
Returns a single customer with a requested ID.
List Customer Groups
List customer groups
List Inventory Records
Returns a paginated list of inventory records.
List Custom Inventory Adjustment Reasons
List custom inventory adjustment reasons
List Outlets
Returns a collection of outlets.
Get A Single Outlet
Returns a single outlet with the requested ID.
List Payment Types
Returns a paginated collection of payment types.
List Price Books
Returns a paginated list of price books.
List Price Book Products
Returns a paginated list of price book products.
List Product Categories
List product categories
Get A Single Product Image Data
Returns the metadata for a single product image with a given ID.
List Product Types
**DEPRECATED** We recommend using the product_categories endpoint instead.
Get A Single Product Type
Returns a single product type with a given ID.
List Promotions
This endpoint lists all promotions for a retailer.
Get A Promotion By ID
This will retrieve a single promotion using the given ID.
List Registers
Returns a paginated list of registers.
Get A Single Register
Returns a single register with the requested ID.
Get Information About This Retailer
This endpoint returns information about the retailer.
List Sales
Returns a paginated list of sales.
Get A Single Sale
Returns a single sale with a given ID.
Search For Resources
Search sales, products or customers with filters and sorting
List Store Credits For A Given Customer
Returns a list of store credits for the given customer id. Returns HTTP 404 (not 200 + empty array) when the customer has no store credits.
List Suppliers
Returns a paginated list of suppliers.
Get A Single Supplier
Returns a single supplier with a given ID.
List Tags
Returns a collection of tags.
Get A Single Tag
Returns a single tag with the requested ID.
List Taxes
Returns a paginated list of taxes.
Get A Single Tax
Returns a single tax with a given ID.
List Users
Returns a paginated list of users.
Get A Single User
Returns a single user with the requested ID.
List Variant Attributes
Returns all variant attributes defined for the retailer.
Get A Single Variant Attribute
Returns a single variant attribute with the requested ID.
Update A Product In A Consignment
Updates a line item on a consignment.
Update A Product
Update an existing product.
Set Image Position
Allows for changing the image position in the list
Update A Supplier
Updates a supplier.
Find Gift Card
Finds and returns the given card number. Returns a 404 if the card does not exist.
Store Credit List
Returns a list of store credit customers.

Set Up Your Lightspeed Retail X-Series MCP Server in Minutes

One endpoint. Any framework. Your agent is talking to Lightspeed Retail X-Series in under 10 lines of code.

MCP Clients

Agent Frameworks

Claude Desktop-

JSON

Claude Desktop Docs

{
  "mcpServers": {
    "stackone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?x-account-id=<account_id>",
        "--header",
        "Authorization: Basic <YOUR_BASE64_TOKEN>"
      ]
    }
  }
}

Check More Commerce MCP Servers

172+ actions

138+ actions

137+ actions

128+ actions

120+ actions

91+ actions

90+ actions

All Commerce MCP Servers →

Platform Resources

Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery

Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.

10 min

Indirect Prompt Injection Defense for MCP Tools: A Technical Guide

MCP tools that read emails, CRM records, and tickets are indirect prompt injection vectors. Here's how we built a two-tier defense that scans tool results in ~11ms.

12 min

MCP vs A2A: Architecture, Security, and When to Use Each

MCP vs A2A: what each protocol standardizes, how they differ, the security risks they share, and when to use one, both or a hybrid.

12 min

MCP vs API: What Hundreds of Connector Builds Taught Us

MCP wraps APIs, it doesn't replace them. After building hundreds of connectors that serve both, here's when each approach wins.

14 min read

Lightspeed Retail X-Series MCP Server FAQ

Does StackOne have a Lightspeed Retail X-Series MCP server?

Yes. StackOne offers a managed Lightspeed Retail X-Series MCP server with 75 pre-built actions, and every action is tested and QA'd by StackOne. Connect it to Claude, Cursor, and any other MCP client, or to any agent framework through the AI Action SDK. It ships with managed agent authentication, prompt injection defense, and tool discovery with server-side execution that preserve your agent's context window and keep reasoning performance.

Lightspeed Retail X-Series MCP server vs direct API integration: what's the difference?

A Lightspeed Retail X-Series MCP server and direct API integration serve different use cases. Direct API integration is for software-to-software work, where backend code calls Lightspeed Retail X-Series. A Lightspeed Retail X-Series MCP server is for AI agents that discover and call Lightspeed Retail X-Series at runtime, such as MCP clients like Claude and Cursor, plus framework agents built with OpenAI, LangChain, or Vercel AI. StackOne provides both.

How does Lightspeed Retail X-Series authentication work for AI agents?

Lightspeed Retail X-Series authentication for AI agents works through a StackOne Connect Session. Create one via the dashboard or the SDK to get an auth link and ready-to-paste config for Claude Desktop, Cursor, and other MCP clients. Your user authenticates their own Lightspeed Retail X-Series account; StackOne handles token exchange, storage, and refresh. Credentials never reach the LLM, and each user is isolated via origin_owner_id.

Are Lightspeed Retail X-Series MCP tools vulnerable to prompt injection?

Yes. Lightspeed Retail X-Series MCP tools can be vulnerable to indirect prompt injection. Any tool that reads user-written content, such as documents, messages, tickets, records, or free-text fields, is a potential vector. StackOne Defender scans every tool response before it enters the agent's context. It runs regex patterns in ~1ms, then a MiniLM classifier in ~4ms. Accuracy is 88.7%, and it runs entirely on CPU.

What is the context bloat of a Lightspeed Retail X-Series agent and how do I avoid it?

Context bloat happens when Lightspeed Retail X-Series tool schemas and API responses eat your Lightspeed Retail X-Series agent's memory, preventing it from reasoning effectively. A single Lightspeed Retail X-Series query can return a massive JSON response, and connecting multiple tools compounds the problem. Tools Discovery reduces it by loading only the tools relevant to each query.

Can I limit which actions my Lightspeed Retail X-Series agent can access?

Yes. You can limit which actions your Lightspeed Retail X-Series agent can access directly from the StackOne dashboard. Toggle actions on or off, or restrict them to specific accounts, with no code changes to your agent. Session tokens can be scoped to exact actions so if one leaks, exposure stays contained.

Can I create custom agent actions for my Lightspeed Retail X-Series MCP server?

Yes. You can create custom agent actions for your Lightspeed Retail X-Series MCP server using Connector Builder. It's an integration agent your coding assistant (Claude Code, Cursor, or Copilot) can invoke to research Lightspeed Retail X-Series's API, generate production-ready connector YAML, test against the live API, and validate before you ship.

When should I NOT use a Lightspeed Retail X-Series MCP server?

Skip a Lightspeed Retail X-Series MCP server if your integration is purely software-to-software, because direct Lightspeed Retail X-Series API integration is simpler when no AI agent is involved. For deterministic, compliance-critical operations (financial transactions, regulatory reporting), direct API gives you predictable behavior without agent-driven decision-making. MCP shines when AI agents need to dynamically discover and call Lightspeed Retail X-Series actions at runtime.

What AI frameworks and AI clients does the StackOne Lightspeed Retail X-Series MCP server support?

The StackOne Lightspeed Retail X-Series MCP server supports both. MCP clients (paste-and-go apps): Claude Desktop, Claude Code, Cursor, VS Code, Goose. Agent frameworks (code SDKs you build with): OpenAI Agents SDK, Anthropic, Vercel AI, Google ADK, CrewAI, Pydantic AI, LangChain, LangGraph, Azure AI Foundry.

Put your AI agents to work

Connect AI to every company system and control what it can do in each one, down to the field.

Start Free Book Demo

Lightspeed Retail X-Series MCP Serverfor AI Agents