Model Context Protocol server for Swell e-commerce platform integration with AI assistants
Model Context Protocol server for Swell e-commerce platform integration with AI assistants
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.
Model Context Protocol (MCP) is an open standard for securely connecting AI systems to external tools and data sources. This server implements the MCP specification to provide AI assistants with comprehensive access to Swell's e-commerce platform, enabling intelligent store management and customer service automation.
claude_desktop_config.json: Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| swell_list_products | Description: List products with filtering and pagination |
| swell_get_product | Description: Get detailed product information |
| swell_search_products | Description: Search products with text queries and optional filters |
| swell_check_inventory | Check product inventory levels |
| swell_list_orders | Description: List orders with filtering options |
| swell_get_order | Description: Get detailed order information |
| swell_update_order_status | Description: Update the status of an order (with optional notes) |
| swell_list_customers | Description: List customers with search and filtering options |
| swell_get_customer | Description: Get detailed customer information (profile + optional order history) |
| swell_search_customers | Description: Search customers using text queries (name, email, phone) |
| Purpose | MCP tool definitions that AI assistants can invoke |
| Implementation | Zod schema validation with structured responses |
| Example | swell_list_products tool with filtering and pagination options |
| Pattern | Define schema → Validate args → Call controller → Format MCP response |
| Parameters | customerId plus editable customer fields |
| swell_check_stock | Description: Check current stock levels and stock status for a product |
| swell_update_product | Description: Update product metadata and attributes (name, description, SEO, tags, categories, attributes, active, sku, etc.) |
| swell_update_product_stock | Description: Adjust stock levels or update stock tracking settings |
| swell_update_product_pricing | Description: Update product pricing (regular price, sale price, currency) |
| swell_update_customer | Description: Update customer records (name, email, phone, tags, groups, marketing opt-ins, notes) |
{
"mcpServers": {
"swell-mcp": {
"command": "npx",
"args": [
"swell-mcp"
],
"env": {
"DEBUG": "false",
"SWELL_STORE_ID": "your_store_id",
"SWELL_SECRET_KEY": "YOUR_SWELL_SECRET_KEY"
},
"disabled": false
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
claude_desktop_config.json: | Variable | Description | Required |
|---|---|---|
| DEBUG | Declared in the maintainer’s client configuration. | Optional |
| SWELL_STORE_ID | Declared in the maintainer’s client configuration. | Yes |
| SWELL_SECRET_KEY | Declared in the maintainer’s client configuration. | Yes |
Access Stripe billing and payment tools through its MCP server. Connect with OAuth or a supported agent API key and choose the intended account.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Put 6,000+ pre-built scrapers at your assistant's fingertips through one MCP endpoint.
Build for Shopify with current APIs — the official Dev MCP server for schema-accurate storefront and admin code.
Give your AI assistant a supervised window into your Interactive Brokers account — balances, positions, live quotes and orders.
Invoices, payments and disputes through PayPal's official server — commerce operations by conversation.