swell_list_products
List products
List products in the store, with MongoDB-style filtering, sorting, search, field selection, and expansion. Swell backend REST API: GET /products.
pagesortlimitwhereexpandfieldssearchio.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.5Updated Nov 8, 2026
Manage your Swell headless-commerce store — products, orders, customers, and subscriptions.
The publisher's own server: Ably MCP by usefulapi
Hosted MCP server for a Swell headless-commerce store: lets an assistant read products, orders, customers, carts and subscriptions, and create or update…
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.usefulapi%2Fswell/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"swell-by-usefulapi": {
"type": "http",
"url": "https://swell.usefulapi.io/mcp"
}
}
}Manage your Swell headless-commerce store — products, orders, customers, and subscriptions — from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Swell store ID + secret key.
Live endpoint: https://swell.usefulapi.io/mcp · Homepage: https://usefulapi.io/swell
https://swell.usefulapi.io/mcp.claude mcp add --transport http swell https://swell.usefulapi.io/mcp, then run /mcp to log in.Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Swell credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/swell/
On first connect you'll paste your Swell store ID and secret key. It's validated, stored per-user, and scoped to you.
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with swell_upgrade (it returns a Stripe Checkout link). Cancel any time with swell_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running swell_upgrade before then undoes the cancel. Or write to [email protected].
MIT — see LICENSE. Documentation only; the server is hosted.
Source: servers/swell/README.md at commit 4046075
List products
List products in the store, with MongoDB-style filtering, sorting, search, field selection, and expansion. Swell backend REST API: GET /products.
pagesortlimitwhereexpandfieldssearchGet a product
Fetch a single product by its record id or its slug. Supports `expand` and `fields`. Swell backend REST API: GET /products/{id}.
idrequiredexpandfieldsList categories
List product categories, with filtering, sorting, search, and expansion. Swell backend REST API: GET /categories.
pagesortlimitwhereexpandsearchList orders
List orders, with MongoDB-style filtering, sorting, search, and expansion. Swell backend REST API: GET /orders.
pagesortlimitwhereexpandsearchGet an order
Fetch a single order by its record id or its order number. Supports `expand` and `fields`. Swell backend REST API: GET /orders/{id}.
idrequiredexpandfieldsList customers
List customers. In Swell, customers are the `accounts` model — this queries GET /accounts, with filtering, sorting, search, and expansion.
pagesortlimitwhereexpandsearchGet a customer
Fetch a single customer (Swell `accounts` model) by id. Supports `expand` and `fields`. Swell backend REST API: GET /accounts/{id}.
idrequiredexpandfieldsList carts
List shopping carts (including abandoned carts), with filtering, sorting, and expansion. Swell backend REST API: GET /carts.
pagesortlimitwhereexpandList subscriptions
List subscriptions, with filtering, sorting, and expansion. Swell backend REST API: GET /subscriptions.
pagesortlimitwhereexpandGet a subscription
Fetch a single subscription by id. Supports `expand`. Swell backend REST API: GET /subscriptions/{id}.
idrequiredexpandList invoices
List invoices (typically subscription invoices), with filtering, sorting, and expansion. Swell backend REST API: GET /invoices.
pagesortlimitwhereexpandList coupons
List discount coupons, with filtering and sorting. Swell backend REST API: GET /coupons.
pagesortlimitwhereQuery any collection (read-only)
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}.
pagesortlimitwhereexpandfieldssearchcollectionrequiredCreate a 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.
skunamerequiredtypepriceactivefieldsdescriptionstock_levelUpdate a 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}.
idrequiredfieldsrequiredUpdate an 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}.
idrequiredfieldsrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
io.usefulapiOfficial publisher
Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant read Tiltify campaigns, donations and top donor and fundraiser leaderboards.
io.usefulapiOfficial publisher
Hosted Termii server that lets an assistant send SMS, check wallet balance, DND status, sender IDs and message history.
io.usefulapiOfficial publisher
Hosted MCP server that lets an assistant read Temp Stick temperature and humidity sensors, their readings and alert notifications.
io.usefulapiOfficial publisher
Connects an assistant to a Stibee email marketing workspace to read address books, subscribers and email stats, and to add subscribers and group members.
{ "mcpServers": { "swell": { "url": "https://swell.usefulapi.io/mcp" } }}