ReturnLogic MCP by usefulapi

io.usefulapi/returnlogic · v1.0.0 · ecommerce

ReturnLogic MCP by usefulapi is healthy: it completed an MCP handshake in 809 ms and exposes 18 tools.

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

Endpoint: https://returnlogic.usefulapi.io/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count18
Latency809 ms
Last checked (UTC)2026-11-02T20:10:28.590Z

Health history

Checked (UTC)StatusLatencyError
2026-11-02T20:10:28.590ZHealthy809

Tools (18)

returnlogic_list_rmasList 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_rmasCount 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_rmaOne 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_historyThe history of return-type changes (e.g. refund changed to exchange) of one RMA item. GET /v1/rmas/{rlRmaItemId}/returntypehistory.
returnlogic_get_rma_metafieldsCustom metafields (key, value, reportable) stored on an RMA. GET /v1/rmas/{rlRmaId}/metafields.
returnlogic_get_rma_item_metafieldsCustom metafields stored on one item of an RMA. GET /v1/rmas/{rlRmaId}/items/{rlRmaItemId}/metafields.
returnlogic_list_ordersList 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_ordersCount orders matching the same filters as returnlogic_list_orders. GET /v1/orders/count.
returnlogic_get_orderOne order by ReturnLogic order id (rlOrderId) with its line items, addresses and statuses. GET /v1/orders/{rlOrderId}.
returnlogic_list_customersList customers, or find one by email or external customer id. GET /v1/customers/list.
returnlogic_get_customerOne customer by ReturnLogic customer id (rlCustomerId). GET /v1/customers/{rlCustomerId}.
returnlogic_list_productsList products with their variants (SKUs, barcodes). Filter by SKU, category id, status or external (store) product ids. GET /v1/products.
returnlogic_count_productsCount products matching a SKU, category or status filter. GET /v1/products/count.
returnlogic_get_productOne product by ReturnLogic product id (rlProductId) with its variants. GET /v1/products/{rlProductId}.
returnlogic_list_product_categoriesList product categories (used for return rules). Search by name or external category ids. GET /v1/productCategories.
returnlogic_flag_rmaWRITE: 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_receivedWRITE: 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 automatic
returnlogic_add_rma_metafieldsWRITE: 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.