Add returns to your store with an AI agent
Building a store with an AI website builder or a coding agent? Returnloop gives it a returns, exchanges and claims portal it can set up and run itself, through our MCP server and API.
What an agent needs to know
- Price
- No monthly fee. The first 100 returns every month are free, then 2 kr, 1 kr above 2,000 and 0.50 kr above 10,000 per return. SEK excluding VAT.
- Test returns
- Never counted, and neither are cancelled returns.
- Platforms
- Any platform that can share its orders: our Order API, a feed or Business Central. Direct connectors for other platforms are built on request at no cost.
- Setup
- An MCP server with tools for settings, integrations and returns, and an API with scoped keys.
- Data
- Stored in the EU, with a Data Processing Agreement.
- Portal languages
- Swedish, English, Norwegian and Danish.
Set it up
- 1
Create the account
A person signs up with a work email and opens the sign-in link. It is the one step an agent cannot do for you.
- 2
Connect the assistant
Add the MCP server below. Claude and ChatGPT sign in to Returnloop. Claude Code, Cursor and scripts send an API key from admin, under Connections, API keys.
- 3
Share the orders
Answer order lookups in the Order API format, point Returnloop at a feed, or connect Business Central.
- 4
Let the agent finish the setup
It starts with setup_status, which lists what is missing to go live: markets, return windows, carriers and the portal's look.
- 5
Try a return
create_test_order makes a test order of your real products with a portal link. Test returns are never billed.
Sign in: Claude and ChatGPT
Claude (claude.ai and Claude Desktop)
Settings, Connectors, Add custom connector. Paste the URL, then sign in to Returnloop and approve.
https://api.getreturnloop.com/mcp
ChatGPT
Settings, Apps and Connectors, Create (developer mode). Paste the URL, choose OAuth, then sign in to Returnloop and approve.
https://api.getreturnloop.com/mcp
API key: Claude Code, Cursor and scripts
Claude Code
Run in a terminal.
claude mcp add --transport http returnloop https://api.getreturnloop.com/mcp --header "Authorization: Bearer <your Returnloop API key>"
Cursor
~/.cursor/mcp.json, or .cursor/mcp.json in a project.
{
"mcpServers": {
"returnloop": {
"url": "https://api.getreturnloop.com/mcp",
"headers": {
"Authorization": "Bearer <your Returnloop API key>"
}
}
}
}OpenAI API and scripts
A tool in a Responses API request, or any MCP client that sends a header.
{
"type": "mcp",
"server_label": "returnloop",
"server_url": "https://api.getreturnloop.com/mcp",
"headers": {
"Authorization": "Bearer <your Returnloop API key>"
},
"require_approval": "always"
}A prompt to start with
Use the Returnloop MCP server (https://api.getreturnloop.com/mcp). Run setup_status, then set up what is missing for our store to go live: markets and return windows, return reasons, our return carrier, and a portal design from our shop's address. When an integration needs keys, give me the credentials_link instead of asking for them in chat. Finish with create_test_order so I can try a return.
Read more
- MCP server docsConnecting, sign-in, scopes and every tool.
- Order API docsThe order format Returnloop reads from your store.
- llms.txtA short summary for AI assistants.
- llms-full.txtEverything on this site as plain text.
- pricing.jsonThe price list, machine readable.