Swell MCP server
io.github.devkindhq/swell·v1.1.0·2 starsModel Context Protocol server for Swell e-commerce platform integration with AI assistants
2 stars
Reviews
Write oneNobody has reviewed Swell MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Swell MCP tools (14, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
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_orderwrite actionGet 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_customerwrite actionUpdate 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_statuswrite actionUpdate 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_productwrite actionUpdate 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_pricingwrite actionUpdate 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_stockwrite actionUpdate 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.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan73 source files scanned15/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 136 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (2)
- mediumnpm install lifecycle script present
install.script - mediumnpm install lifecycle script present
install.scriptpackage.json: …& node scripts/ensure-executable.js", "postinstall": "node scripts/ensure-executable.js", …
How Swell MCP compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 58/100
- higher than 13% of 2,174 E-commerce servers
- Tools
- 14
- the typical E-commerce server has 6
- Tools that change things
- 43%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 80% of 1,047 E-commerce servers
What its tools let an agent do: 8 read · 6 change
Install Swell MCP in Claude Code, Cursor or VS Code
Runs npx -y swell-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add swell -- npx -y swell-mcp
What the publisher says
From the Swell MCP repository's README, as published. We do not edit it. Read it on GitHub
Swell MCP Server
A Model Context Protocol server that integrates AI assistants with Swell's e-commerce platform. Built on a production-ready TypeScript foundation, it provides comprehensive access to Swell stores for product management, order processing, and customer management through both CLI and MCP tool interfaces.
Built by Devkind - Official Swell Partners serving businesses globally with cutting-edge e-commerce solutions.
Features
- Swell E-commerce Integration: Complete access to Swell's API for products, orders, and customers
- Dual Transport Support: STDIO and HTTP transports for AI assistant and web integration
- 5-Layer Architecture: Clean separation between CLI, tools, controllers, services, and utilities
- Type Safety: Full TypeScript implementation with Zod schema validation
- Advanced HTTP Client: Built on swell-node SDK with connection pooling and retry logic
- Comprehensive Testing: Unit and integration tests with Swell API mocking
- Production Tooling: ESLint, Prettier, semantic-release, and MCP Inspector integration
- Error Handling: Structured error handling with Swell-specific error contexts
Swell E-commerce Integration
This MCP server provides comprehensive integration with Swell's e-commerce platform:
Available Tools & Commands
MCP Tools:
- swelllistproducts - List products with filtering and pagination
- swellgetproduct - Get detailed product information
- swellsearchproducts - Search products with multiple criteria
- swellcheckinventory - Check product inventory levels
- swelllistorders - List orders with filtering options
- swellgetorder - Get detailed order information
- swellupdateorder_status - Update order status
- swelllistcustomers - List customers with search capabilities
- swellgetcustomer - Get detailed customer information
- swellsearchcustomers - Search customers with multiple criteria
Features Demonstrated
- Product Management: Complete product catalog access with inventory tracking
- Order Processing: Order lifecycle management with status updates
- Customer Management: Customer profiles with order history and analytics
- Error Handling: Structured errors for API failures and validation issues
- Response Formatting: Clean Markdown output with structured data tables
Configuration Requirements
# Required - Swell API credentials
SWELL_STORE_ID=your-store-id
SWELL_SECRET_KEY=your-secret-key
# Development
DEBUG=true # Enable detailed logging
TRANSPORT_MODE=http # Use HTTP transport
PORT=3001 # Custom portNeed Advanced Swell Checkout?
This MCP server demonstrates the kind of sophisticated Swell integrations that power CheckoutJet - an enterprise-grade checkout solution for Swell stores built by Devkind.
CheckoutJet transforms your Swell checkout with:
- 🏢 B2B Excellence - Professional invoicing, Net 30 payments, and wholesale pricing
- 📦 Smart Shipping - Live rates from multiple locations with intelligent order routing
- ⚡ Split Deliveries - Handle complex multi-vendor and multi-warehouse fulfillment
- 🎨 Full Customization - Pixel-perfect, on-brand checkout experience
- 🤖 Automation - Automated invoicing, POs, and order management
- 💰 Advanced Pricing - Dynamic discounts and tiered pricing logic
Proven Results: Over €500,000 processed for Swell merchants with 23% conversion rate improvements.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Swell MCP: common questions
- Is Swell MCP server safe?
- With care: it is graded C, so read the findings first (58/100). Read the Swell MCP safety report
- How do I install Swell MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Swell MCP need an API key?
- Yes. The registry entry asks for
SWELL_SECRET_KEY. - Is Swell MCP maintained?
- The last commit was 173 days ago (2026-05-15). The latest release is v1.1.0.
- What can I use instead of Swell MCP?
- Servers from other publishers that do the same job: Vtex MCP server, Cmssy MCP server and HasData MCP server.
- How does Swell MCP compare with other E-commerce MCP servers?
- safety score 58/100 (higher than 13% of 2,174 E-commerce servers); tools 14 (the typical E-commerce server has 6); tools that change things 43% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Swell MCP
Same job from other publishers: the closest match first, then the best rated.
- not reviewedEstablishedB
- CmssyHosted headless CMS with native commerce: pages, media, forms, products, orders, refunds, discounts.not reviewedGrowingB
- HasDataAll HasData scraping tools in one MCP server: Google, TikTok, Instagram, maps, e-commerce and more.not reviewedGrowingA
Kapruka MCPFree public MCP server for Kapruka.com — Sri Lanka's largest e-commerce platform.not reviewedGrowingB- Google E-commerce (GA4, Search Console, Merchant Center, Ads)Multi-client read and controlled write (off by default): GA4, GSC, Merchant, GTM, ad platforms.not reviewedGrowingB