Swell MCP
Give your AI a direct line into your Swell store. Manage products, orders, and customers through natural conversation.Read full description
devkindhqLABSCO SUMMARY
A store's whole admin surface, reachable in one sentence.
This is not a read-only reporting connector: the same token that lists your orders can refund one, rewrite a product description, edit a theme file or open a POS shift, so the scopes you choose when you mint it are the real boundary. The skill exists so an assistant picks the right surface for what you asked — the CLI for scaffolding an app, Functions for a discount rule, MCP for anything touching live store data.
What it is
Two things in one repository. The skill is an intent router: you describe what you want and it loads the matching reference — the lms CLI, the App Bridge admin SDK, the six WASM Function types, Aqua theme authoring, or the merchant MCP server. The MCP server is LaunchMyStore's own and hosted, reached over SSE with a merchant bearer token, and it is where the 130-plus tools that actually operate a store live. The skill follows the SKILL.md standard, so the same files work in Claude Code, Claude.ai, the Claude API, Codex, Cursor, Gemini CLI and other hosts that read it.
What you get
- Products created, updated and exported, with variants, options and metafields, descriptions generated, copy rewritten for SEO, and a listing built from a product image
- Orders read, created by hand, updated and refunded, including the abandoned ones
- Customers, wallet credit and credit history, newsletter subscribers and contact exports
- Catalog content — categories, blogs, pages, FAQs, policies, menus and snippets
- Themes: sections and blocks listed, created, reordered and configured, and theme files read and written directly
- Analytics for sales, products, traffic and the dashboard, plus a nightly briefing, review summaries and a conversational query over your own numbers
- Store settings: shipping zones, taxes, payment providers, checkout, warehouses, webhooks, staff and store details
- POS shifts, selling plans and subscriptions, coupons, and work scheduled for later approval
- Marketplace and developer apps installed, created, versioned and submitted for review, with their functions uploaded and tested
Requirements
A LaunchMyStore merchant account. The MCP server is hosted at api.launchmystore.io and takes a long-lived bearer token that you mint from a merchant session, with the read and write scopes you choose at that moment. It speaks the SSE flavour of MCP, so the client entry is an sse type pointed at /mcp/sse rather than /mcp — the project names that as the usual misconfiguration. The skill files themselves are MIT and need no account to read.
Setup effort
One command plus a key — npm install -g @launchmystore/claude-skill, then supply credentials
USE CASES
01
Running a promotion end to end
Pull the products in scope, create the discount code, and mark the products so the offer is visible on the storefront.
02
Handling a refund request
Find the order from what the customer told you, open it to confirm the lines and amounts, then refund it.
03
Working out why the numbers moved
Compare this week's sales against last week's and ask follow-up questions against the same data rather than exporting it.
04
Turning a product photo into a listing
Build the listing from the image, create the product, then have the description written and the copy rewritten for search.
05
Editing the storefront theme
List the theme's files, read the one you need, and write the change back or add a new section outright.
06
Catching up on the store each morning
Read the overnight briefing, see which carts were abandoned, and get the new reviews summarised instead of read one by one.
BEFORE YOU INSTALL
What to know first
Requires
- npm on PATH
- A LaunchMyStore store (merchant account) to generate the MCP token from
INSTALLATION
Connect your client
Server setup
npm
All supported tools
TERMINAL
npm install -g @launchmystore/claude-skillHosted endpoint
ENDPOINT URL
https://api.launchmystore.io/mcp/sseAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Claude Code
CLAUDE CODE · IN CLIENT
/plugin marketplace add LaunchMyStore/skill
/plugin install launchmystore@launchmystoreClaude.ai
Download the latest release zip and upload it as a Skill in Settings → Capabilities → Skills
Claude API
Bundle the SKILL.md + references/ + examples/ into your skill folder when calling the Messages API with tools: [{ type: 'skill', ... }]
Codex
CODEX · TERMINAL
git clone https://github.com/LaunchMyStore/skill ~/.codex/skills/launchmystoreCursor
CURSOR · TERMINAL
git clone https://github.com/LaunchMyStore/skill ~/.cursor/skills/launchmystoreGemini CLI
GEMINI CLI · TERMINAL
git clone https://github.com/LaunchMyStore/skill ~/.gemini/skills/launchmystoreOpenClaw
OPENCLAW · TERMINAL
git clone https://github.com/LaunchMyStore/skill ~/.openclaw/workspace/skills/launchmystore
openclaw gateway restartClaude Code — Merchant MCP Server
Open your LaunchMyStore admin.
Navigate to Settings → AI Connector (MCP).
Click Generate token.
Copy the token shown — it's a long opaque string valid for 1 year.
Claude Code — create a .mcp.json at the root of your project (or add to ~/.claude.json for user scope), paste the snippet, and run /mcp inside Claude Code to confirm the connection.
CLAUDE CODE — MERCHANT MCP SERVER · JSON
{
"mcpServers": {
"launchmystore": {
"type": "sse",
"url": "https://api.launchmystore.io/mcp/sse",
"headers": {
"Authorization": "Bearer <YOUR_MCP_TOKEN>"
}
}
}
}Cursor — Merchant MCP Server
Open your LaunchMyStore admin.
Navigate to Settings → AI Connector (MCP).
Click Generate token.
Copy the token shown — it's a long opaque string valid for 1 year.
Cursor — open Cursor settings (Cmd+, / Ctrl+,), search for MCP, and paste the snippet into your MCP servers config.
CURSOR — MERCHANT MCP SERVER · JSON
{
"mcpServers": {
"launchmystore": {
"type": "sse",
"url": "https://api.launchmystore.io/mcp/sse",
"headers": {
"Authorization": "Bearer <YOUR_MCP_TOKEN>"
}
}
}
}
