Skip to main content
Glama

Swell MCP by usefulapi

by io.usefulapi
OverviewDiscussionsAdmin

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
81.3% over 57 days
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

A3.8/5.0

Scored across 16 tools

Disambiguation5/5

Each tool targets a distinct resource and action: get_* for single entities, list_* for collections, and create/update for specific mutations. The generic query tool is explicitly scoped to uncovered models, preventing confusion.

Naming Consistency4/5

Most tools follow a consistent swell_verb_noun pattern (e.g., swell_get_product, swell_list_orders), but 'swell_query' deviates by being a verb-only name. This is a minor inconsistency in an otherwise predictable scheme.

Tool Count4/5

16 tools is slightly above the ideal 3-15 range, but the breadth of Swell's e-commerce domain (products, orders, customers, subscriptions, etc.) justifies the count. Each tool covers a meaningful resource or action.

Completeness2/5

The toolset provides comprehensive read operations (get/list) for most resources, but mutations are sparse: only create_product, update_product, and update_order exist. Missing create/delete for nearly all other resources, and no update for customers, subscriptions, invoices, etc., leaving significant gaps in lifecycle management.

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
NameRequiredDescriptionDefault
skuNoStock-keeping unit.
nameYesProduct name (required).
typeNoProduct type, e.g. "standard", "subscription", "digital".
priceNoProduct price.
activeNoWhether the product is active/visible.
fieldsNoAny additional product fields, merged into the request body (e.g. attributes, options, images).
descriptionNoProduct description.
stock_levelNoAvailable 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
NameRequiredDescriptionDefault
idYesCustomer (account) id.
expandNoComma-separated related fields to expand, e.g. "orders,subscriptions".
fieldsNoComma-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
NameRequiredDescriptionDefault
idYesOrder id or order number.
expandNoComma-separated related fields to expand, e.g. "items,account".
fieldsNoComma-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
NameRequiredDescriptionDefault
idYesProduct id or slug.
expandNoComma-separated related fields to expand, e.g. "variants,categories".
fieldsNoComma-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
NameRequiredDescriptionDefault
idYesSubscription id.
expandNoComma-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
NameRequiredDescriptionDefault
pageNoPage number for pagination (default 1).
sortNoSort expression, e.g. "date_created desc" or "name asc".
limitNoMax records to return (1–1000, Swell default 15).
whereNoMongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
expandNoComma-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
NameRequiredDescriptionDefault
pageNoPage number for pagination (default 1).
sortNoSort expression, e.g. "date_created desc" or "name asc".
limitNoMax records to return (1–1000, Swell default 15).
whereNoMongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
expandNoComma-separated related fields to expand, e.g. "variants,categories".
searchNoFree-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
NameRequiredDescriptionDefault
pageNoPage number for pagination (default 1).
sortNoSort expression, e.g. "date_created desc" or "name asc".
limitNoMax records to return (1–1000, Swell default 15).
whereNoMongoDB-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
NameRequiredDescriptionDefault
pageNoPage number for pagination (default 1).
sortNoSort expression, e.g. "date_created desc" or "name asc".
limitNoMax records to return (1–1000, Swell default 15).
whereNoMongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
expandNoComma-separated related fields to expand, e.g. "variants,categories".
searchNoFree-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
NameRequiredDescriptionDefault
pageNoPage number for pagination (default 1).
sortNoSort expression, e.g. "date_created desc" or "name asc".
limitNoMax records to return (1–1000, Swell default 15).
whereNoMongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
expandNoComma-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
NameRequiredDescriptionDefault
pageNoPage number for pagination (default 1).
sortNoSort expression, e.g. "date_created desc" or "name asc".
limitNoMax records to return (1–1000, Swell default 15).
whereNoMongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
expandNoComma-separated related fields to expand, e.g. "variants,categories".
searchNoFree-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
NameRequiredDescriptionDefault
pageNoPage number for pagination (default 1).
sortNoSort expression, e.g. "date_created desc" or "name asc".
limitNoMax records to return (1–1000, Swell default 15).
whereNoMongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
expandNoComma-separated related fields to expand, e.g. "variants,categories".
fieldsNoComma-separated fields to return, e.g. "name,price,active".
searchNoFree-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
NameRequiredDescriptionDefault
pageNoPage number for pagination (default 1).
sortNoSort expression, e.g. "date_created desc" or "name asc".
limitNoMax records to return (1–1000, Swell default 15).
whereNoMongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
expandNoComma-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
NameRequiredDescriptionDefault
pageNoPage number for pagination (default 1).
sortNoSort expression, e.g. "date_created desc" or "name asc".
limitNoMax records to return (1–1000, Swell default 15).
whereNoMongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.
expandNoComma-separated related fields to expand, e.g. "variants,categories".
fieldsNoComma-separated fields to return, e.g. "name,price,active".
searchNoFree-text search across the model's searchable fields.
collectionYesSwell 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
NameRequiredDescriptionDefault
idYesOrder id to update (required).
fieldsYesPartial 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
NameRequiredDescriptionDefault
idYesProduct id to update (required).
fieldsYesPartial set of product attributes to update, e.g. {"price":19.99,"active":false}.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 16 tool updates
    • Changedswell_create_product1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_get_customer1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_get_order1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_get_product1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_get_subscription1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_list_carts1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_list_categories1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_list_coupons1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_list_customers1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_list_invoices1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_list_orders1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_list_products1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_list_subscriptions1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_query1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_update_order1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedswell_update_product1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. 16 tool updates
    • First observedswell_create_product
    • First observedswell_get_customer
    • First observedswell_get_order
    • First observedswell_get_product
    • First observedswell_get_subscription
    • First observedswell_list_carts
    • First observedswell_list_categories
    • First observedswell_list_coupons
    • First observedswell_list_customers
    • First observedswell_list_invoices
    • First observedswell_list_orders
    • First observedswell_list_products
    • First observedswell_list_subscriptions
    • First observedswell_query
    • First observedswell_update_order
    • First observedswell_update_product

Related MCP Connectors

Related MCP Servers

  • Shopify MCP Server

    tzenderman
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables interaction with Shopify store data via the GraphQL Admin API to manage products, customers, orders, and collections. Supports multi-store configurations and provides comprehensive management tools for e-commerce administration in both local and remote environments.
    13 npm
    1
    MIT

  • squarespace-mcp

    The1Studio
    F
    license
    A
    quality
    D
    maintenance
    Enables LLM agents to interact with Squarespace Commerce APIs (products, orders, inventory, transactions) using natural language.
    11
    -

  • Shopify MCP Server

    anass319
    A
    license
    C
    quality
    Not graded
    maintenance
    Enables interaction with Shopify store data via the GraphQL Admin API for managing products, customers, and orders. It allows users to search, retrieve, create, and update store records through natural language commands.
    9
    1,777 npm
    -
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources