Swell MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.36.5更新于 Nov 8, 2026

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

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行数据与分析商业与电商

概览

AI 生成的概览

面向 Swell 无头电商商店的托管 MCP 服务器,让助手读取商品、订单、客户、购物车和订阅,并可创建或更新商品与订单。

可以做什么
  • 列出并获取商品与分类,支持筛选、排序、搜索和字段选择
  • 列出并获取订单、客户、购物车、订阅、发票和优惠券
  • 通过通用查询工具以只读方式查询其他任意 Swell 集合
  • 创建商品、部分更新商品,以及更新订单(如状态、履约)
  • 查看每月工具调用用量、提交功能请求,以及升级或取消付费方案
适用场景
适合经营 Swell 商店、希望助手回答订单、营收、下架商品或弃购购物车等问题,或在不打开 Swell 后台的情况下做少量商品目录和订单调整的场景。
运行要求
通过 streamable HTTP 连接 swell.usefulapi.io 远程端点,无需本地安装。登录使用 OAuth,登录页会要求填写 Swell 商店 ID 和密钥,经校验后按用户存储。客户端配置中只填 URL,不要添加 Authorization 头或 API 密钥。
安装前请注意
需要把 Swell 商店 ID 和密钥交给第三方托管服务,并由其按用户存储。有三个工具会修改线上商店数据:创建商品、更新商品和更新订单,使用前应确认。免费方案每月 50 次工具调用;付费方案通过 Stripe 结账链接付款,取消后当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Swell MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fswell/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "swell-by-usefulapi": {
      "type": "http",
      "url": "https://swell.usefulapi.io/mcp"
    }
  }
}

README

Swell MCP by usefulapi

Manage your Swell headless-commerce store — products, orders, customers, and subscriptions — from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Swell store ID + secret key.

Live endpoint: https://swell.usefulapi.io/mcp · Homepage: https://usefulapi.io/swell

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://swell.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http swell https://swell.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "swell": {      "url": "https://swell.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Swell credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/swell/

On first connect you'll paste your Swell store ID and secret key. It's validated, stored per-user, and scoped to you.

Tools

ToolTypeWhat it does
swell_list_productsreadList products
swell_get_productreadGet a product
swell_list_categoriesreadList categories
swell_list_ordersreadList orders
swell_get_orderreadGet an order
swell_list_customersreadList customers
swell_get_customerreadGet a customer
swell_list_cartsreadList carts
swell_list_subscriptionsreadList subscriptions
swell_get_subscriptionreadGet a subscription
swell_list_invoicesreadList invoices
swell_list_couponsreadList coupons
swell_queryreadQuery any collection (read-only)
swell_create_productwriteCreate a product
swell_update_productwriteUpdate a product
swell_update_orderwriteUpdate an order
swell_usage_statusmetaUsage status (free-tier meter)
swell_request_featuremetaRequest a missing feature
swell_upgrademetaUpgrade to Pro or Pro+
swell_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with swell_upgrade (it returns a Stripe Checkout link). Cancel any time with swell_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running swell_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源:servers/swell/README.md,提交 4046075

工具

16

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.

输入参数pagesortlimitwhereexpandfieldssearch

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

输入参数id必填expandfields

swell_list_categories

List categories

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

输入参数pagesortlimitwhereexpandsearch

swell_list_orders

List orders

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

输入参数pagesortlimitwhereexpandsearch

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

输入参数id必填expandfields

swell_list_customers

List customers

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

输入参数pagesortlimitwhereexpandsearch

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

输入参数id必填expandfields

swell_list_carts

List carts

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

输入参数pagesortlimitwhereexpand

swell_list_subscriptions

List subscriptions

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

输入参数pagesortlimitwhereexpand

swell_get_subscription

Get a subscription

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

输入参数id必填expand

swell_list_invoices

List invoices

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

输入参数pagesortlimitwhereexpand

swell_list_coupons

List coupons

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

输入参数pagesortlimitwhere

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

输入参数pagesortlimitwhereexpandfieldssearchcollection必填

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.

输入参数skuname必填typepriceactivefieldsdescriptionstock_level

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

输入参数id必填fields必填

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

输入参数id必填fields必填

版本历史

22
  1. v1.36.5最新Nov 8, 2026
  2. v1.36.4Nov 7, 2026
  3. v1.35.3Nov 5, 2026
  4. v1.35.2Nov 5, 2026
  5. v1.35.1Nov 4, 2026
  6. v1.35.0Nov 3, 2026
  7. v1.34.1Nov 3, 2026
  8. v1.33.0Nov 1, 2026
  9. v1.31.0Oct 31, 2026
  10. v1.30.0Oct 31, 2026
  11. v1.29.2Oct 30, 2026
  12. v1.29.0Oct 30, 2026
  13. v1.24.0Oct 26, 2026
  14. v1.21.3Oct 25, 2026
  15. v1.21.0Oct 25, 2026
  16. v1.20.0Oct 24, 2026
  17. v1.17.0Oct 23, 2026
  18. v1.16.4Oct 22, 2026
  19. v1.16.3Oct 21, 2026
  20. v1.11.1Oct 9, 2026
  21. v1.10.0Oct 9, 2026
  22. v1.0.1Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成