SparkLayer
Manage your SparkLayer B2B store from any AI app: price lists and SKU prices, discounts, customer groups, companies, quotes, orders and stock. Remote server with OAuth sign-in.
Hosted MCP Server
npx add-mcp 'https://mcp.sparklayer.io/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
SparkLayer MCP
URL: https://docs.sparklayer.io/help/ask-sparklayer/mcp
Add SparkLayer to Claude from its connector directory, or connect ChatGPT or another AI app, so it can read your store data and make the changes you confirm.
Quick summary
- The SparkLayer MCP connects AI apps such as Claude, ChatGPT and Cursor to your SparkLayer store. A connected app can read your store data and, when you ask, create, change or delete it.
- In Claude, SparkLayer is in the connector directory: find it and click Connect, with no server address to enter. In other apps, you add it with the server address.
- You then sign in to SparkLayer, and choose the stores the app can use and whether it works on live or test data.
- The app shows you each change and waits for you to confirm it. Check every change before you say yes: the app works on your real data.
- To see or disconnect your connected apps, go to Account menu > Connections in the SparkLayer Dashboard (open).
How it works
MCP (Model Context Protocol) is the open standard AI apps use to connect to other services. The SparkLayer MCP is SparkLayer's MCP server. Once you connect an AI app to it, the app can use SparkLayer from its own chat, on the stores you allowed.
How a connected AI app makes a change:
- Ask: Describe what you want in Claude, ChatGPT or another AI app
- Read: It reads your store data through the SparkLayer MCP
- Confirm: It shows you what it will change and waits for your answer
- Change: It makes the change on the store and environment you allowed
The server address is:
https://mcp.sparklayer.io/mcp
What a connected app can do
| Area | It can read | It can change |
|---|---|---|
| Price lists | Price lists, their rules and SKU prices | Create and edit price lists, set and remove SKU prices, delete price lists |
| Discounts | Discounts, with their rewards, rules and schedule | Create, edit, copy, reorder and delete discounts |
| Customer groups | Customer groups and their settings | Create, edit and delete customer groups |
| Customers | B2B customers and sales reps, with their roles, groups, price lists and addresses | Give a B2B customer a role. Create, edit and delete sales rep roles |
| Companies | Companies, company admins and sections | Create, edit and delete companies and sections. Add B2B customers to sections and change their role there |
| Orders | Orders, quotes and carts | Nothing |
| Products and stock | Products, variants and stock levels | Nothing |
| Checkout | Quote statuses, shipping methods and country regions | Create and edit quote statuses. Create, edit and delete shipping methods |
| Store settings | Store settings, your plan, team members and API key names | Nothing |
| Themes | Email and PDF themes and their template files | Create, rename and publish themes. Delete themes and template files |
A connected app can't change store settings, products, stock, orders or B2B customers' details. Make those changes in the SparkLayer Dashboard. It never sees an API key's client secret. Some areas need a paid plan: see Plans and limits.
How changes stay safe
- The app asks first. SparkLayer tells the app to show you what it will change and to wait for you to confirm. Check the details it shows, such as prices and customer groups, before you say yes.
- Keep your app's approvals on. SparkLayer can't see your chat, so it can't check what the app showed you. Most AI apps can ask before they use a tool that changes data. Leave that on for SparkLayer.
- Start on test. Connect with Test to try things without changing what buyers see.
- There's no undo. To reverse a change, ask the app to change it back, or edit it in the SparkLayer Dashboard. A deleted discount, shipping method or customer role can't be restored.
- Some changes are refused. For example, the app can't delete your published theme, a shipping method a discount uses, or a customer group that has B2B customers in it.
Your data
A connected app sends what it reads to its AI provider, such as Anthropic or OpenAI, under that provider's terms. That can include B2B customers' names and email addresses, order details and your team members' names. Only connect apps your business allows to handle this data.
B2B customer, company, order, product and theme details can contain text that other people wrote. SparkLayer tells the app never to follow instructions it finds in them.
Connect an AI app
You need a SparkLayer account on the store's team. The app works with your access, on the stores you choose.
- Add SparkLayer to your AI app: from the connector directory in Claude, or with the server address in other apps. The tabs below show how for each app.
- The app opens SparkLayer in your browser. Sign in if SparkLayer asks you to.
- Choose the stores the app can access. SparkLayer lists them as teams on this page.
- For each store, choose Live or Test. See Choose live or test data.
- Check what the app will be able to do, then click Allow.
- Go back to the app and ask a question, such as "Which price lists do I have?"
Claude:
SparkLayer is in Claude's connector directory, so you don't need the server address.
- Open SparkLayer in the Claude directory, and sign in to Claude if it asks. Or, in Claude, go to Customize > Connectors, click + next to Connectors and search for SparkLayer.
- Click Connect. Claude opens SparkLayer for you to allow access.
On the Team and Enterprise plans, an Owner first adds SparkLayer for everyone: in Organization settings > Connectors, click Browse connectors, choose SparkLayer and click Add to your team. Each member then connects it from Customize > Connectors. If you can't add connectors yourself, click Request on SparkLayer's directory page to ask an Owner.
To use SparkLayer in a chat, click +, then Connectors, and turn it on. Once connected, it also works in Claude Desktop and the Claude mobile app.
More detail
- SparkLayer is a Community connector in the directory: SparkLayer builds and runs it, and Anthropic checks it automatically.
- If you added SparkLayer before as a custom connector, it keeps working. To avoid having it twice, remove the custom one at Customize > Connectors before you connect from the directory.
- Owners on the Team and Enterprise plans can set each SparkLayer tool to Always allow, Needs approval or Blocked on the connector's Tools tab in Organization settings > Connectors. Set the tools that change data to Needs approval, or Blocked for read-only access.
ChatGPT:
- In ChatGPT, open Plugins.
- Click +, then Add custom MCP server.
- Enter a name, such as SparkLayer, and a description.
- Under Connection, enter the server address.
- Set up OAuth sign-in, read the warning, and click I understand and want to continue.
- Click Create as a plugin, then sign in to SparkLayer when ChatGPT asks.
Your ChatGPT plan and workspace settings decide whether you can add a custom MCP server. On a Business or Enterprise workspace, an admin may need to allow it first.
When SparkLayer adds or changes tools, open the server in Plugins and click Refresh.
Claude Code:
Run this once:
claude mcp add --transport http sparklayer https://mcp.sparklayer.io/mcp
Then run /mcp in Claude Code, choose sparklayer and sign in. Add --scope user to the command to use SparkLayer in every project.
Cursor:
Add the server to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project), then sign in to SparkLayer when Cursor asks:
{
"mcpServers": {
"sparklayer": {
"url": "https://mcp.sparklayer.io/mcp"
}
}
}
This works in the Cursor desktop app. Cursor on the web and Cursor Agents can't connect yet.
VS Code:
Add the server to .vscode/mcp.json in your project, start it from the file, then sign in to SparkLayer when VS Code asks:
{
"servers": {
"sparklayer": {
"type": "http",
"url": "https://mcp.sparklayer.io/mcp"
}
}
}
Other apps:
Any app that connects to remote MCP servers with OAuth sign-in can use the server address, if it registers itself with SparkLayer. For example, Codex:
[mcp_servers.sparklayer]
url = "https://mcp.sparklayer.io/mcp"
Then run codex mcp login sparklayer. Gemini CLI takes the server in settings.json:
{
"mcpServers": {
"sparklayer": {
"httpUrl": "https://mcp.sparklayer.io/mcp"
}
}
}
Then run /mcp auth sparklayer. Apps that need a client ID and secret from SparkLayer can't connect, and the Gemini app can't connect yet.
More detail
- If you have one team, SparkLayer shows it instead of a list.
- If SparkLayer shows SparkLayer doesn't recognize and the app's name, check that you started the connection from an app you trust. Only allow access if you do.
Choose live or test data
Each store you allow works on one environment:
| Environment | What it means |
|---|---|
| Live | Your live store. Changes are what buyers see the next time a page loads. |
| Test | Your test store. Buyers on your live store don't see the changes. Use it to try a change first. |
SparkLayer chooses Live to start with, or Test if the store has no live environment. One app can't use live and test data of the same store at once. To switch, connect again from the app and choose the other one. For more about test stores, see Test mode.
Ask your connected app
Ask in your own words, and name price lists, customer groups and SKUs as they are in SparkLayer. For example:
- "Which of my customer groups don't have a minimum order?"
- "Compare my Trade and Key Accounts price lists and tell me which SKUs differ."
- "Here's our ERP price export. Set these SKU prices on the Trade price list."
- "List my latest quotes and who they're for."
- "Create a 10% discount for the Distributors customer group."
You can give it long jobs, such as setting hundreds of SKU prices from a spreadsheet.
See and disconnect connected apps
- Go to Account menu > Connections in the SparkLayer Dashboard (open).
- Connected apps lists each app you connected and the stores it can access.
- To remove an app, click Disconnect, then click Disconnect again to confirm.
The app loses access straight away. Changes it made stay in place. To use it again, connect it again from the app.
More detail
- Each person manages their own connections. You only see the apps you connected.
- To change an app's stores, or switch between live and test, connect it again from the app. Your new choice replaces the old one.
- Changing or resetting your password disconnects every app.
- If you don't use an app for a month, it has to sign in again.
Plans and limits
| Feature | Plan |
|---|---|
| Discounts, shipping methods and sales rep roles | Starter and above |
| Some discount types and settings | Growth or Pro |
| Themes, and API keys in store settings | Pro and above |
If your plan doesn't include a feature, the app tells you which plan it needs. An app can make 60 requests a minute to SparkLayer.
For developers
Building an integration? Connect the SparkLayer MCP to your coding assistant alongside the docs MCP server. The docs server tells it how the APIs work, and the SparkLayer MCP shows it your real price lists, customer groups and SKUs, so it maps your data correctly. The ready-made prompts already ask assistants to use it when it's connected.
The SparkLayer MCP uses streamable HTTP and OAuth 2.1 with dynamic client registration and PKCE. Every tool works on one store and its environment, so an app calls list-sites first. It has these tools:
| Area | Read | Change |
|---|---|---|
| Stores | list-sites | |
| Price lists | get-price-lists, get-prices | save-price-list, set-prices, delete-price-list, delete-price-list-prices |
| Discounts | get-discounts | save-discount, delete-discount |
| Customer groups | get-customer-groups | save-customer-group, delete-customer-group |
| Customers | get-customers, get-customer-roles | save-customer-role, set-customer-role, delete-customer-role |
| Companies | get-companies | save-company, save-company-section, set-company-section-user, delete-company, delete-company-section-data |
| Orders | get-purchases | |
| Products and stock | get-products, get-stock | |
| Checkout | get-checkout-settings | save-quote-status, save-shipping-method, delete-shipping-method |
| Store settings | get-site-settings | |
| Themes | get-themes, get-theme-files | save-theme, delete-theme, delete-theme-file |
set-prices takes up to 1,000 SKU and price list pairs a call.
FAQs
Is this the same as the docs MCP server?
No. The docs MCP server only searches and reads these docs. The SparkLayer MCP works on your store: it reads your store data and makes the changes you confirm.
Can a connected app change my live store without me?
Yes, if you allow live data. SparkLayer tells the app to show you each change and wait for you to confirm, but the app makes the call. Connect with Test, and keep your app's approvals on, to stay in control.
Can it see my orders or customers' details?
Yes. A connected app can read orders, quotes and carts, and B2B customers' details such as names, email addresses and addresses. It can't change orders or B2B customers' details.
Can I give an app read-only access?
Not from SparkLayer. Every connected app can read and change data on the stores you allow. To limit what it changes, connect it with Test, or block SparkLayer's tools that change data in your AI app's settings. In Claude on the Team and Enterprise plans, an Owner can block them for everyone: see the Claude tab under Connect an AI app.
Which AI apps can I connect?
Apps that connect to remote MCP servers with OAuth sign-in, such as Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex and Gemini CLI. The Gemini app and Cursor Agents can't connect yet.
Does disconnecting an app undo its changes?
No. Its changes stay in place. To reverse them, ask the app to change them back before you disconnect it, or edit them in the SparkLayer Dashboard.
Troubleshooting
If these steps don't fix it, see Get help.
The app can't connect, or asks you to sign in again
In Claude, connect SparkLayer from the directory. In other apps, check that the server address is exactly https://mcp.sparklayer.io/mcp. Then connect again from the app, and finish signing in to SparkLayer in the browser window it opens. This also fixes This connection request is not valid, and an app that lost its connection, for example after you changed your password.
Some apps can't connect yet: see Which AI apps can I connect?
SparkLayer shows "SparkLayer staff accounts can't connect to the MCP"
You're signed in to SparkLayer with a SparkLayer staff account, and staff accounts can't connect an AI app. Sign out of SparkLayer, sign in with an email that isn't a SparkLayer staff account, then connect again from the app.
SparkLayer shows an error instead of your stores
You're probably signed in with restricted access. You get it when you open SparkLayer from your Shopify admin or Wix dashboard with an email that isn't on the store's team. An AI app can't connect from restricted access.
Sign out of SparkLayer, then sign in at app.sparklayer.io with an email that's on the store's team, and connect again from the app. If you don't have one, ask the team owner to invite you.
The app says your plan doesn't include a feature
Your store's plan doesn't include that feature. See Plans and limits for the plan each feature needs, and Your plan and usage for your store's plan.
The app can't use a store, or says "Reconnect and select this site"
The app can only use the stores you chose when you connected it. It also loses a store when you leave the store's team, or when the store's live or test environment is removed. Connect again from the app and choose every store you want it to use.
The app stops partway through a long job
An app can make 60 requests a minute to SparkLayer for you. Above that, SparkLayer refuses its requests until the minute is up, and the app may show an error such as 429 or "too many requests".
Wait a minute, then ask the app to carry on from where it stopped. For large price changes, ask it to send up to 1,000 SKU prices at a time.
Get help
Email support@sparklayer.io, or click the message icon in the SparkLayer Dashboard. Tell us which AI app you use and what it showed you. See Contact support for when we reply.
To report a security vulnerability, email the same address with "URGENT - Security" in the subject. See our security.txt and incident management policy.