# Remedy

> Recall refunds in seconds. Many US product recalls offer a refund once the owner sends a photo showing the product made safe: the cord cut, the item cut in half, or "RECALLED" written on it. Remedy reads the official CPSC remedy as a checklist, verifies the owner's photo, and pays the refund through PayPal. It uses the CPSC's public recall data and is independent: not affiliated with the CPSC or any recalling firm. This deployment uses the PayPal sandbox; no real money moves.

447 of the 1239 US consumer product recalls from 2024-01-04 to 2026-11-05 refund an owner for a photo of the product made safe (CPSC Recalls API, read through each recall's proof rule).

## Connect

- MCP server (streamable HTTP): https://remedy-y0ym.onrender.com/api/mcp
- MCP Server Card: https://remedy-y0ym.onrender.com/api/mcp/server-card
- AI Catalog: https://remedy-y0ym.onrender.com/.well-known/ai-catalog.json
- REST API (OpenAPI 3.1): https://remedy-y0ym.onrender.com/openapi.json

## MCP tools

- ping: Confirms the Remedy MCP server is reachable and says which API version it serves.
- search_recalls: Finds US consumer product recalls since 2024 from plain words, for example "power bank" or "crib that tips over".
- scan_catalog: Checks a list of products (name, with model, SKU or brand when known) against every CPSC recall since 2024 at once.
- check_label: Says whether a product is recalled from a photo of its label (the rating plate, sticker or tag with the model number).
- get_proof_rule: Reads one recall's remedy as a proof rule: what to cut or mark on the product, what the photo must show, and the refund, with the official remedy text it came from.
- verify_photo: Checks an owner's photo against a recall's proof rule: right product, made safe, their own photo, within the recall.
- open_claim: Starts a refund claim for a recall.
- claim_status: Says where a claim stands: the checks, the decision, and the payment with its PayPal status.

## REST API

- GET /api/v1/recalls: Search US consumer product recalls since 2024 in plain words, or list the newest that fit the filters.
- GET /api/v1/recalls/{number}: One recall: its products, official images, hazard, the remedy exactly as published, and its proof rule with confidence per field.
- POST /api/v1/proof-rule: Turn a recall's remedy into a proof rule: what to cut or mark, what the photo must show, and the refund.
- POST /api/v1/verify: Check an owner's photo against a recall's proof rule: right product, made safe, their own photo, within the recall.
- POST /api/v1/label: Is it recalled? Send a photo of the product's label: Claude reads the brand, product, model numbers, UPC and lot or date codes, each with the text read, and code looks them up in every recall since 2024.
- POST /api/v1/claims: Open a claim with the owner's photo.
- GET /api/v1/claims/{id}: Where a claim stands: the six checks, the decision, and the payment with its PayPal status.
- POST /api/v1/claims/{id}/pay: Say where the refund goes, then pay it in the PayPal sandbox: a payout to PayPal or Venmo, a refund to the original PayPal purchase inside 180 days, or a safe replacement.
- GET /api/v1/claims/{id}/replacements: Products a verified owner can choose instead of money, found by Channel3, each checked against active recalls first.
- POST /api/v1/scan: Check a whole catalog at once.
- GET /api/v1/scan/sample: A small catalog built from real recalls in Remedy's data plus three everyday items no recall covers, ready to send to the scan.
- POST /api/v1/hash-pool/check: Ask whether a photo is already in the shared pool: every photo claimed on any recall at any firm, every hash a connected firm registered, and the published pictures of every recall.
- POST /api/v1/hash-pool/register: Add the hash of a photo your firm has paid a claim on, so the same photo sent to any other firm is held for a person before any model call.

Reads need no key. A free sandbox key (Authorization: Bearer rm_test_...) raises the limits and turns on the full photo checks.

## How to help someone with a recall

1. Find the recall with search_recalls, using the product's name or brand.
2. Read what to do with get_proof_rule, and tell them the steps in plain words.
3. Give them their own claim link from open_claim. They take the photo and choose where the refund goes.

## Learn

- [Recalls](https://remedy-y0ym.onrender.com/recalls): every recall since 2024, with its proof rule
- [How recalls work](https://remedy-y0ym.onrender.com/learn): the glossary and how every number was counted
- [Developers](https://remedy-y0ym.onrender.com/developers): keys, a live playground and docs
- [Evidence](https://remedy-y0ym.onrender.com/evidence): every number, its source, and the five-minute path