ReturnLogic MCP by usefulapi

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

Read returns, orders and products; flag returns and mark items received in ReturnLogic.

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

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

将助手连接到 ReturnLogic 账户，读取退货、订单、客户和商品，并可标记退货或登记商品已收货。

可以做什么
  • 列出、统计并查看退货单（RMA），含状态、类型、商品、原因、面单和时间线
  • 查看退货单商品的退货类型变更历史，以及退货单和商品的定制元字段
  • 列出、统计并查看订单及其行项目、地址和状态
  • 按邮箱或外部客户 ID 查找客户，并查看单个客户
  • 列出、统计并查看商品、变体及商品分类
  • 标记退货单、登记退货商品已收货，并为退货单添加定制元字段
适用场景
适合在 ReturnLogic 中处理客服、运营或电商退货的团队，让助手回答哪些退货待处理、本周申请了哪些退货、某订单已收到什么等问题。也便于在对话中直接登记仓库收货和标记退货单。
运行要求
远程托管端点，无需本地安装。只需填写服务器地址，然后通过 OAuth 使用 ReturnLogic 账号登录。首次连接需提供在 ReturnLogic 设置的应用（私有）中生成的 API 令牌，服务器会校验并按用户保存。免费方案每月 50 次工具调用，另有付费方案。
安装前请注意
写入类工具会修改 ReturnLogic 数据：标记退货单后无法撤销，登记收货可能触发自动处理，元字段可设为在报表中可见。执行写入前请先确认。ReturnLogic API 令牌由第三方托管方保存。付费方案通过 Stripe 结账并产生周期性扣费，取消时当期不退款。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

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

README

ReturnLogic MCP by usefulapi

Use your ReturnLogic account from Claude, Cursor, or any MCP client. Read returns, orders, customers and products, and flag a return, mark its items received or add custom fields to it. Hosted, no local install: connect with your own credentials.

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

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://returnlogic.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http returnlogic https://returnlogic.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": {    "returnlogic": {      "url": "https://returnlogic.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 ReturnLogic credentials.

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

On first connect you provide your ReturnLogic API token, generated in ReturnLogic under Settings → Applications → Private. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
returnlogic_list_rmasreadList returns (RMAs)
returnlogic_count_rmasreadCount returns (RMAs)
returnlogic_get_rmareadGet return (RMA)
returnlogic_get_rma_item_type_historyreadGet return type history of an RMA item
returnlogic_get_rma_metafieldsreadGet RMA metafields
returnlogic_get_rma_item_metafieldsreadGet RMA item metafields
returnlogic_list_ordersreadList orders
returnlogic_count_ordersreadCount orders
returnlogic_get_orderreadGet order
returnlogic_list_customersreadList customers
returnlogic_get_customerreadGet customer
returnlogic_list_productsreadList products
returnlogic_count_productsreadCount products
returnlogic_get_productreadGet product
returnlogic_list_product_categoriesreadList product categories
returnlogic_flag_rmawriteFlag an RMA
returnlogic_mark_rma_items_receivedwriteMark RMA items received
returnlogic_add_rma_metafieldswriteAdd RMA metafields
returnlogic_usage_statusmetaUsage status (free-tier meter)
returnlogic_request_featuremetaRequest a missing feature
returnlogic_upgrademetaUpgrade to Pro or Pro+
returnlogic_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 (per user)$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 returnlogic_upgrade (it returns a Stripe Checkout link). Cancel any time with returnlogic_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running returnlogic_upgrade before then undoes the cancel. Or write to [email protected].

License

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

来源：servers/returnlogic/README.md，提交 4046075

工具

18

returnlogic_list_rmas

List returns (RMAs)

List return merchandise authorizations (RMAs, i.e. customer returns) with workflow status, return type (refund, exchange, warranty, giftcard), items, customer email and order. Filter by status, type, reason, email, order, date range, flags or 'requires action'. GET /v1/rmas.

输入参数skipemaillimitorder_namereturn_typeonly_flaggedcreated_aftershow_archivedcreated_beforerequires_actionworkflow_statusthird_party_only另有 4 个

returnlogic_count_rmas

Count returns (RMAs)

Count RMAs matching the same filters as returnlogic_list_rmas (for example how many returns are Requested or require action). GET /v1/rmas/count.

输入参数emailorder_namereturn_typeonly_flaggedcreated_aftershow_archivedcreated_beforerequires_actionworkflow_statusthird_party_onlyreturn_reason_codeonly_unpaid_invoices另有 2 个

returnlogic_get_rma

Get return (RMA)

One RMA by id: status, comments, order link, shopper and warehouse addresses, items with quantities, reasons, approval/receipt state, labels and timeline. GET /v1/rmas/{rlRmaId}.

输入参数rma_id必填

returnlogic_get_rma_item_type_history

Get return type history of an RMA item

The history of return-type changes (e.g. refund changed to exchange) of one RMA item. GET /v1/rmas/{rlRmaItemId}/returntypehistory.

输入参数rma_item_id必填

returnlogic_get_rma_metafields

Get RMA metafields

Custom metafields (key, value, reportable) stored on an RMA. GET /v1/rmas/{rlRmaId}/metafields.

输入参数rma_id必填

returnlogic_get_rma_item_metafields

Get RMA item metafields

Custom metafields stored on one item of an RMA. GET /v1/rmas/{rlRmaId}/items/{rlRmaItemId}/metafields.

输入参数rma_id必填rma_item_id必填

returnlogic_list_orders

List orders

List orders known to ReturnLogic (synced from the store) with items, customer, amounts and statuses. Filter by order number/name, email, date range or financial status. GET /v1/orders.

输入参数skipemaillimitorder_nameorder_numbercreated_aftercreated_beforefinancial_status

returnlogic_count_orders

Count orders

Count orders matching the same filters as returnlogic_list_orders. GET /v1/orders/count.

输入参数emailorder_nameorder_numbercreated_aftercreated_beforefinancial_status

returnlogic_get_order

Get order

One order by ReturnLogic order id (rlOrderId) with its line items, addresses and statuses. GET /v1/orders/{rlOrderId}.

输入参数order_id必填

returnlogic_list_customers

List customers

List customers, or find one by email or external customer id. GET /v1/customers/list.

输入参数skipemaillimitexternal_customer_id

returnlogic_get_customer

Get customer

One customer by ReturnLogic customer id (rlCustomerId). GET /v1/customers/{rlCustomerId}.

输入参数customer_id必填

returnlogic_list_products

List products

List products with their variants (SKUs, barcodes). Filter by SKU, category id, status or external (store) product ids. GET /v1/products.

输入参数skuskiplimitstatuscategory_idexternal_product_ids

returnlogic_count_products

Count products

Count products matching a SKU, category or status filter. GET /v1/products/count.

输入参数skustatuscategory_id

returnlogic_get_product

Get product

One product by ReturnLogic product id (rlProductId) with its variants. GET /v1/products/{rlProductId}.

输入参数product_id必填

returnlogic_list_product_categories

List product categories

List product categories (used for return rules). Search by name or external category ids. GET /v1/productCategories.

输入参数nameskiplimitexternal_category_ids

returnlogic_flag_rma

Flag an RMA

WRITE: flag an RMA so the team can filter for it, with an optional comment. A flag cannot be removed afterwards. It sends nothing to the customer. POST /v1/rmas/{rlRmaId}/flag.

输入参数rma_id必填comment

returnlogic_mark_rma_items_received

Mark RMA items received

WRITE: record the warehouse receipt of one or more RMA items (received true/false, optional disposition code that must already exist in ReturnLogic). When every item is received the RMA becomes Received, and if the store uses Automated Processing for Received, the RMA may then be processed automatically (refund, exchange or gift card issued, and the customer notified by ReturnLogic). Use only on the operator's instruction. PUT /v1/rmas/{rlRmaId}/fulfillment.

输入参数items必填rma_id必填

returnlogic_add_rma_metafields

Add RMA metafields

WRITE: add custom metafields (key/value notes or reference numbers) to an RMA. A key can be used once per RMA. 'reportable' true makes the field visible on RMAs and reports; false keeps it API-only. Nothing is sent to the customer. POST /v1/rmas/{rlRmaId}/metafields.

输入参数rma_id必填metafields必填

版本历史

6
  1. v1.2.4最新Nov 7, 2026
  2. v1.1.3Nov 5, 2026
  3. v1.1.2Nov 5, 2026
  4. v1.1.1Nov 4, 2026
  5. v1.1.0Nov 3, 2026
  6. v1.0.1Nov 3, 2026

评分

已满足适用检查项的 100%

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

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

其他 Usefulapi 集成

Ably MCP by usefulapi

io.usefulapi官方发布者

面向 Ably 实时消息的托管 MCP 服务器：查看频道历史、在线状态与占用情况，发布消息，并查看应用用量与配置。

Streamable HTTP可网页运行
云端与基础设施15 个工具Nov 7, 2026

Woffu MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手查询 Woffu 公司的用户、劳动合同、部门和办公地点。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapi官方发布者

面向 White Label Loyalty 的托管 MCP 服务器：浏览奖励、查看客户积分钱包与等级进度，并用积分购买奖励。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

Weekdone MCP by usefulapi

io.usefulapi官方发布者

托管的 Weekdone 连接器，让助手读取周报、团队、目标与 KPI，并新增报告条目、评论和 KPI 数值。

Streamable HTTP可网页运行
数据与分析15 个工具Nov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手列出 WebinarKit 的网络研讨会、场次时间、系列、会议以及白标子账户。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026