ReturnGO MCP by usefulapi
Read return requests, refunds and shipments; set RMA status and add comments in ReturnGO.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"returngo": {
"url": "https://returngo.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://returngo.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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"
}コミュニティ
エビデンス