Skip to content
MCP server

ReturnLogic MCP by usefulapi

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

Install
Runs
Remotely
Version
1.6.0
Listing updated
4 days ago

About ReturnLogic MCP by usefulapi

ReturnLogic MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http returnlogic https://returnlogic.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://returnlogic.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "returnlogic": {
      "url": "https://returnlogic.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "returnlogic": {
      "type": "http",
      "url": "https://returnlogic.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "returnlogic": {
      "serverUrl": "https://returnlogic.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (18)

Read directly from the server.

returnlogic_list_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.
returnlogic_count_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.
returnlogic_get_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}.
returnlogic_get_rma_item_type_history
The history of return-type changes (e.g. refund changed to exchange) of one RMA item. GET /v1/rmas/{rlRmaItemId}/returntypehistory.
returnlogic_get_rma_metafields
Custom metafields (key, value, reportable) stored on an RMA. GET /v1/rmas/{rlRmaId}/metafields.
returnlogic_get_rma_item_metafields
Custom metafields stored on one item of an RMA. GET /v1/rmas/{rlRmaId}/items/{rlRmaItemId}/metafields.
returnlogic_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.
returnlogic_count_orders
Count orders matching the same filters as returnlogic_list_orders. GET /v1/orders/count.
returnlogic_get_order
One order by ReturnLogic order id (rlOrderId) with its line items, addresses and statuses. GET /v1/orders/{rlOrderId}.
returnlogic_list_customers
List customers, or find one by email or external customer id. GET /v1/customers/list.
returnlogic_get_customer
One customer by ReturnLogic customer id (rlCustomerId). GET /v1/customers/{rlCustomerId}.
returnlogic_list_products
List products with their variants (SKUs, barcodes). Filter by SKU, category id, status or external (store) product ids. GET /v1/products.
returnlogic_count_products
Count products matching a SKU, category or status filter. GET /v1/products/count.
returnlogic_get_product
One product by ReturnLogic product id (rlProductId) with its variants. GET /v1/products/{rlProductId}.
returnlogic_list_product_categories
List product categories (used for return rules). Search by name or external category ids. GET /v1/productCategories.
returnlogic_flag_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.
returnlogic_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 t
returnlogic_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.

ReturnLogic MCP by usefulapi FAQ

How do I add ReturnLogic MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http returnlogic https://returnlogic.usefulapi.io/mcp