Home

MCP Server Documentation

LotsCommerce MCP Server

Connect AI agents like Claude and Cursor to LotsCommerce using the Model Context Protocol

Quick Information

MCP Endpoint

https://api.lotscommerce.com/mcp

Available Tools

66 tools

Authentication

OAuth 2.1 with PKCE

Setup Instructions

Configure your MCP client to connect to LotsCommerce

Add this configuration to your Cursor settings:

{
  "mcpServers": {
    "lotsstore": {
      "url": "https://api.lotscommerce.com/mcp"
    }
  }
}

Steps:

Open Cursor Settings (Cmd/Ctrl + ,)
Search for "MCP Servers"
Click "Edit in settings.json"
Add the configuration above
Restart Cursor
Cursor will automatically discover OAuth endpoints and handle authentication

Authentication

This server implements OAuth 2.1 with PKCE for secure authentication

OAuth 2.1 with PKCE (S256)

Most modern MCP clients will automatically discover and handle the OAuth flow. The server uses OAuth 2.1 with PKCE (S256) for secure authentication.

OAuth Discovery

https://api.lotscommerce.com/.well-known/oauth-authorization-server

Authorization Endpoint

https://api.lotscommerce.com/api/oauth/authorize

Token Endpoint

https://api.lotscommerce.com/api/oauth/token

How it works:

Clients automatically discover OAuth endpoints
Users are redirected to authenticate via browser
Authorization code is exchanged for access token
Bearer token is used for all MCP requests

Available Tools

66 MCP tools available for LotsCommerce. Use these tool names when calling the MCP server.

analytics

Get Store Analytics

Revenue, orders, average order value and the visit-to-order funnel for one store over a date range, with daily rows and the totals compared with the previous period of the same length.

billing

Choose a LotsCommerce plan or add credits

Create a checkout link. Pass plan (starter, pro or business) and cycle (monthly or annual) for a plan, or amount_usd (10 to 1000) to add LotsTech Credits. Give the link to the person to pay in their browser; never ask for card details in chat.

Get LotsCommerce billing

Show how the caller's stores are paid for: the plan (if any), whether today is covered or paid from LotsTech Credits, the credit balance, and the plans to choose from. Each store needs room on a plan or credits; an unfunded store keeps its storefront and data but pauses new orders and becomes read-only until funded.

customers

Get Customer

Gets one store customer, addresses, and store-scoped order summary after customer-group ownership checks.

List Customers

List a store's customers with search and paging.

discounts

Create Discount

Creates a standard fixed or percentage order discount scoped to the store sales channel.

Delete Discount

Deletes a store-owned discount code.

List Discounts

List a store's discount codes.

Update Discount

Changes the status of a store-owned discount code.

domains

Add Custom Domain

Connect the person's own domain (for example shop.example.com) to a store. Returns one CNAME record pointing to customers.lotscommerce.com for the owner to add at their DNS provider; HTTPS is set up automatically.

Delete Custom Domain

Removes a custom domain from a store and its storefront deployment.

List Custom Domains

Lists custom domains configured for a store.

Verify Custom Domain

Check a connected domain: reports whether DNS is in place, the security certificate is being issued, or the store is live on the domain.

inventory

List Inventory

List stock per product variant: in stock, reserved by open orders, incoming and available.

Update Inventory

Set the stock of a product variant.

orders

Get Checkout Order

Gets a tenant-scoped checkout order request, payment attempts, and timeline.

Get Order

Get one confirmed order: items, totals, customer, addresses, payment and fulfilment.

List Checkout Orders

Lists pre-fulfillment checkout order requests and their independent payment/acceptance states.

List Orders

List a store's confirmed orders with paging and filters.

Operate Checkout Order

Applies fulfillment, shipment, cancellation, tracking, invoice, and manual refund actions.

Update Checkout Order

Applies an audited payment verification or seller acceptance action.

payments

Connect Razorpay

Record the store's own Razorpay account after the owner connects it. Prefer start_payment_oauth, which gives the owner a Razorpay sign-in link.

Connect Stripe

Connect the store owner's own Stripe account. Returns the store's Payments page, where the owner pastes one Stripe restricted key, and the steps page for creating that key. Never ask for or accept a Stripe key in chat. Charges run on the owner's Stripe account and settle to their Stripe balance; LotsCommerce takes 0% of sales. Stripe works in the countries Stripe supports.

Get Payment Settings

Gets safe payment method and order acceptance settings for a store.

Start Payment Provider Connection

Start connecting the store's own Razorpay account: returns a Razorpay sign-in and consent link for the store owner to open in their browser. Payments settle straight to the merchant's Razorpay account.

Start Razorpay Account Onboarding

Get a link for the store owner to open in their browser to sign in to Razorpay, or create a Razorpay account, and connect it to the store. For businesses registered in India. Money from online payments then settles to the owner's own Razorpay account.

Update Payment Settings

Turn checkout on or off, choose test or live mode, and set which payment methods the store offers (Stripe, Razorpay, UPI to a UPI ID, WhatsApp orders) and whether verified payments are accepted automatically. A Stripe key is pasted by the owner on the Payments page, never sent here from a chat.

products

Add Product

Add a product to a store with its variants (for example sizes or colours), prices in minor units of the store currency, stock, images and category. Products start as drafts unless status is published.

Add Product Variant

Creates a variant with options, pricing, identifiers, dimensions, and inventory behavior on an owned product.

Bulk Add Products

Add up to 100 products to a store in one call, each with the same fields as add_product.

create Category

Create a product category, optionally under a parent category.

create Collection

Create a product collection, such as Summer or Best sellers.

delete Category

Delete a product category. Products in it are kept.

delete Collection

Delete a product collection. Its products are kept.

Delete Product

Deletes a product and its derived Lots snapshot after validating store ownership.

Delete Product Variant

Deletes a variant after validating store and product ownership.

Get Product

Get one product with its variants, prices, stock settings, images and categories.

list Categories

List a store's product categories, including parent and subcategories and their order.

list Collections

List a store's product collections.

List Products

List a store's products with search, status filter and paging.

update Category

Rename, move or reorder a product category.

update Collection

Rename a product collection or change its handle.

Update Product

Change a product: title, description, status, prices, variants, images, categories, SEO and more.

Update Product Variant

Updates a variant and its prices after validating store and product ownership.

reviews

List Product Reviews

Lists tenant-scoped product reviews for merchant moderation.

Moderate Product Review

Publishes or rejects a tenant-owned product review.

Reply to Product Review

Adds or updates the merchant reply on a tenant-owned review.

shipping

Get Shipping Settings

Gets tenant-safe business origin, zones, methods, and provider connection summaries.

Update Shipping Settings

Updates business origin, zones, and manual shipping methods.

stores

Archive a store

Archive a store: owner only, confirmed by typing the store name in confirm_name. The storefront goes offline and billing for the store stops; nothing is deleted. The owner can restore it for 30 days. Show the person what this does and get their go-ahead first.

Create Store

Create a store with a free name.lotscommerce.com address. Needs room on the person's LotsCommerce plan or LotsTech Credits (check get_billing). The country decides the store currency (for example US sells in USD, IN in INR) and cannot change later. The store starts as a draft; publish_store puts it live.

Get Store

Gets one LotsCommerce tenant, storefront settings, user role, and public URL.

List Store Activity

Lists recent merchant and commerce activity for an accessible store.

List Stores

Lists LotsCommerce tenants where the authenticated user is an active member.

Publish Store

Put a store's storefront live at its address so shoppers can browse and buy.

Restore an archived store

Restore a store archived in the last 30 days: owner only. It needs room on the person's plan or LotsTech Credits; the storefront comes back online.

Update Store

Update a store's name, description, settings or status. Set status to archived to stop billing for the store and take its storefront offline (nothing is deleted); set it back to draft or active to restore it, which needs room on your plan or LotsTech Credits.

Update Storefront Settings

Saves, publishes, or resets versioned storefront appearance, content, navigation, policies, and SEO settings.

taxes

Get Tax Settings

Gets tenant-safe GST/tax, invoice, and category configuration.

Update Tax Settings

Updates GST registration, pricing, shipping tax, invoice, and tax categories.

team

Accept a store invitation

Accept an invitation to a store's team with the token from the invitation link. The signed-in account's email must match the invitation.

Invite a store teammate

Invite a teammate to a store by email with a role (admin, manager, staff or viewer). They get an email with a link and have access only after they accept it, signed in with that email. Returns invite_url to share if the email does not arrive. Inviting someone again sends a fresh link.

Leave a store

Leave a store's team. Anyone except the owner can leave; the owner archives the store instead. Rejoining needs a new invitation.

List Store Team Members

Lists a store's team: active members, pending invitations (with when they expire) and removed members.

Remove Store Team Member

Deactivates a store team member without deleting audit history.

Update Store Team Member

Updates a store team member role or active status.

REST API Documentation Get API Key