SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Lightspeed Retail X-Series MCP with Hermes

Connect Hermes to Lightspeed Retail X-Series MCP. List low-stock products across all stores, summarize today's sales by store, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Lightspeed Retail X-Series logoLightspeed Retail X-Series
Oauth2

Lightspeed Retail X-Series is a point-of-sale and retail management platform. It centralizes store configuration, inventory, customers, and sales reporting.

7 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Lightspeed Retail X-Series account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Lightspeed Retail X-Series with

ChatGPTClaude CoworkAtomic Agent

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Lightspeed Retail X-Series with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Lightspeed Retail X-Series

Ask your agent to connect to Lightspeed Retail X-Series, or simply request any Lightspeed Retail X-Series-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Lightspeed Retail X-Series connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Lightspeed Retail X-Series or request any Lightspeed Retail X-Series-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Lightspeed Retail X-Series MCP server, and what's possible with it?

The Lightspeed Retail X-Series MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Lightspeed Retail X-Series account. It provides structured and secure access to your retailer configuration, products, customers, payment types, and sales, so your agent can inspect store settings, browse products, look up customers, review payment options, and read sales records on your behalf.

  • Retailer account overview: Have your agent review your retailer identity, account status, store configuration, and subscription state.
  • Product catalog discovery: Let the agent browse your product catalog or retrieve details for a specific product.
  • Customer lookup: Direct your agent to browse customer records or retrieve information about a specific customer.
  • Sales review: Instruct your agent to read sales records from the connected retailer account for reporting or analysis.
  • Payment type visibility: Have your agent list the payment types configured for your retail store.

Way Forward

With Lightspeed Retail X-Series connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Lightspeed Retail X-Series action and event your agent gets out of the box.

Get Customer

Retrieve one Lightspeed customer by their exact customer ID.

Get Product

Retrieve one Lightspeed product by its exact product ID.

Get Retailer

Return the connected Lightspeed Retail X-Series retailer's identity, account status, configuration, and subscription state.

List Customers

Return one cursor-controlled page of customers from the connected Lightspeed retailer.

List Payment Types

Return one cursor-controlled page of payment types configured for the connected Lightspeed retailer.

List Products

Return one cursor-controlled page of products from the connected Lightspeed retailer for catalog discovery.

List Sales

Return one cursor-controlled page of sales from the connected Lightspeed retailer; an empty page is a successful no-sales result.

FRAMEWORKS

How to build Lightspeed Retail X-Series MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Lightspeed Retail X-Series MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Lightspeed Retail X-Series MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Lightspeed Retail X-Series MCP with Atomic Agent

FAQ

Frequently asked questions

With a standalone Lightspeed Retail X-Series MCP server, the agents and LLMs can only access a fixed set of Lightspeed Retail X-Series tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Lightspeed Retail X-Series and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Lightspeed Retail X-Series tools.

Yes, absolutely. You can configure which Lightspeed Retail X-Series scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Lightspeed Retail X-Series data and credentials are handled as safely as possible.

Start with Lightspeed Retail X-Series.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Lightspeed Retail X-Series tool your agent needs.Free to start.

Start building