MCP SERVERRead and edit a Swell store's catalogue, orders and customer records from the client you already work in.
LABSCO SUMMARY
The narrowing is deliberate: swell_update_product will write almost any field, and then swell_update_product_stock and swell_update_product_pricing restate the same job in a smaller shape, so a stock correction cannot quietly rewrite a description. swell_update_product_pricing is also the tool that argues back, refusing a salePrice above price. Order work stops at the status field — swell_update_order_status walks an order through pending, payment_pending, delivery_pending, complete and canceled with a note attached, but nothing here edits line items or issues a refund, so the refund conversation still happens in Swell.
A Swell storefront client covering products, orders and customers, with a read tool and a matching write tool for each.
A Swell store and the API credentials issued for it, supplied as SWELL_STORE_ID and SWELL_SECRET_KEY. DEBUG is also read from the environment.
One command plus a key — npx swell-mcp, then supply credentials
USE CASES
Find the product by name or SKU, confirm what stock is actually recorded against it, then write the correction through the narrow tool rather than the broad one.
Look the person up by name, email or phone, open their profile with the order history attached, and read the order itself for line items, addresses and payment.
Filter the orders that need attention by status and date, open each one, and move it forward with a note recording why.
Walk the catalogue a page at a time, open the products that are thin, and write the description and meta fields back with a record of what changed.
Open the profile you just discussed, then write back the corrected contact details and the marketing preferences the customer asked for.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
swell_check_stockCheck current stock levels and stock status for a specific product in your Swell store. Returns detailed stock information including levels, status, and availability messages. Optionally includes variant-level stock information.
swell_get_customerGet detailed information for a specific customer from your Swell store. Returns comprehensive customer profile including personal information, addresses, order history, and customer analytics. Use this tool when you need complete customer information.
swell_get_orderGet detailed information for a specific order from your Swell store. Returns comprehensive order details including items, customer information, billing and shipping addresses, payment details, and order history. Use this tool when you need complete order information.
swell_get_productGet detailed information for a specific product from your Swell store. Returns comprehensive product details including variants, categories, images, pricing, inventory, SEO information, and custom attributes. Use this tool when you need complete product information.
swell_list_customersList customers from your Swell store with search and filtering options. Supports filtering by email, date range, and various sorting options. Returns a formatted table of customers with basic information including name, email, order count, total value, and registration date.
swell_list_ordersList orders from your Swell store with filtering options. Supports filtering by status, customer, date range, and various sorting options. Returns a formatted table of orders with basic information including order number, customer, status, total, and dates.
swell_list_productsList products from your Swell store with filtering and pagination options. Supports filtering by active status, category, tags, and various sorting options. Returns a formatted table of products with basic information including ID, name, SKU, price, stock status, and availability.
swell_search_customersSearch for customers in your Swell store using text queries. Searches across customer names, email addresses, and phone numbers. Returns ranked results with match information and supports filtering by date range and sorting options.
swell_search_productsSearch for products in your Swell store using text queries with optional filtering. Searches across product names, SKUs, descriptions, and tags. Returns ranked results with match information and supports the same filtering options as product listing.
swell_update_customerUpdate customer information in your Swell store. Allows modification of customer details including name, email, phone, notes, tags, and marketing preferences. Use this tool to correct customer information or update their profile.
swell_update_order_statusUpdate the status of an order in your Swell store. Allows changing order status to pending, payment_pending, delivery_pending, complete, or canceled. Optionally add notes about the status change. Returns the updated order information.
swell_update_productUpdate product information in your Swell store. Allows modification of product details including name, description, pricing, stock, SEO fields, categories, tags, and custom attributes. Returns a summary of changes made with before/after values.
swell_update_product_pricingUpdate pricing information for a product in your Swell store. Allows modification of regular price, sale price, and currency. Includes validation to ensure sale price is not higher than regular price.
swell_update_product_stockUpdate stock-specific information for a product in your Swell store. Allows modification of stock levels, stock status, and stock tracking settings. Use this tool for focused stock management operations.
BEFORE YOU INSTALL
14 tools when we connected. The documentation lists 10; the four undocumented tools are writes: swell_update_product, swell_update_product_pricing, swell_update_product_stock and swell_update_customer. The documented swell_check_inventory is called swell_check_stock.
CONTEXT COST
Rated by the size of the 14 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx swell-mcp{
"mcpServers": {
"swell-mcp": {
"command": "npx",
"args": [
"swell-mcp"
],
"env": {
"SWELL_STORE_ID": "<YOUR_SWELL_STORE_ID>",
"SWELL_SECRET_KEY": "<YOUR_SWELL_SECRET_KEY>"
}
}
}
}code --add-mcp '{"name":"swell-mcp","command":"npx","args":["swell-mcp"],"env":{"SWELL_STORE_ID":"<YOUR_SWELL_STORE_ID>","SWELL_SECRET_KEY":"<YOUR_SWELL_SECRET_KEY>"}}'Go to Advanced settings → Extensions → Add custom extension.
Name it "Swell MCP", use type STDIO, and set the command to npx swell-mcp.
Add your Swell credentials (SWELL_STORE_ID and SWELL_SECRET_KEY) as environment variables.
Click "Add Extension".
MCP servers
LaunchMyStore
amir-bengherbi
freento
Jumpseller