io.usefulapi/swell

Swell MCP by usefulapi

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

1.11.1
Version
remote
Transport
16
Tools

Security review

Review passed

Reviewed 1d ago.

  • tools: 16 tools scanned
  • metadata: scanned

No findings.

Tools (16)

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