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