trial-matcher

name	trial-matcher
kind	oneshot
domain	trial
description	ClinicalTrials.gov v2 search for trials relevant to the patient's diagnosis and genes. Eligibility is surfaced as "may be eligible — confirm with your care team", never confirmed. Emits Tier C.

trial-matcher

Query ClinicalTrials.gov v2 (/api/v2/studies) with a tight fields= list for trials matching the diagnosis and genes. Emit Tier C EvidenceRecords.

Hard rule (spec §9): trial eligibility matching is a known-unsolved problem. Eligibility text needs an LLM parse, and the result is surfaced as "may be eligible — confirm with your care team", NEVER as confirmed eligibility. The code gate must pass every rendered string.

STATUS: live via app/trials.py against the public ClinicalTrials.gov v2 REST API (no MCP/auth needed). Runs only when BWCLS_LIVE_SOURCES=1; returns [] when off so the suite stays deterministic. Emits Tier C hedged records; free-text titles are gate-scanned and dropped if not clean. world-evidence-watch reuses the same search_trials for its diff.

NOTE: ClinicalTrials.gov's WAF returns 403 to this build environment's datacenter IP, so the live path is verified only by the offline tests (mocked API response) here; it degrades calmly to an empty Tier C (no crash) when the API is unreachable. It should work from a residential IP / the developer's machine. If the WAF blocks there too, switch to the developer's ClinicalTrials.gov MCP connector.

TODO (optional): add an LLM eligibility parse (still surfaced only as "may be eligible — confirm with your care team").