ReturnGO MCP by usefulapi
Hosted MCP server that lets AI assistants read and update ReturnGO returns, refunds
Answered our latest tool-list check 2 hours ago with 9 tools. It will be marked verified after 3 successful checks in 7 days.
- Pricing
- Freemium
- Platforms
- API, CLI, Web
- Runs
- Remotely
- Version
- 1.0.0
- Listing updated
- today
Similar MCP servers
About ReturnGO MCP by usefulapi
ReturnGO MCP by usefulapi is a freemium MCP server for e-commerce. It runs as a hosted remote server, so there is nothing to install locally.
The README and product page describe a hosted Model Context Protocol endpoint that connects an AI client to a ReturnGO store account. Once connected, an assistant can search return requests, open a single RMA with its items and timeline, and list refunds and payment transactions. It can also change things: moving an RMA to a new status, adding a merchant comment, updating a transaction, or setting carrier and tracking details on a return shipment.
Sign-in happens through OAuth. The login page asks for a ReturnGO API key created in the store's settings and the shop host, and the server then calls the ReturnGO API on the user's behalf. The page states that usefulapi is an independent service and not affiliated with ReturnGO.
The server suits teams running returns on Shopify with ReturnGO who want to triage approvals and open refunds through Claude, ChatGPT, Cursor or VS Code rather than the admin dashboard. The free tier allows 50 tool calls a month, with paid Pro and Pro+ plans for higher volumes.
Install
Run in a terminal
claude mcp add --transport http returngo https://returngo.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://returngo.usefulapi.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"returngo": {
"url": "https://returngo.usefulapi.io/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"returngo": {
"type": "http",
"url": "https://returngo.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"returngo": {
"serverUrl": "https://returngo.usefulapi.io/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://returngo.usefulapi.io/mcpEnter a Name (for example "ReturnGO MCP by usefulapi"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"returngo": {
"type": "http",
"url": "https://returngo.usefulapi.io/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (9)
Read directly from the server.
4 of 9 tools say they're read-only. 2 of 9 tools say they can delete or change data. 3 tools don't say.
From the server's own tool annotations; not verified by us.
- returngo_list_rmasSays read-only
- 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.
- returngo_get_rmaSays read-only
- Get one RMA with its items, status, timeline, shipments and transactions. Set includeMedia to include customer-uploaded photos. ReturnGO API: GET /rma/{rmaId}.
- returngo_list_transactionsSays read-only
- 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.
- returngo_list_webhooksSays read-only
- List the webhooks registered for the store, with their event subscriptions and target URLs. ReturnGO API: GET /webhooks.
- returngo_track_shipment
- 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.
- returngo_set_shipment
- 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}.
- returngo_add_rma_commentSays it can change data
- 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.
- returngo_set_rma_statusSays it can change data
- 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.
- returngo_update_transaction
- 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}.
What it does
- Return request search
- Filter RMAs by status, dates, order names, tracking numbers or customer ids, with cursor paging.
- RMA status changes
- Move an RMA to a new status, with a reason for rejections or cancellations, and let ReturnGO run its configured side effects.
- Refund and transaction review
- List refunds and payment transactions by status, type, processor or order, and update their status or external reference.
- Return shipment updates
- Read the tracking status of a return shipment and set its carrier, tracking number and label details.
- Webhook listing
- View the webhooks registered for the store along with their event subscriptions and target URLs.
- Usage and plan tools
- Check monthly tool-call usage and manage a Pro or Pro+ subscription from within the assistant.
Good for
- Find return requests that are waiting for approval
- Check which refunds are still in Requested status
- Reject an RMA with a stated reason and add a note to its timeline
- Add tracking numbers and carrier details to return shipments
- Review the webhooks configured for a store
Pricing
Freemium, from $9 a month
Free plan 50 calls/month; Pro from $9/mo; Pro+ $39/mo
Prices change. Check usefulapi.io before you buy.
ReturnGO MCP by usefulapi FAQ
Is this an official ReturnGO product?
No. The product page says usefulapi is an independent service and is not affiliated with or endorsed by ReturnGO.
What do I need to connect?
The login page asks for your ReturnGO API key and your store URL. The page says the key is created under ReturnGO Settings → API.
Can the AI change data in my store?
Yes. Five of the 13 tools can create or change data, and the README marks them as write tools. The page notes that most MCP clients ask for approval before a tool call runs.
What does it cost?
The Free plan allows 50 tool calls a month. Pro is $9/month or $90/year for 10,000 calls, and Pro+ is $39/month or $390/year for 100,000 calls.
Is ReturnGO MCP by usefulapi free?
ReturnGO MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.
How do I add ReturnGO MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http returngo https://returngo.usefulapi.io/mcp
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.