Shopigent Returns
Returns that handle themselves — AI-powered return management for Shopify stores.
Shopigent Returns is a full-stack Shopify app that automates the entire return process using AI agents. From policy configuration to fraud detection to refund execution — the agent handles it all, saving merchants 10+ hours per week.
What it does
- AI Agent (MCP) — an MCP-powered agent receives return requests, evaluates them against policies, approves or denies, executes refunds in Shopify, and flags suspicious activity — all automatically.
- Policy Engine — configurable rules: time windows, max amounts, restocking fees. Auto-approve low-risk returns, flag edge cases for manual review.
- Customer Portal — a self-service
/returnendpoint where customers enter their email, select items from their order, and submit. The AI agent processes the rest. - Fraud Detection — IP analysis, velocity checks, amount anomaly detection. High-risk returns get flagged automatically.
- Auto-Refund — the agent executes refunds directly via the Shopify Admin API. No manual clicks needed.
- Label Generation — integrates with SendCloud, Shippo, or EasyPost for automatic return label generation on approval.
- Analytics Dashboard — total returns, resolution rate, average time-to-resolve, fraud signals, trending return reasons, and most-returned products.
Architecture
The app is built as a modern Shopify embedded app:
- Frontend: Remix + Shopify Polaris (embedded in Shopify admin)
- Backend: Remix with Prisma ORM + PostgreSQL
- MCP Server: standalone Express server exposing 7+ AI agent tools (analyze return, approve/deny, check fraud, execute refund, get return details, list returns, update return status, get policy, update policy)
- Docs Site: Express + markdown, zero-build (same pattern as shopigent.greeknous.com)
- Infrastructure: Railway (app + MCP server + Postgres + docs site)
The product thesis
Returns are one of the most manual, repetitive operations in ecommerce. Most returns follow predictable patterns: within 30 days, no visible damage, standard product. A human reading each one is a waste. An AI agent can make 90% of the decisions, and surface the edge cases for human review. The 10% that needs a human gets better attention because you're not burned out on the 90%.
Status
Version 1.0 complete — deployed and operational. Currently preparing for Shopify App Store submission. Docs and pricing live at the link above.