ShopsBuilder
Launch and manage online stores with AI agents: inventory, orders and promotions
Hosted MCP Server
npx add-mcp 'https://mcp.shopsbuilder.app/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
The ShopsBuilder MCP server lets an AI agent such as Claude set up and manage your store: add products, set prices and stock, configure shipping, check orders and sales. The agent signs in as you with OAuth, so it can only reach the stores you own or are an admin of (Admins and shop handover).
Server URL:
https://mcp.shopsbuilder.app/mcp
You need a ShopsBuilder account. If you don't have one, you can create it during the first sign-in.
Add it to Claude
Claude.ai and Claude Desktop
Open ShopsBuilder in the Claude directory, choose Connect and sign in to ShopsBuilder. In a chat, enable ShopsBuilder in the tools menu.
To add it as a custom connector instead:
- Open Settings → Connectors and choose Add custom connector.
- Enter the name
ShopsBuilderand the server URL above, then choose Add. - Choose Connect and sign in to ShopsBuilder in the window that opens.
- In a chat, enable ShopsBuilder in the tools menu.
On Team and Enterprise plans, an owner may need to add the connector in the organization settings first.
Claude Code
claude mcp add --transport http shopsbuilder https://mcp.shopsbuilder.app/mcp
Then run /mcp in Claude Code, select shopsbuilder and sign in.
ChatGPT
Open ShopsBuilder in ChatGPT, connect it and sign in to ShopsBuilder. In a chat, add ShopsBuilder from the + menu.
To add it in developer mode instead:
- Open Settings → Apps → Advanced settings and turn on Developer mode.
- In Settings → Apps, choose Create app, enter the name
ShopsBuilderand the server URL above, and select OAuth authentication. - Choose Create and sign in to ShopsBuilder in the window that opens.
- In a chat, add ShopsBuilder from the + menu.
VS Code and GitHub Copilot
Add the server to mcp.json, then start it and sign in when VS Code asks. Don't add API keys or authorization headers; the client gets its token through OAuth.
{
"servers": {
"shopsbuilder": {
"type": "http",
"url": "https://mcp.shopsbuilder.app/mcp"
}
}
}
Meta Muse
Ask Muse in a chat to add a custom connector with:
- Server URL: the URL above
- OAuth client ID:
management-mcp-muse - Client secret: leave empty (the client uses PKCE)
Then sign in to ShopsBuilder in the window that opens.
Zed, Goose and MCPJam
Add a remote (HTTP) MCP server with the server URL above, then sign in when the client asks. Leave API keys and headers empty.
OpenClaw
Add the server with the ShopsBuilder client document, then sign in from the CLI:
openclaw gateway stop
openclaw mcp set shopsbuilder '{"url":"https://mcp.shopsbuilder.app/mcp","transport":"streamable-http","auth":"oauth","oauth":{"clientMetadataUrl":"https://mcp.shopsbuilder.app/oauth/openclaw-client-metadata.json"}}'
openclaw mcp login shopsbuilder
openclaw mcp doctor shopsbuilder --probe
openclaw gateway start
These commands refuse to run while the Gateway is up, so stop it first. If a step fails, still run openclaw gateway start. Run openclaw mcp login on the machine that runs OpenClaw, so the browser can return to it. Per-requester sign-in isn't supported.
Other clients: write to support.
Signing in
The first time the agent uses ShopsBuilder, your client opens the ShopsBuilder sign-in page at id.shopsbuilder.app. Sign in with your email or Telegram and approve access. The client receives a short-lived token for your account and renews it while you stay connected. Your password is never shared with the client.
Disconnect or revoke access
- In the client: remove or disconnect the ShopsBuilder connector. In Claude, open Settings → Connectors, select ShopsBuilder and choose Disconnect.
- In ShopsBuilder: open your account at id.shopsbuilder.app. Under Applications, remove the client's access, or under Device activity, sign out of all sessions. The client then has to sign in again.
What the agent can do
The agent works on the store you select. If you have one store, it is selected automatically; with several, the agent asks which one to use.
Read:
- your stores and the selected store's settings;
- products, variants, prices, stock, media, categories and product types;
- promotions and sales, warehouses, channels and channel readiness;
- shipping zones and rates;
- orders, order counts, sales summaries and customers.
Change:
- create a store (after showing you a preview and getting your confirmation);
- create products, variants, variant options, categories and product types;
- set prices and stock, add or delete product media, and publish products;
- create and delete promotions and sales;
- create channels and shipping rates, and connect warehouses and shipping zones to channels;
- update the store profile: name, descriptions, logo, cover image, opening hours and links.
Every tool, its class (Read, Write or Sensitive write) and its errors are listed in the MCP tools reference.
Changes go to your live store. Review what the agent proposes before you confirm. Each tool call is recorded in an audit log (tool, store, time and outcome, without the values you sent), as described in our Privacy Policy.
Example prompts
- "Set up my ShopsBuilder store. Sign me in, list my stores, and ask before creating or changing anything."
- "Add a product called Sencha Green Tea, 100 g, priced at 12 USD with 40 in stock, and publish it."
- "Show this week's orders and total sales, and list the products that are out of stock."
- "Create a 15% discount on all teas for the next 7 days."
- "Check whether my store is ready to sell and tell me what is missing."
Troubleshooting
- The sign-in window doesn't open, or the client says authorization failed. Remove the connector, add it again with the exact URL
https://mcp.shopsbuilder.app/mcp, and connect again. Allow pop-ups for the client. - The client asks for an API key or token. Leave it empty. ShopsBuilder uses OAuth only; choose the client's OAuth or "remote HTTP" option.
- The agent says the store is still being set up. A new store takes a few minutes to provision. Wait a moment and ask again.
- The agent works on the wrong store. Ask it to list your stores and select the right one.
- The agent can't do what you asked. Not every store setting is available to agents yet. The agent reports the request to us; you can also email us.
- Something else. Email [email protected] with your sign-in email, store name, AI client and the time of the request. See Support.