Serveur MCP

swell

io.usefulapi/swell
Commerce et retail Public et accessible MCP 2026-07-28

Ce que fait ce MCP

Manages Swell commerce stores by reading and updating products, orders, customers, carts, subscriptions, coupons, and related collections.

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.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name'], 'properties': {'sku': {'type': 'string', 'description': 'Stock-keeping unit.'}, 'name': {'type': 'string', 'description': 'Product name (required).'}, 'type': {'type': 'string', 'description': 'Product type, e.g. "standard", "subscription", "digital".'}, 'price': {'type': 'number', 'description': 'Product price.'}, 'active': {'type': 'boolean', 'description': 'Whether the product is active/visible.'}, 'fields': {'type': 'object', 'description': 'Any additional product fields, merged into the request body (e.g. attributes, options, images).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'description': {'type': 'string', 'description': 'Product description.'}, 'stock_level': {'type': 'number', 'description': 'Available stock quantity.'}}}
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}.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Customer (account) id.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "orders,subscriptions".'}, 'fields': {'type': 'string', 'description': 'Comma-separated fields to return.'}}}
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}.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Order id or order number.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "items,account".'}, 'fields': {'type': 'string', 'description': 'Comma-separated fields to return.'}}}
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}.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Product id or slug.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "variants,categories".'}, 'fields': {'type': 'string', 'description': 'Comma-separated fields to return, e.g. "name,price".'}}}
swell_get_subscription
Get a subscription
Fetch a single subscription by id. Supports `expand`. Swell backend REST API: GET /subscriptions/{id}.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Subscription id.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "account,product".'}}}
swell_list_carts
List carts
List shopping carts (including abandoned carts), with filtering, sorting, and expansion. Swell backend REST API: GET /carts.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number for pagination (default 1).', 'exclusiveMinimum': 0}, 'sort': {'type': 'string', 'description': 'Sort expression, e.g. "date_created desc" or "name asc".'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max records to return (1–1000, Swell default 15).'}, 'where': {'type': 'string', 'description': 'MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "variants,categories".'}}}
swell_list_categories
List categories
List product categories, with filtering, sorting, search, and expansion. Swell backend REST API: GET /categories.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number for pagination (default 1).', 'exclusiveMinimum': 0}, 'sort': {'type': 'string', 'description': 'Sort expression, e.g. "date_created desc" or "name asc".'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max records to return (1–1000, Swell default 15).'}, 'where': {'type': 'string', 'description': 'MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "variants,categories".'}, 'search': {'type': 'string', 'description': "Free-text search across the model's searchable fields."}}}
swell_list_coupons
List coupons
List discount coupons, with filtering and sorting. Swell backend REST API: GET /coupons.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number for pagination (default 1).', 'exclusiveMinimum': 0}, 'sort': {'type': 'string', 'description': 'Sort expression, e.g. "date_created desc" or "name asc".'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max records to return (1–1000, Swell default 15).'}, 'where': {'type': 'string', 'description': 'MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.'}}}
swell_list_customers
List customers
List customers. In Swell, customers are the `accounts` model — this queries GET /accounts, with filtering, sorting, search, and expansion.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number for pagination (default 1).', 'exclusiveMinimum': 0}, 'sort': {'type': 'string', 'description': 'Sort expression, e.g. "date_created desc" or "name asc".'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max records to return (1–1000, Swell default 15).'}, 'where': {'type': 'string', 'description': 'MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "variants,categories".'}, 'search': {'type': 'string', 'description': "Free-text search across the model's searchable fields."}}}
swell_list_invoices
List invoices
List invoices (typically subscription invoices), with filtering, sorting, and expansion. Swell backend REST API: GET /invoices.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number for pagination (default 1).', 'exclusiveMinimum': 0}, 'sort': {'type': 'string', 'description': 'Sort expression, e.g. "date_created desc" or "name asc".'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max records to return (1–1000, Swell default 15).'}, 'where': {'type': 'string', 'description': 'MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "variants,categories".'}}}
swell_list_orders
List orders
List orders, with MongoDB-style filtering, sorting, search, and expansion. Swell backend REST API: GET /orders.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number for pagination (default 1).', 'exclusiveMinimum': 0}, 'sort': {'type': 'string', 'description': 'Sort expression, e.g. "date_created desc" or "name asc".'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max records to return (1–1000, Swell default 15).'}, 'where': {'type': 'string', 'description': 'MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "variants,categories".'}, 'search': {'type': 'string', 'description': "Free-text search across the model's searchable fields."}}}
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.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number for pagination (default 1).', 'exclusiveMinimum': 0}, 'sort': {'type': 'string', 'description': 'Sort expression, e.g. "date_created desc" or "name asc".'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max records to return (1–1000, Swell default 15).'}, 'where': {'type': 'string', 'description': 'MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "variants,categories".'}, 'fields': {'type': 'string', 'description': 'Comma-separated fields to return, e.g. "name,price,active".'}, 'search': {'type': 'string', 'description': "Free-text search across the model's searchable fields."}}}
swell_list_subscriptions
List subscriptions
List subscriptions, with filtering, sorting, and expansion. Swell backend REST API: GET /subscriptions.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number for pagination (default 1).', 'exclusiveMinimum': 0}, 'sort': {'type': 'string', 'description': 'Sort expression, e.g. "date_created desc" or "name asc".'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max records to return (1–1000, Swell default 15).'}, 'where': {'type': 'string', 'description': 'MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "variants,categories".'}}}
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}.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['collection'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Page number for pagination (default 1).', 'exclusiveMinimum': 0}, 'sort': {'type': 'string', 'description': 'Sort expression, e.g. "date_created desc" or "name asc".'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max records to return (1–1000, Swell default 15).'}, 'where': {'type': 'string', 'description': 'MongoDB-style filter as a JSON object string, e.g. {"active":true,"price":{"$gte":10}}.'}, 'expand': {'type': 'string', 'description': 'Comma-separated related fields to expand, e.g. "variants,categories".'}, 'fields': {'type': 'string', 'description': 'Comma-separated fields to return, e.g. "name,price,active".'}, 'search': {'type': 'string', 'description': "Free-text search across the model's searchable fields."}, 'collection': {'type': 'string', 'description': 'Swell model/collection name, e.g. "products", "stock", "promotions", "giftcards".'}}}
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}.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'fields'], 'properties': {'id': {'type': 'string', 'description': 'Order id to update (required).'}, 'fields': {'type': 'object', 'description': 'Partial set of order attributes to update, e.g. {"status":"complete"} or fulfillment fields.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
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}.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'fields'], 'properties': {'id': {'type': 'string', 'description': 'Product id to update (required).'}, 'fields': {'type': 'object', 'description': 'Partial set of product attributes to update, e.g. {"price":19.99,"active":false}.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
Modifié
swell_update_order
1 October 2026 02:42
Modifié
swell_update_product
1 October 2026 02:42
Modifié
swell_create_product
1 October 2026 02:42
Modifié
swell_query
1 October 2026 02:42
Modifié
swell_list_coupons
1 October 2026 02:42
Modifié
swell_list_invoices
1 October 2026 02:42
Modifié
swell_get_subscription
1 October 2026 02:42
Modifié
swell_list_subscriptions
1 October 2026 02:42
Modifié
swell_list_carts
1 October 2026 02:42
Modifié
swell_get_customer
1 October 2026 02:42
Modifié
swell_list_customers
1 October 2026 02:42
Modifié
swell_get_order
1 October 2026 02:42
Modifié
swell_list_orders
1 October 2026 02:42
Modifié
swell_list_categories
1 October 2026 02:42
Modifié
swell_get_product
1 October 2026 02:42
Modifié
swell_list_products
1 October 2026 02:42
Ajouté
swell_update_order
21 September 2026 02:44
Ajouté
swell_update_product
21 September 2026 02:44
Ajouté
swell_create_product
21 September 2026 02:44
Ajouté
swell_query
21 September 2026 02:44
Ajouté
swell_list_coupons
21 September 2026 02:44
Ajouté
swell_list_invoices
21 September 2026 02:44
Ajouté
swell_get_subscription
21 September 2026 02:44
Ajouté
swell_list_subscriptions
21 September 2026 02:44
Ajouté
swell_list_carts
21 September 2026 02:44
Ajouté
swell_get_customer
21 September 2026 02:44
Ajouté
swell_list_customers
21 September 2026 02:44
Ajouté
swell_get_order
21 September 2026 02:44
Ajouté
swell_list_orders
21 September 2026 02:44
Ajouté
swell_list_categories
21 September 2026 02:44