Medusa vs Swell MCP
A side-by-side look at the Medusa and Swell MCP MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
M
MedusaE-Commerce · Local subprocess (stdio)Medusa v2 store: orders, customers, products, inventory, sales reports and safe write actions.57GoodAuth: oauth 2.0Verdict: choose Medusa for e-commerce work as a local process; choose Swell MCP for e-commerce as a local process. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
MChoose Medusa when
- You need dedicated capabilities in the E-Commerce domain.
- You prefer a local stdio subprocess transport.
- Its auth model fits you: OAuth 2.0.
- You have the keys it needs:
MEDUSA_READ_ONLY, MEDUSA_RAW_API, MEDUSA_TOOLSETS, REPORT_TIMEZONE, MEDUSA_CONFIRM_DESTRUCTIVE. - You want tools like
get_store_info, list_orders, list_customers.
Choose Swell MCP when
- You need dedicated capabilities in the E-Commerce domain.
- You prefer a local stdio subprocess transport.
- You have the keys it needs:
SWELL_STORE_ID, SWELL_SECRET_KEY, DEBUG, TRANSPORT_MODE, PORT. - You want tools like
swell_list_products, swell_get_product, swell_search_products.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | M Medusa | |
|---|---|---|
| Category | E-Commerce | E-Commerce |
| Quality signal | 57/100 · Good | 57/100 · Good |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | OAuth 2.0 | Not declared |
| Pricing | Free | Not declared |
| Required env vars | MEDUSA_READ_ONLYMEDUSA_RAW_APIMEDUSA_TOOLSETSREPORT_TIMEZONEMEDUSA_CONFIRM_DESTRUCTIVE | SWELL_STORE_IDSWELL_SECRET_KEYDEBUGTRANSPORT_MODEPORT |
| Verified owner | Community listing | Community listing |
| GitHub stars | 0 | 2 |
| Directory activity | 0 views 0 installs 0 upvotes | 1 views 0 installs 0 upvotes |
| Tools | 12 | 14 |
| Full listing | View Medusa | View Swell MCP |
Tools & capabilities
Medusa tools 12
get_store_inforegions and currencies, sales channels, stock locations, shipping options and profiles, return and refund reasonslist_ordersorders by full-text, date range, customer or status; full detail by ID or order number (`1042`) with payments, refunds, discount codes and returnslist_customerscustomers (also by group or e-mail), order history, total spentlist_customer_groupscustomer groupslist_productsproducts by status, collection, category or tag; variants, options, prices, images, inventory items (by ID or handle)list_catalogcategories (tree), collections, tags, product typeslist_inventorystock per location, `low_stock_threshold` to find what's running outlist_promotionsdiscount codes with conditions, usage and validity; sale and customer-group price listssales_reportrevenue, net revenue after refunds, AOV, units, customers – **compared with the previous period or last year**, day/week/month series, top products and variants, countries, discount codes, sales channels · *interactive dashboard*customer_reportnew vs returning customers, repeat purchase rate, top customers, lapsed customers worth winning backinventory_forecastsales velocity vs stock: days of cover, out-of-stock / reorder-now / reorder-soon, suggested order quantities, slow movers · *interactive restock planner*medusa_requestany Admin API endpoint (`GET`, `POST`, `DELETE` under `/admin/`) for things without a dedicated tool – reservations, exchanges, tax rates… Read-only mode allows `GET` only; writes to `api-keys`, `users` and `invites` are always blocked. Turn it off with `MEDUSA_RAW_API=false`.
Swell MCP tools 14
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_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_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_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_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_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.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_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_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_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_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_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.- +2 more on the listing page
Ready-to-paste client configs
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
Medusa
{
"mcpServers": {
"medusa": {
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_READ_ONLY": "YOUR_MEDUSA_READ_ONLY_HERE",
"MEDUSA_RAW_API": "YOUR_MEDUSA_RAW_API_HERE",
"MEDUSA_TOOLSETS": "YOUR_MEDUSA_TOOLSETS_HERE",
"REPORT_TIMEZONE": "YOUR_REPORT_TIMEZONE_HERE",
"MEDUSA_CONFIRM_DESTRUCTIVE": "YOUR_MEDUSA_CONFIRM_DESTRUCTIVE_HERE"
}
}
}
}
Swell MCP
{
"mcpServers": {
"swell-mcp": {
"command": "npx",
"args": [
"-y",
"swell-mcp"
],
"env": {
"SWELL_STORE_ID": "YOUR_SWELL_STORE_ID_HERE",
"SWELL_SECRET_KEY": "YOUR_SWELL_SECRET_KEY_HERE",
"DEBUG": "YOUR_DEBUG_HERE",
"TRANSPORT_MODE": "YOUR_TRANSPORT_MODE_HERE",
"PORT": "YOUR_PORT_HERE"
}
}
}
}
Frequently asked questions
Medusa is categorized under E-Commerce and uses a local stdio subprocess. Swell MCP belongs to E-Commerce and uses a local stdio subprocess. Pick Medusa for e-commerce work and Swell MCP for e-commerce.
Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.
Medusa is listed as free. Auth: oauth 2.0. Swell MCP has no declared pricing — check the project's own site. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.
Yes. MCP clients support multiple servers: add medusa and swell-mcp as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, Medusa has a quality signal of 57/100 (Good) with 0 views, 0 installs and 0 GitHub stars. Swell MCP has 57/100 (Good) with 1 views, 0 installs and 2 GitHub stars.
