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 57 MCP tools out of the box. Auth, tool execution, and security all managed.
StackOne 
Coverage
57 Agent Actions
Create, read, update, and delete across Lightspeed Retail X-Series — and extend your agent's capabilities with custom 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 — 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 57 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 action from Lightspeed Retail X-Series's API, ready for your agent. Create, read, update, 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
Deletes the customer with the requested ID.
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.
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 (40)
- Create A New Customer
Creates a new customer.
- Create And Update A Product Category Hierarchy
Create and update a product category hierarchy
- Create A Promotion
This endpoint creates a new promotion.
- Create New Supplier
Creates a new supplier.
- Get A Single Brand
Returns a single brand with a requested ID
- List Consignments
Return a paginated list of consignments.
- Get A Single Consignment
Returns a single consignment with the requested ID.
- List Customers
Returns a paginated list of customers.
- Get A Single Customer
Returns a single customer with a requested ID.
- List Gift Cards
Returns a paginated list of gift cards.
- List Inventory Records
Returns a paginated list of inventory records.
- 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.
- Get A Single Price Book
Returns a single price book with a requested ID
- 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.
- 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 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.
- 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.
Agent Frameworks
JSON{
"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
133+ actions
128+ actions
125+ actions
120+ actions
85+ actions
83+ actions
Platform Resources
MCP Code Mode: Keeping Tool Responses Out of Agent Context
Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.
11 min
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, their shared security risks including indirect prompt injection, and when to use one, both, or a hybrid architecture.
12 min
MCP vs API: What 200+ Connector Builds Taught Us
MCP wraps APIs, it doesn't replace them. After building 200+ 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?
Lightspeed Retail X-Series MCP server vs direct API integration — what's the difference?
How does Lightspeed Retail X-Series authentication work for AI agents?
origin_owner_id.Are Lightspeed Retail X-Series MCP tools vulnerable to prompt injection?
What is the context bloat of a Lightspeed Retail X-Series agent and how do I avoid it?
Can I limit which actions my Lightspeed Retail X-Series agent can access?
Can I create custom agent actions for my Lightspeed Retail X-Series MCP server?
When should I NOT use a Lightspeed Retail X-Series MCP server?
What AI frameworks and AI clients does the StackOne Lightspeed Retail X-Series MCP server support?
Put your AI agents to work
All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.