cyanheads / clinicaltrialsgov-mcp-server
Search ClinicalTrials.gov trials, retrieve study details and results, and match patients to eligible trials via MCP. STDIO or Streamable HTTP.
Why this job: name: mcp; says: mcp server; topics: mcp-server, model-context-protocol, mcp
What it does
- Free-text query plus field-specific conditionQuery / interventionQuery / locationQuery / sponsorQuery / titleQuery / outcomeQuery, statusFilter / phaseFilter enums (case and spacing variants accepted), advancedFilter (AREA[FieldName]value /
- Returns a compact per-study index by default (nctId, briefTitle, overallStatus, phases, enrollmentCount, hasResults, …); fields (PascalCase leaves) selects a full-fidelity projection — full records run ~70KB
- nctIds (up to 1000 entries, repeats collapsed) is served up to what fits one ClinicalTrials.gov request beside the other parameters — about 560 IDs on their own — with the rest returned unqueried in deferredNctIds, the same on every page of
- Typed errors. blank_value, ids_not_found, field_invalid, enum_invalid, query_parse_error, geo_invalid, sort_invalid, page_token_invalid, request_too_long, rate_limited
- Full protocol record by nctId, with optional locationLimit, outcomeLimit / referenceLimit, and nearLocation (lat, lon, radiusMi) to bound and sort locations — none has an upper bound; a value past the list returns all of it
Get started
git clone https://github.com/cyanheads/clinicaltrialsgov-mcp-server.git You need: Bun v1.4.0 or higher (or Node.js v24+).
- Maintenance
- Active
- Last commit 5 days ago
- Stars
- 100
- +1 this week
- Licence
- Apache-2.0
- Allows business use
- Downloads for
- None listed
- No release files
- Latest version
- v2.11.1
- Released 5 days ago
- Built with
- TypeScript
- 100% of the code
Is it looked after?
- Contributors
- 1
- Last 90 days
- Issues
- 94% closed
- 10 still open
- Pull requests
- 17 merged
- 0 waiting
- Releases
- 44
- 30+ in the last year
Similar repos
| Repo | Stars | Last commit | Licence | Downloads for |
|---|---|---|---|---|
| genomoncology / biomcp | 675 | 4 days ago | MIT | Mac, Windows, Linux |
More: languages, topics and project record
Languages
- TypeScript 100%
- Dockerfile <1%
Topics
- ai-agent
- bioinformatics
- clinical-trials
- clinicaltrials-gov
- cyanheads
- eligibility-criteria
- health-tech
- mcp
- mcp-server
- model-context-protocol
- patient-matching
- research-tools
Project record
- JobMCP servers
- StatusListed
- Commits469
- Forks24
- Watching0
- Stars in 28 days+4
- CreatedJun 17, 2025
- First seen by usNov 7, 2026
- CheckedNov 7, 2026
