Skip to content
The Daily Repo

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

Repos similar to this one
RepoStarsLast commitLicenceDownloads for
genomoncology / biomcp6754 days agoMITMac, 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

Type to search.

Try