Returnly

Fair

Agent Native Score

API Key AuthOpenAPI Spec

Returnly is a returns management platform that enables seamless, embeddable return flows for e-commerce businesses. It provides API integrations for processing refunds, exchanges, and store credits across multiple channels.

Categories: Ecommerce · Returns Management · Fulfillment

#28 of 28 in Ecommerce · #2 of 2 in Returns Management · #5 of 6 in Fulfillment

Checklist Breakdown

10 of 33 checks passed. 14 unscored.

Discovery 63%

Can an agent find and understand this tool without a web search?

✓ Published OpenAPI/Swagger spec

✗ Has llms.txt or llms-full.txt

✗ Has an MCP server (official or well-maintained)

✗ MCP server listed in a public registry

✓ API reference docs are publicly accessible

✓ Docs include runnable code examples

✓ Has a public changelog or release notes

✓ Has a public status page

Auth & Onboarding 33%

Can an agent create an account and get credentials without human intervention?

✗ Signup does not require CAPTCHA

✗ Signup does not require phone verification

✓ Supports API key auth (not only OAuth)

✗ API key obtainable without manual approval

✗ No mandatory billing info to start

✓ Can sign up without creating an organization

Pricing 60%

Can an agent operate autonomously without upfront payment or contracts?

✗ Has a free tier

✓ Usage-based pricing available

✓ No minimum contract or commitment

✓ Pricing page is public (no 'contact sales')

✗ Free tier sufficient for testing (not just a trial)

Agent Tooling Not yet scored

How well does the API work for non-human consumers?

— SDK available in 2+ languages

— Structured error responses (JSON with error codes)

— Idempotency support on write endpoints

— Pagination on list endpoints

— Webhook/event support

— Sandbox or test mode available

— Rate limit headers in responses

— Consistent REST resource naming

Reliability Not yet scored

Does the tool fail gracefully when an agent makes a mistake?

— Meaningful error messages (not just 500)

— 429 responses include Retry-After header

— Documented uptime SLA (99.9%+)

— Graceful degradation under rate limits

— Request IDs in responses for debugging

— API versioning supported

Reviewer Notes

Returnly has functional API documentation and a sandbox environment, which supports basic agent integration. However, account creation requires human signup with business verification, blocking autonomous agent onboarding. Discovery is hindered by lack of an MCP server, OpenAPI spec availability is unclear from public docs, and no llms.txt file exists. The API returns structured JSON for returns processing, but comprehensive error handling details and rate limit documentation are sparse. The freemium model requires credit card upfront for production use.

Returnly

Let your agents find tools like Returnly