What is Swell MCP and what does it do?
Swell MCP is a Model Context Protocol server that connects AI assistants to Swell's e-commerce platform. It provides tools to manage products, orders, and customers through natural language commands.
Swell MCP Server
@devkindhq
Basic information
About Swell MCP Server
No overview available yet
Swell MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"swell-mcp": {
"command": "npx",
"args": [
"swell-mcp"
],
"env": {
"SWELL_STORE_ID": "",
"SWELL_SECRET_KEY": ""
}
}
}
}Swell MCP Server tools
14List products with filtering and pagination
Get detailed product information
Search products with text queries and optional filters
Check current stock levels and stock status for a product
Update product metadata and attributes (name, description, SEO, tags, categories, attributes, active, sku, etc.)
Adjust stock levels or update stock tracking settings
Update product pricing (regular price, sale price, currency)
List orders with filtering options
Get detailed order information
Update the status of an order (with optional notes)
List customers with search and filtering options
Get detailed customer information (profile + optional order history)
Search customers using text queries (name, email, phone)
Update customer records (name, email, phone, tags, groups, marketing opt-ins, notes)
Overview
What is Swell MCP?
Swell MCP is a Model Context Protocol server that integrates AI assistants with Swell's e-commerce platform. It provides comprehensive access to Swell stores for product management, order processing, and customer management through both CLI and MCP tool interfaces. It is built by Devkind, official Swell Partners.
How to use Swell MCP?
Install the server by running npx swell-mcp in any MCP client (Claude Desktop, Cursor, VS Code, Windsurf, Goose, LM Studio, Warp). Configure the environment variables SWELL_STORE_ID and SWELL_SECRET_KEY with your Swell credentials. Once installed, you can use the provided MCP tools (e.g., swell_list_products, swell_get_order) directly through your AI assistant.
Key features of Swell MCP
- Complete Swell API access for products, orders, and customers
- Dual transport support: STDIO and Streamable HTTP with SSE
- Full TypeScript implementation with Zod schema validation
- Structured error handling with Swell-specific error contexts
- Debug mode for raw JSON responses
- Production-ready tooling: ESLint, Prettier, semantic-release, MCP Inspector
Use cases of Swell MCP
- List and search products with filtering and pagination
- Check inventory levels for specific products
- Process orders and update their status via natural language
- Search customer profiles and retrieve order history
- Integrate Swell store management into custom MCP clients
Frequently asked questions
What are the runtime requirements?
Node.js 18 or newer, a compatible MCP client (e.g., VS Code, Claude Desktop, Cursor), and Swell store credentials (Store ID and Secret Key).
How do I get Swell credentials for the server?
Log into your Swell dashboard at login.swell.store, go to Developer β API Keys, and copy your Store ID and Secret Key. Use the backend/admin key, not the public key.
What transport modes does Swell MCP support?
Swell MCP supports two transport modes: STDIO (JSON-RPC via stdin/stdout, used by local AI assistants) and Streamable HTTP (Server-Sent Events, configurable port, default 3000).
Where does my data live when using Swell MCP?
The server acts as a bridge between the AI assistant and your Swell store. It communicates directly with Swell's API; no data is stored by the server itself.
More Other MCP servers
π Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
16.7K
Health by Dr Brad
Dr Brad StanfieldHealth by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one
Yuppsy
Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code
N
Next Generation Movers: free moving quotes (remote MCP)
Next Generation MoversFree moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
Klarix Intelligence Engine
KlarixB2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.
Comments