ReturnGO MCP by usefulapi

Read return requests, refunds and shipments; set RMA status and add comments in ReturnGO.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
90%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,171Tokens (tool definitions)
~2.0 KBTypical response size
Moderate attention impact (1.70% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "returngo": {
      "url": "https://returngo.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://returngo.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (9)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢returngo_list_rmas(pagesize, cursor, sort_by, rma_created_at, rma_updated_at, ...)

List and search return requests (RMAs) for the store. Filter by status, creation or update time, order names, tracking numbers or customer ids. Use the returned cursor to page. ReturnGO API: GET /rmas.

Input Schema

{
  "type": "object",
  "properties": {
    "pagesize": {
      "description": "Results per page, 1 to 500 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "cursor": {
      "description": "Cursor from a previous response, to get the next page.",
      "type": "string"
    },
    "sort_by": {
      "description": "Sort columns: rma_created_at or rma_updated_at, prefix - for descending or + for ascending, comma separated. E.g. -rma_created_at.",
      "type": "string"
    },
    "rma_created_at": {
      "description": "Filter on the creation time: operator:ISO datetime. Operators: lt, lte, gt, gte, eq, neq. E.g. gte:2026-01-01T00:00:00.",
      "type": "string"
    },
    "rma_updated_at": {
      "description": "Filter on the last update time: operator:ISO datetime. Operators: lt, lte, gt, gte, eq, neq. E.g. gte:2026-01-01T00:00:00.",
      "type": "string"
    },
    "status": {
      "description": "Comma-separated RMA statuses: Pending, Approved, Received, Validated, Done, Rejected, Canceled.",
      "type": "string"
    },
    "order_name": {
      "description": "Comma-separated order names, e.g. 1001,1002.",
      "type": "string"
    },
    "glbe_order_id": {
      "description": "Comma-separated Global-e order ids.",
      "type": "string"
    },
    "customer_ids": {
      "description": "Comma-separated customer ids.",
      "type": "string"
    },
    "tracking_numbers": {
      "description": "Comma-separated tracking numbers.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢returngo_get_rma(rmaId, includeMedia)

Get one RMA with its items, status, timeline, shipments and transactions. Set includeMedia to include customer-uploaded photos. ReturnGO API: GET /rma/{rmaId}.

Input Schema

{
  "type": "object",
  "properties": {
    "rmaId": {
      "type": "string",
      "minLength": 1,
      "description": "The RMA id (from returngo_list_rmas)."
    },
    "includeMedia": {
      "description": "Include customer media (photos) in the response.",
      "type": "boolean"
    }
  },
  "required": [
    "rmaId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢returngo_list_transactions(pagesize, cursor, created_at, updated_at, rma_ids, ...)

List and search refunds, payment authorizations, captures and invoice payments linked to returns. Filter by status, type, processor, RMA or order ids. ReturnGO API: GET /transactions.

Input Schema

{
  "type": "object",
  "properties": {
    "pagesize": {
      "description": "Results per page, 1 to 500 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "cursor": {
      "description": "Cursor from a previous response, to get the next page.",
      "type": "string"
    },
    "created_at": {
      "description": "Filter on the creation time: operator:ISO datetime. Operators: lt, lte, gt, gte, eq, neq. E.g. gte:2026-01-01T00:00:00.",
      "type": "string"
    },
    "updated_at": {
      "description": "Filter on the last update time: operator:ISO datetime. Operators: lt, lte, gt, gte, eq, neq. E.g. gte:2026-01-01T00:00:00.",
      "type": "string"
    },
    "rma_ids": {
      "description": "Comma-separated RMA ids.",
      "type": "string"
    },
    "order_ids": {
      "description": "Comma-separated order ids.",
      "type": "string"
    },
    "statuses": {
      "description": "Comma-separated transaction statuses, e.g. Requested,Failed.",
      "type": "string"
    },
    "types": {
      "description": "Comma-separated transaction types.",
      "type": "string"
    },
    "processors": {
      "description": "Comma-separated payment processors.",
      "type": "string"
    },
    "ids": {
      "description": "Comma-separated transaction ids.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢returngo_list_webhooks

List the webhooks registered for the store, with their event subscriptions and target URLs. ReturnGO API: GET /webhooks.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡returngo_track_shipment(shipmentId, shipmentCreationDate, orderId, destinationZip, trackingNumber, ...)

Get the current tracking status of a return shipment after it was created. Give the shipment id, creation date, order id, destination zip and tracking number. ReturnGO API: POST /shipment-tracker.

Input Schema

{
  "type": "object",
  "properties": {
    "shipmentId": {
      "type": "string",
      "minLength": 1,
      "description": "The shipment id."
    },
    "shipmentCreationDate": {
      "type": "string",
      "minLength": 1,
      "description": "When the shipment was created, e.g. 2026-11-01."
    },
    "orderId": {
      "type": "string",
      "minLength": 1,
      "description": "The order id."
    },
    "destinationZip": {
      "type": "string",
      "minLength": 1,
      "description": "Destination postal code."
    },
    "trackingNumber": {
      "type": "string",
      "minLength": 1,
      "description": "The carrier tracking number."
    },
    "lineItems": {
      "description": "Line item ids of the order, as used on the e-commerce platform.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "trackingUrl": {
      "description": "Carrier tracking URL, if known.",
      "type": "string"
    },
    "carrierName": {
      "description": "Carrier name, if known.",
      "type": "string"
    }
  },
  "required": [
    "shipmentId",
    "shipmentCreationDate",
    "orderId",
    "destinationZip",
    "trackingNumber"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡returngo_set_shipment(shipmentId, status, carrierName, trackingNumber, trackingURL, ...)

Update the carrier, tracking number, tracking URL, label URL and status of one shipment. All five fields are sent, so pass the current values for the ones you do not change. ReturnGO API: PUT /shipment/{shipmentId}.

Input Schema

{
  "type": "object",
  "properties": {
    "shipmentId": {
      "type": "string",
      "minLength": 1,
      "description": "The shipment id."
    },
    "status": {
      "type": "string",
      "enum": [
        "Pending",
        "LabelCreated",
        "Shipped",
        "Received",
        "Canceled",
        "Validated"
      ],
      "description": "The new shipment status."
    },
    "carrierName": {
      "type": "string",
      "minLength": 1,
      "description": "Carrier name."
    },
    "trackingNumber": {
      "type": "string",
      "minLength": 1,
      "description": "Carrier tracking number."
    },
    "trackingURL": {
      "type": "string",
      "minLength": 1,
      "description": "Carrier tracking URL."
    },
    "labelURL": {
      "type": "string",
      "minLength": 1,
      "description": "Return label URL."
    }
  },
  "required": [
    "shipmentId",
    "status",
    "carrierName",
    "trackingNumber",
    "trackingURL",
    "labelURL"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴returngo_add_rma_comment(rmaId, htmlText)

Add a merchant comment to an RMA's timeline. The note is HTML text. Adds a new comment each call. ReturnGO API: POST /rma/{rmaId}/comment.

Input Schema

{
  "type": "object",
  "properties": {
    "rmaId": {
      "type": "string",
      "minLength": 1,
      "description": "The RMA id (from returngo_list_rmas)."
    },
    "htmlText": {
      "type": "string",
      "minLength": 1,
      "description": "The comment text, as HTML code (e.g. <p>Item checked.</p>)."
    }
  },
  "required": [
    "rmaId",
    "htmlText"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴returngo_set_rma_status(rmaId, status, reject_reason, cancel_reason)

Move an RMA to a new status. ReturnGO runs every side effect of that transition, as set by the return policy (for example customer emails or refunds). Give reject_reason for Rejected and cancel_reason for Canceled. ReturnGO API: PUT /rma/{rmaId}/status.

Input Schema

{
  "type": "object",
  "properties": {
    "rmaId": {
      "type": "string",
      "minLength": 1,
      "description": "The RMA id (from returngo_list_rmas)."
    },
    "status": {
      "type": "string",
      "enum": [
        "Pending",
        "Approved",
        "Received",
        "Validated",
        "Done",
        "Rejected",
        "Canceled"
      ],
      "description": "The new RMA status."
    },
    "reject_reason": {
      "description": "Reason for rejecting the RMA (status Rejected).",
      "type": "string"
    },
    "cancel_reason": {
      "description": "Reason for cancelling the RMA (status Canceled).",
      "type": "string"
    }
  },
  "required": [
    "rmaId",
    "status"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡returngo_update_transaction(transactionId, status, externalReferenceId, externalReferenceType)

Set the status of a transaction, or link it to an external reference (for example a refund processed on your platform). Allowed transitions: Requested to Success or Failed, Failed to Success. ReturnGO API: PUT /transaction/{transactionId}.

Input Schema

{
  "type": "object",
  "properties": {
    "transactionId": {
      "type": "string",
      "minLength": 1,
      "description": "The transaction id (from returngo_list_transactions)."
    },
    "status": {
      "description": "The new transaction status.",
      "type": "string",
      "enum": [
        "Requested",
        "Success",
        "Failed",
        "Canceled"
      ]
    },
    "externalReferenceId": {
      "description": "Id of the matching record on your platform.",
      "type": "string"
    },
    "externalReferenceType": {
      "description": "Type of the external reference.",
      "type": "string",
      "enum": [
        "PlatformRefundId",
        "StoreCreditCode",
        "GiftCardId",
        "PaymentAuthorizationId",
        "PaymentCaptureId",
        "InvoicePaymentId",
        "OrderId",
        "Other"
      ]
    }
  },
  "required": [
    "transactionId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded9 tools