ReturnGO MCP by usefulapi
Read return requests, refunds and shipments; set RMA status and add comments in ReturnGO.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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-httpWhat it can do
Tool inventory
Tools (9)
🟢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
Evidence