swell

by io.usefulapi

Server Details

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

Status: Healthy
Last Tested: 2026-07-21 15:31
Transport: Streamable HTTP
URL
Repository: m190/usefulapi-mcp
GitHub Stars: 0

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client

Glama

MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.

Tool Definition Quality

Score is being calculated. Check back soon.

Available Tools

16 tools

swell_create_productCreate a product

Destructive

Inspect

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.

ParametersJSON Schema

Name	Required	Description
`sku`	No	Stock-keeping unit.
`name`	Yes	Product name (required).
`type`	No	Product type, e.g. "standard", "subscription", "digital".
`price`	No	Product price.
`active`	No	Whether the product is active/visible.
`fields`	No	Any additional product fields, merged into the request body (e.g. attributes, options, images).
`description`	No	Product description.
`stock_level`	No	Available stock quantity.

swell_get_customerGet a customer

Read-only

Inspect

Fetch a single customer (Swell accounts model) by id. Supports expand and fields. Swell backend REST API: GET /accounts/{id}.

ParametersJSON Schema

Name	Required	Description
`id`	Yes	Customer (account) id.
`expand`	No	Comma-separated related fields to expand, e.g. "orders,subscriptions".
`fields`	No	Comma-separated fields to return.

swell_get_orderGet an order

Read-only

Inspect

Fetch a single order by its record id or its order number. Supports expand and fields. Swell backend REST API: GET /orders/{id}.

ParametersJSON Schema

Name	Required	Description
`id`	Yes	Order id or order number.
`expand`	No	Comma-separated related fields to expand, e.g. "items,account".
`fields`	No	Comma-separated fields to return.

swell_get_productGet a product

Read-only

Inspect

Fetch a single product by its record id or its slug. Supports expand and fields. Swell backend REST API: GET /products/{id}.

ParametersJSON Schema

Name	Required	Description
`id`	Yes	Product id or slug.
`expand`	No	Comma-separated related fields to expand, e.g. "variants,categories".
`fields`	No	Comma-separated fields to return, e.g. "name,price".

swell_get_subscriptionGet a subscription

Read-only

Inspect

Fetch a single subscription by id. Supports expand. Swell backend REST API: GET /subscriptions/{id}.

ParametersJSON Schema

Name	Required	Description	Default
`id`	Yes	Subscription id.
`expand`	No	Comma-separated related fields to expand, e.g. "account,product".

swell_list_cartsList carts

Read-only

Inspect

List shopping carts (including abandoned carts), with filtering, sorting, and expansion. Swell backend REST API: GET /carts.

ParametersJSON Schema

Name	Required	Description
`page`	No	Page number for pagination (default 1).
`sort`	No	Sort expression, e.g. "date_created desc" or "name asc".
`limit`	No	Max records to return (1–1000, Swell default 15).
`where`	No	MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
`expand`	No	Comma-separated related fields to expand, e.g. "variants,categories".

swell_list_categoriesList categories

Read-only

Inspect

List product categories, with filtering, sorting, search, and expansion. Swell backend REST API: GET /categories.

ParametersJSON Schema

Name	Required	Description
`page`	No	Page number for pagination (default 1).
`sort`	No	Sort expression, e.g. "date_created desc" or "name asc".
`limit`	No	Max records to return (1–1000, Swell default 15).
`where`	No	MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
`expand`	No	Comma-separated related fields to expand, e.g. "variants,categories".
`search`	No	Free-text search across the model's searchable fields.

swell_list_couponsList coupons

Read-only

Inspect

List discount coupons, with filtering and sorting. Swell backend REST API: GET /coupons.

ParametersJSON Schema

Name	Required	Description
`page`	No	Page number for pagination (default 1).
`sort`	No	Sort expression, e.g. "date_created desc" or "name asc".
`limit`	No	Max records to return (1–1000, Swell default 15).
`where`	No	MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.

swell_list_customersList customers

Read-only

Inspect

List customers. In Swell, customers are the accounts model — this queries GET /accounts, with filtering, sorting, search, and expansion.

ParametersJSON Schema

Name	Required	Description
`page`	No	Page number for pagination (default 1).
`sort`	No	Sort expression, e.g. "date_created desc" or "name asc".
`limit`	No	Max records to return (1–1000, Swell default 15).
`where`	No	MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
`expand`	No	Comma-separated related fields to expand, e.g. "variants,categories".
`search`	No	Free-text search across the model's searchable fields.

swell_list_invoicesList invoices

Read-only

Inspect

List invoices (typically subscription invoices), with filtering, sorting, and expansion. Swell backend REST API: GET /invoices.

ParametersJSON Schema

Name	Required	Description
`page`	No	Page number for pagination (default 1).
`sort`	No	Sort expression, e.g. "date_created desc" or "name asc".
`limit`	No	Max records to return (1–1000, Swell default 15).
`where`	No	MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
`expand`	No	Comma-separated related fields to expand, e.g. "variants,categories".

swell_list_ordersList orders

Read-only

Inspect

List orders, with MongoDB-style filtering, sorting, search, and expansion. Swell backend REST API: GET /orders.

ParametersJSON Schema

Name	Required	Description
`page`	No	Page number for pagination (default 1).
`sort`	No	Sort expression, e.g. "date_created desc" or "name asc".
`limit`	No	Max records to return (1–1000, Swell default 15).
`where`	No	MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
`expand`	No	Comma-separated related fields to expand, e.g. "variants,categories".
`search`	No	Free-text search across the model's searchable fields.

swell_list_productsList products

Read-only

Inspect

List products in the store, with MongoDB-style filtering, sorting, search, field selection, and expansion. Swell backend REST API: GET /products.

ParametersJSON Schema

Name	Required	Description
`page`	No	Page number for pagination (default 1).
`sort`	No	Sort expression, e.g. "date_created desc" or "name asc".
`limit`	No	Max records to return (1–1000, Swell default 15).
`where`	No	MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
`expand`	No	Comma-separated related fields to expand, e.g. "variants,categories".
`fields`	No	Comma-separated fields to return, e.g. "name,price,active".
`search`	No	Free-text search across the model's searchable fields.

swell_list_subscriptionsList subscriptions

Read-only

Inspect

List subscriptions, with filtering, sorting, and expansion. Swell backend REST API: GET /subscriptions.

ParametersJSON Schema

Name	Required	Description
`page`	No	Page number for pagination (default 1).
`sort`	No	Sort expression, e.g. "date_created desc" or "name asc".
`limit`	No	Max records to return (1–1000, Swell default 15).
`where`	No	MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
`expand`	No	Comma-separated related fields to expand, e.g. "variants,categories".

swell_queryQuery any collection (read-only)

Read-only

Inspect

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}.

ParametersJSON Schema

Name	Required	Description
`page`	No	Page number for pagination (default 1).
`sort`	No	Sort expression, e.g. "date_created desc" or "name asc".
`limit`	No	Max records to return (1–1000, Swell default 15).
`where`	No	MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
`expand`	No	Comma-separated related fields to expand, e.g. "variants,categories".
`fields`	No	Comma-separated fields to return, e.g. "name,price,active".
`search`	No	Free-text search across the model's searchable fields.
`collection`	Yes	Swell model/collection name, e.g. "products", "stock", "promotions", "giftcards".

swell_update_orderUpdate an order

Destructive

Inspect

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}.

ParametersJSON Schema

Name	Required	Description	Default
`id`	Yes	Order id to update (required).
`fields`	Yes	Partial set of order attributes to update, e.g. {"status":"complete"} or fulfillment fields.

swell_update_productUpdate a product

Destructive

Inspect

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}.

ParametersJSON Schema

Name	Required	Description	Default
`id`	Yes	Product id to update (required).
`fields`	Yes	Partial set of product attributes to update, e.g. {"price":19.99,"active":false}.

Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:

{
  "$schema": "https://glama.ai/mcp/schemas/connector.json",
  "maintainers": [{ "email": "your-email@example.com" }]
}

The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.

swell

Server Details

Tool Definition Quality

Available Tools

Discussions

Your Connectors

Resources