Skip to main content

​
Server Description

The Redo MCP Server lets AI assistants interact with your Redo merchant account through the Model Context Protocol. You can manage returns, look up order details, update statuses, process items, and message the Redo support AI — all from your preferred AI assistant. The server works with any MCP-compatible client, including Claude, ChatGPT, Cursor, VS Code (GitHub Copilot), Windsurf, and Codex. Server URL: 
https://mcp.getredo.com/mcp

​
Setup Instructions

​
Authentication

Authentication is handled via OAuth. On first connection, you will be redirected to the Redo merchant app to authorize access. No API keys or manual token management is required.
  • Your AI assistant initiates the OAuth flow automatically when it first calls a Redo tool
  • You authorize the connection in your browser through the Redo merchant app
  • The session persists until you revoke access or the token expires
The MCP server only has access to data within your Redo merchant account. Each user authenticates individually.

​
CLI installation

claude mcp add --transport http redo https://mcp.getredo.com/mcp

codex mcp add redo -- npx -y mcp-remote https://mcp.getredo.com/mcp

​
JSON configuration

For tools that use a JSON config file, add the following server entry using the config specific to your tool below.
Open the Claude Desktop app and go to Settings > Developer > Edit Config to open claude_desktop_config.json. You can also open the file directly:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the redo server to the mcpServers object:
{
  "mcpServers": {
    "redo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.getredo.com/mcp"]
    }
  }
}
Restart Claude Desktop after saving.
Install in CursorOr install manually: go to Cursor Settings > Tools & MCP > New MCP Server. You can also add to .cursor/mcp.json in your project root for project-specific config.
{
  "mcpServers": {
    "redo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.getredo.com/mcp"]
    }
  }
}
Restart Cursor after saving.
Install in VS CodeOr install manually: open the command palette (Cmd+Shift+P / Ctrl+Shift+P) and search for MCP: Add Server. Select User Settings for global config, or add to .vscode/mcp.json in your project root.
{
  "servers": {
    "redo": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.getredo.com/mcp"]
    }
  }
}
Reload VS Code after saving.
Follow the configure MCP guide using the config below.
{
  "mcpServers": {
    "redo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.getredo.com/mcp"]
    }
  }
}

​
ChatGPT

  1. Go to Settings > Apps > Create app (Advanced settings)
  2. Enter a name (e.g. “Redo”) and optionally add a description
  3. Set the MCP Server URL to https://mcp.getredo.com/mcp
  4. Set Authentication to OAuth and leave the Client ID and Client Secret fields blank
  5. Check the “I understand and want to continue” box
  6. Click Create
To use it in a conversation, click the + button in the message composer, select More, and choose the Redo connector.

​
Features

The Redo MCP Server provides tools for return and claim management:
ToolDescription
list_returnsSearch returns by order name, customer email, status, or date range. Supports pagination.
get_returnGet full return details including items, status, compensation totals, and order info.
process_returnAccept or reject each item in a return, with options for restocking and grading.
update_return_statusChange a return’s status (in_transit, delivered, needs_review, in_review, flagged, pre-shipment).
reopen_returnReopen a completed or rejected return, resetting items back to open.
close_returnClose a return without processing — marks all items as complete with no further action.
create_return_commentAdd a comment to a return’s timeline.
approve_returnApprove a return so the customer can proceed with shipping items back.
ask_redoAsk the Redo support AI any question about your account, settings, policies, or platform features.

​
Usage Examples

​
Search for returns by status

Prompt:
Show me all open returns.
The AI will call list_returns with a status filter to find all open returns and display a summary of each.

​
Get details about a return

Prompt:
Get me the details about the return for order #1234.
The AI will call get_return to fetch full details including item statuses, compensation amounts, and order information.

​
Process a return

Prompt:
Process the return for order #5678 — accept all items.
The AI will call get_return to retrieve the return’s items and their IDs, confirm the details with you, then call process_return to accept each item.

​
Ask a question about your Redo account

Prompt:
Ask Redo what my return flow is configured to do. What eligibility checks, return options, and fees are set up?
The AI will call ask_redo to ask the Redo support AI, which has access to your account’s configuration and can describe your specific return flow steps, conditions, and settings.

​
Rate Limits

The server enforces a rate limit of 500 requests per minute per authenticated user. If you exceed this limit, requests will receive a 429 Too Many Requests response with a Retry-After header indicating when you can retry.

​
Privacy Policy

Redo’s privacy policy is available at https://www.getredo.com/en/privacy-policy. The MCP server accesses your Redo merchant data on your behalf using your authenticated session. Data is transmitted securely over HTTPS and is not stored beyond what is needed to fulfill each request.

​
Support

For help or to report an issue, email support@getredo.com.