# swell MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-usefulapi-swell
- Repository: https://github.com/m190/usefulapi-mcp

## Install
- Endpoint: https://swell.usefulapi.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://swell.usefulapi.io/mcp

## Tools
- 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. Endpoint: https://swell.usefulapi.io/mcp
- swell_get_product (Get a product) - Fetch a single product by its record id or its slug. Supports `expand` and `fields`. Swell backend REST API: GET /products/{id}. Endpoint: https://swell.usefulapi.io/mcp
- swell_list_categories (List categories) - List product categories, with filtering, sorting, search, and expansion. Swell backend REST API: GET /categories. Endpoint: https://swell.usefulapi.io/mcp
- swell_list_orders (List orders) - List orders, with MongoDB-style filtering, sorting, search, and expansion. Swell backend REST API: GET /orders. Endpoint: https://swell.usefulapi.io/mcp
- swell_get_order (Get 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}. Endpoint: https://swell.usefulapi.io/mcp
- swell_list_customers (List customers) - List customers. In Swell, customers are the `accounts` model — this queries GET /accounts, with filtering, sorting, search, and expansion. Endpoint: https://swell.usefulapi.io/mcp
- swell_get_customer (Get a customer) - Fetch a single customer (Swell `accounts` model) by id. Supports `expand` and `fields`. Swell backend REST API: GET /accounts/{id}. Endpoint: https://swell.usefulapi.io/mcp
- swell_list_carts (List carts) - List shopping carts (including abandoned carts), with filtering, sorting, and expansion. Swell backend REST API: GET /carts. Endpoint: https://swell.usefulapi.io/mcp
- swell_list_subscriptions (List subscriptions) - List subscriptions, with filtering, sorting, and expansion. Swell backend REST API: GET /subscriptions. Endpoint: https://swell.usefulapi.io/mcp
- swell_get_subscription (Get a subscription) - Fetch a single subscription by id. Supports `expand`. Swell backend REST API: GET /subscriptions/{id}. Endpoint: https://swell.usefulapi.io/mcp
- swell_list_invoices (List invoices) - List invoices (typically subscription invoices), with filtering, sorting, and expansion. Swell backend REST API: GET /invoices. Endpoint: https://swell.usefulapi.io/mcp
- swell_list_coupons (List coupons) - List discount coupons, with filtering and sorting. Swell backend REST API: GET /coupons. Endpoint: https://swell.usefulapi.io/mcp
- swell_query (Query 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}. Endpoint: https://swell.usefulapi.io/mcp
- swell_create_product (Create 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. Endpoint: https://swell.usefulapi.io/mcp
- swell_update_product (Update 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}. Endpoint: https://swell.usefulapi.io/mcp
- swell_update_order (Update 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}. Endpoint: https://swell.usefulapi.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.usefulapi
- Version: 1.0.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 17, 2026
- Source: https://registry.modelcontextprotocol.io