# Swell MCP by usefulapi

> Swell MCP by usefulapi is an MCP server for e-commerce. Manage your Swell headless-commerce store — products, orders, customers, and subscriptions. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/swell/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/swell
- **MCP Registry name:** io.usefulapi/swell
- **Categories:** e-commerce
- **Listing updated:** 2026-11-13

## About

Manage your Swell headless-commerce store — products, orders, customers, and subscriptions.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http swell https://swell.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://swell.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "swell": {
      "url": "https://swell.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "swell": {
      "type": "http",
      "url": "https://swell.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "swell": {
      "serverUrl": "https://swell.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "swell": {
      "type": "http",
      "url": "https://swell.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `swell_list_products`: List products in the store, with MongoDB-style filtering, sorting, search, field selection, and expansion. Swell backend REST API: GET /products.
- `swell_get_product`: Fetch a single product by its record id or its slug. Supports `expand` and `fields`. Swell backend REST API: GET /products/{id}.
- `swell_list_categories`: List product categories, with filtering, sorting, search, and expansion. Swell backend REST API: GET /categories.
- `swell_list_orders`: List orders, with MongoDB-style filtering, sorting, search, and expansion. Swell backend REST API: GET /orders.
- `swell_get_order`: Fetch a single order by its record id or its order number. Supports `expand` and `fields`. Swell backend REST API: GET /orders/{id}.
- `swell_list_customers`: List customers. In Swell, customers are the `accounts` model — this queries GET /accounts, with filtering, sorting, search, and expansion.
- `swell_get_customer`: Fetch a single customer (Swell `accounts` model) by id. Supports `expand` and `fields`. Swell backend REST API: GET /accounts/{id}.
- `swell_list_carts`: List shopping carts (including abandoned carts), with filtering, sorting, and expansion. Swell backend REST API: GET /carts.
- `swell_list_subscriptions`: List subscriptions, with filtering, sorting, and expansion. Swell backend REST API: GET /subscriptions.
- `swell_get_subscription`: Fetch a single subscription by id. Supports `expand`. Swell backend REST API: GET /subscriptions/{id}.
- `swell_list_invoices`: List invoices (typically subscription invoices), with filtering, sorting, and expansion. Swell backend REST API: GET /invoices.
- `swell_list_coupons`: List discount coupons, with filtering and sorting. Swell backend REST API: GET /coupons.
- `swell_query`: Power tool: read-only (GET only) access to ANY Swell model not covered by a dedicated tool — e.g. stock, promotions, giftcards, payments, shipments, settings. Supply the collection name plus the usual list params (limit, page, where, sort, expand, fields, search). Swell backend REST API: GET /{collection}.
- `swell_create_product`: MUTATES LIVE STORE DATA. Create a new product in the store. Provide the common fields directly (name is required); anything else goes in `fields`, which is merged into the request body. Swell backend REST API: POST /products.
- `swell_update_product`: MUTATES LIVE STORE DATA. Partially update an existing product by id. Provide the id plus a `fields` object of attributes to change. Swell backend REST API: PUT /products/{id}.
- `swell_update_order`: MUTATES A LIVE ORDER. Partially update an existing order by id — e.g. change status, fulfillment, or notes. Provide the id plus a `fields` object of attributes to change, e.g. {"status":"complete"}. Swell backend REST API: PUT /orders/{id}.

## FAQ

### How do I add Swell MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http swell https://swell.usefulapi.io/mcp

### What are the best alternatives to Swell MCP by usefulapi?

The closest alternatives to Swell MCP by usefulapi are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/swell-mcp-by-usefulapi
