# ReturnCheck

> ReturnCheck verifies which return policy actually applies to this purchase.
> It gives AI shopping agents a verified verdict (YES / YES_WITH_CONDITIONS /
> NO / UNKNOWN) with the exact policy clause quoted verbatim, source URL,
> return window and confidence.
> It never invents: if it cannot verify a clause on the page, it returns UNKNOWN.

## Use it
- MCP endpoint (Streamable HTTP): https://returncheck.m-angelmartinez-fer.workers.dev/mcp  (tool: check_return)
- HTTP: POST https://returncheck.m-angelmartinez-fer.workers.dev/v1/check  {"product_url":"...","buyer_country":"US","page_text":"..."}
- Free trial: a few calls per day with no API key. Then $0.02/verified query; UNKNOWN is free.
- Sign up for an API key (free credit): POST https://returncheck.m-angelmartinez-fer.workers.dev/v1/signup {"email":"..."}
- OpenAPI: https://returncheck.m-angelmartinez-fer.workers.dev/openapi.json

## Input
- product_url (required), buyer_country (required, ISO alpha-2)
- page_text or page_html (RECOMMENDED) — the page you already have open. We verify
  against it instead of fetching. We still never invent: no verifiable clause -> UNKNOWN.
- optional: item_condition, reason, purchase_date, delivery_date, merchant, seller_name, buyer_state, as_of, membership, purchase_channel

## Coverage, measured — not estimated
Measured 2026-08-28 on 50 US retailers, one live product page each, chosen before
the run and frozen:
- WITH page_text/page_html from you: we work on whatever you send. Any store.
- WITHOUT it, we fetch the page ourselves and reach the policy for 17 of 50 (34%).
  Mostly Shopify and direct-to-consumer brands. 15 of 50 refused a server-side read
  outright (403/429/451); the rest render their pages with JavaScript or bury the
  policy where we do not find it.
Your agent already has the page open, renders JavaScript, and is not blocked.
Sending it is faster and far more likely to get an answer. That is the design.

## Example (HTTP)
Request:  POST https://returncheck.m-angelmartinez-fer.workers.dev/v1/check
  {"product_url":"https://store.example/p/shoe","buyer_country":"US","item_condition":"unopened",
   "page_text":"Returns & Refunds. Eligible items may be returned within 30 days of delivery..."}
Response: {"verdict":"YES_WITH_CONDITIONS","returnable":true,"confidence":0.9,
  "policy":{"merchant_return_days":30,...},
  "evidence":{"source_url":"...","exact_clause":"Items may be returned within 30 days...","verified_on":"..."}}

## Why call it
- Verified, not guessed: every YES/NO carries the exact clause + source URL, or it is UNKNOWN (free).
- You can read the page; you cannot prove later what it said. We quote it verbatim and date it.
- Built for agent-to-agent commerce: MCP tool + x402-friendly micro-pricing ($0.02/verified answer).
- Neutral: works across merchants; we sell to every shopping agent, we don't compete with them.

## Evidence Cards — free, no key, no charge
Published answers to specific return-policy questions, each quoting the merchant's own
clause with its source URL and the date we read it. Every card exists twice under one
stable card_id: an HTML page for people and the identical data as JSON for you.
- Index: https://returncheck.m-angelmartinez-fer.workers.dev/cards  ·  as JSON: https://returncheck.m-angelmartinez-fer.workers.dev/cards.json
- One card: https://returncheck.m-angelmartinez-fer.workers.dev/cards/{card_id}  ·  as JSON: https://returncheck.m-angelmartinez-fer.workers.dev/cards/{card_id}.json
- Sitemap: https://returncheck.m-angelmartinez-fer.workers.dev/sitemap.xml
These are hand-reviewed and dated, not generated on demand. For a specific purchase,
call check_return — the cards cannot know your item, seller or dates.

## Discovery
- MCP manifest (tool list): https://returncheck.m-angelmartinez-fer.workers.dev/mcp
- OpenAPI: https://returncheck.m-angelmartinez-fer.workers.dev/openapi.json  ·  Plugin manifest: https://returncheck.m-angelmartinez-fer.workers.dev/.well-known/ai-plugin.json
- Agents manifest: https://returncheck.m-angelmartinez-fer.workers.dev/agents.json

## Data & sources
- What we store, why, and how merchants get it removed: https://returncheck.m-angelmartinez-fer.workers.dev/data-policy