# ReturnLogic MCP by usefulapi

> ReturnLogic MCP by usefulapi is an MCP server. Read returns, orders and products; flag returns and mark items received in ReturnLogic. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/returnlogic/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/returnlogic
- **MCP Registry name:** io.usefulapi/returnlogic
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://returnlogic.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "returnlogic": {
      "url": "https://returnlogic.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

---
Source: https://ai-powered.com/mcp/returnlogic-mcp-by-usefulapi
