# claimscout
> The structured registry of active US mass torts and class-action settlements.

Each *matter* is one upstream legal issue (e.g. Camp Lejeune water
contamination, Philips CPAP recall, hair relaxer uterine cancer MDL) with a
narrative card, eligibility hint, payout band, status, and lifecycle dates.
Each *signal* is an event updating a matter — court filing, FDA recall,
news article, social-media complaint cluster, regulatory action.

No public source curates active mass torts in structured form. claimscout
does. Read access is free and unauthenticated.

## Why an agent would use this

- Answer "what am I owed?" / "what class actions am I in?" without scraping.
- Brief a user on whether their hair relaxer use / CPAP usage / Camp Lejeune
  service maps to an active claim.
- Surface new mass torts as MDLs are filed (signals API).
- Submit a lead on behalf of a user (authed; see partner API).

## Two ways to use claimscout

1) **MCP server (Claude Desktop, Cursor, custom agents)**

   claimscout ships an MCP server that exposes matters as typed tools.
   Install:

       pip install --user 'mcp>=1.0' httpx
       # then either clone claimscout, or install the soon-to-be-published
       # `claimscout` PyPI package

   Add to `~/Library/Application Support/Claude/claude_desktop_config.json`
   (or the equivalent path for your MCP client):

       {
         "mcpServers": {
           "claimscout": {
             "command": "python3",
             "args": ["-m", "claimscout", "mcp", "serve"]
           }
         }
       }

   Restart Claude Desktop. Four new tools appear:
     - `matters_search`  enumerate/filter the matters registry
     - `matters_get`     full card for one matter
     - `signals_recent`  recent signals updating matters
     - `health`          counts + liveness

2) **REST API (any HTTP client)**

   List the universe:

       GET https://getclaimscout.com/api/v1/matters

   Get one matter:

       GET https://getclaimscout.com/api/v1/matters/camp-lejeune

   Filter:

       GET https://getclaimscout.com/api/v1/matters?status=claims_open&min_score=0.8
       GET https://getclaimscout.com/api/v1/matters?category=mass_tort&subcategory=medical_device

   Recent signals across the system:

       GET https://getclaimscout.com/api/v1/signals?limit=30

   Signals for one matter:

       GET https://getclaimscout.com/api/v1/signals?matter_id=mat_19e2a1f4f486e9

## Response shape

Every successful list response:

    {
      "data": [ ...matters... ],
      "pagination": {"limit": 30, "count": 20, "next": null},
      "filters":   { ... },
      "meta":      {"api_version": "v1", "schema_version": 1,
                    "self": "<this URL>",
                    "docs": "https://getclaimscout.com/openapi.json"}
    }

Every successful single-item response:

    {"data": {...}, "meta": {...}}

Errors:

    {"error": {"code": 404, "message": "no matter with slug='foo'"},
     "meta": {...}}

## Citing sources

Each matter carries `links.primary` (official source URL). Each signal
carries `provenance` (source_url, retrieved_at, author, confidence) and a
`url` field. Cite both when grounding agent output.

## Stability

- `schema_version: 1` on every record. We will bump on incompatible
  changes; old clients keep working until they choose to upgrade.
- ETags on every response. Cheap conditional GETs.

## Status snapshot (current matters)

claimscout tracks ~20 high-value anchor mass torts at launch (Camp Lejeune,
Philips CPAP, hair relaxer, Paraquat, Roundup, AFFF, 3M Combat Arms, social
media addiction, Tylenol/autism MDL, NEC infant formula, Paragard IUD,
Bard PowerPort, hernia mesh, hip implants, Suboxone tooth decay, talcum
powder, Zantac, plus representative data-breach class actions). The list
grows automatically as new MDLs are filed and the entity-resolver clusters
new signals.

## Schema (full)

https://getclaimscout.com/openapi.json

## Contact

ops@getclaimscout.com