Skip to main content

The #1 agentic semantic tool search: 91.6% first-try accuracy on S1 Search Bench • Explore Tool Discovery →

Live 57 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 57 MCP tools out of the box. Auth, tool execution, and security all managed.

Start Free Book Demo Read Docs →
Lightspeed Retail X-Series logo
Lightspeed Retail X-Series MCP Server
Built by StackOne StackOne
DrataGPLocalyzeFlipMindtoolsScreenloop

Coverage

57 Agent Actions

Create, read, update, and delete across Lightspeed Retail X-Series — and 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 — 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.

MCP Clients

Claude Desktop setup guide
Claude Code setup guide
Cursor setup guide
Goose setup guide

Agent Frameworks

Claude Desktop
{
  "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

Klaviyo

162+ actions

Stripe

133+ actions

Magento

128+ actions

Square

125+ actions

BigCommerce

120+ actions

Shopify

85+ actions

Eventbrite

83+ actions

All Commerce MCP Servers →

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?
Yes. StackOne offers a hosted Lightspeed Retail X-Series MCP server with 57 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 — backend code calling Lightspeed Retail X-Series. A Lightspeed Retail X-Series MCP server is for AI agents — MCP clients like Claude and Cursor, plus framework agents built with OpenAI, LangChain, or Vercel AI — discovering and calling Lightspeed Retail X-Series at runtime. 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 — you 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 — 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 — regex patterns in ~1ms, then a MiniLM classifier in ~4ms. 88.7% accuracy, CPU-only.
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 and Code Mode reduce context bloat — loading only relevant tools per query and keeping raw responses out of the agent's context.
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 — 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

All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.

Start Free Book Demo