io.github.cyanheads/clinicaltrialsgov-mcp-server
v2.10.0Search ClinicalTrials.gov: find studies, retrieve results, match patients to candidate trials.
Endpoint health
online- Last checked
- 11/20/2026, 9:17:59 AM
- Latency
- 229 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Fclinicaltrialsgov-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/clinicaltrialsgov-mcp-server": {
"url": "https://clinicaltrials.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
7 shown · authentication unknown
Clinicaltrials Find Eligible
clinicaltrials_find_eligible
Find candidate clinical trials for a patient profile. Provide age, sex, conditions, and location to get studies with their demographic limits, contact information, and recruiting locations. Candidates are matched on age, sex, location, recruitment status, and ClinicalTrials.gov's fuzzy condition search only — inclusion/exclusion criteria are not checked, and a candidate can exclude the requested condition, so review each one's criteria with clinicaltrials_get_study_record before treating it as a match. Results are re-ranked so studies whose own condition matches a requested condition surface above tangential matches from ClinicalTrials.gov's fuzzy condition search. Each candidate returns only the sites matching the requested location (capped by locationLimit), not the study's full registered site list — a large trial can register hundreds of sites worldwide. When none of a candidate's matched sites is recruiting, one recruiting site is added so an enrollable site is never hidden behind a closer closed one: the one nearest the matched sites by their published coordinates, in the requested country whenever a site there recruits, carrying distanceMi, or the first in match order when coordinates are missing. Fetch a study's complete record with clinicaltrials_get_study_record.
Schema valid · SHA-256 1223ec21ae98…
View input schema
{ "type": "object", "properties": { "age": { "type": "integer", "minimum": 0, "maximum": 120, "description": "Patient age as a whole number in ageUnit (years unless ageUnit says otherwise)." }, "ageUnit": { "description": "Unit age is given in: years (default), months, weeks, or days; case and singular forms are accepted. Use a smaller unit for an infant or young child whose eligibility window is narrower than a year — age 7 with ageUnit \"months\" matches a study registered for 6 Months to 8 Months, which no whole number of years reaches. ClinicalTrials.gov compares ages across units, so the unit only sets how precisely age is stated.", "type": "string", "enum": [ "years", "months", "weeks", "days" ] }, "sex": { "type": "string", "enum": [ "FEMALE", "MALE", "ALL" ], "description": "Patient's biological sex. Use 'ALL' to include studies regardless of sex restrictions." }, "conditions": { "type": "array", "items": { "type": "string" }, "description": "Medical conditions or diagnoses, e.g. [\"Type 2 Diabetes\", \"Hypertension\"]. Each entry is matched as a condition: an entry containing whitespace is quoted and matches as a phrase, and any other entry is sent as written, punctuation included (double quotes are stripped from every entry); multiple entries are combined with OR, so studies for any listed condition qualify. Returned studies are re-ranked so those whose own condition list names a requested condition rank above tangential matches the upstream fuzzy search pulls in via the MeSH umbrella." }, "location": { "type": "object", "properties": { "country": { "type": "string", "description": "Country name, e.g. \"United States\". Common synonyms rank sites as the registry spelling does: USA and US as United States, UK and England as United Kingdom, Czech Republic as Czechia, Republic of Korea as South Korea, and PR, GU, VI, AS, and MP as the US territories, which the registry files as countries." }, "state": { "description": "State or province, compared with the state the site files. A US state or DC abbreviation (WA, DC) is compared as its full name when the country is the United States or a synonym for it. With city also given, a site that files no state still matches; without city, only sites filing this state match.", "type": "string" }, "city": { "description": "City name.", "type": "string" } }, "required": [ "country" ], "additionalProperties": false, "description": "Patient location as `{ country (required), state?, city? }`. Country is required; state/city narrow the match. Every part given must hold for the same study site: country and state are compared with the site's filed country and state, while city is matched against the site's whole location text, so a site filed under a borough or neighbouring town that names the city still counts. For radius-based geographic search, use clinicaltrials_search_studies with geoFilter." }, "healthyVolunteer": { "default": false, "description": "Whether the patient is a healthy volunteer. When true, only studies accepting healthy volunteers are queried.", "type": "boolean" }, "recruitingOnly": { "default": true, "description": "Only include actively recruiting studies.", "type": "boolean" }, "maxResults": { "default": 10, "description": "Maximum candidates to return. Default 10; a larger value returns at most 50 and says so in truncated/shown/cap when more studies match, and the searchCriteria replay through clinicaltrials_search_studies pages the rest.", "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "locationLimit": { "default": 10, "description": "Cap on the sites returned per candidate. Each candidate keeps only the sites matching the requested location at the narrowest level that matched (city, else state, else country), capped at this many; the rest of the study's registered sites are omitted. The cap governs those matched sites — when none of them is recruiting, one recruiting site is added on top of it (the nearest to any matched site, measured before this cap, when coordinates allow — in the requested country whenever a site there recruits), so a candidate can carry one site more than this. Raise it to see more nearby sites — there is no upper bound, and a limit past the matched sites returns all of them — or fetch the complete site list with clinicaltrials_get_study_record. Each candidate reports totalLocations / matchedLocations / locationsTruncated / nearestRecruitingSiteAdded in locationSummary only when the bound actually dropped sites.", "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "age", "sex", "conditions", "location" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://clinicaltrials.caseyjhand.com/mcp