io.github.cyanheads/clinicaltrialsgov-mcp-server
REMOTE · CLINICALTRIALS.CASEYJHAND.COM · 2 COMPONENTS · SCANNED SEP 21
Search ClinicalTrials.gov — find studies, retrieve results, match patients to eligible trials.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security66
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 7 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability73
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 5628 tokens (~804/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 7 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 8 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the io.github.cyanheads/clinicaltrialsgov-mcp-server server?
io.github.cyanheads/clinicaltrialsgov-mcp-server is a hosted endpoint at https://clinicaltrials.caseyjhand.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · clinicaltrials.caseyjhand.com
claude mcp add --transport http cyanheads-clinicaltrialsgov-mcp-server 'https://clinicaltrials.caseyjhand.com/mcp'
{
"mcpServers": {
"cyanheads-clinicaltrialsgov-mcp-server": {
"url": "https://clinicaltrials.caseyjhand.com/mcp"
}
}
} {
"servers": {
"cyanheads-clinicaltrialsgov-mcp-server": {
"type": "http",
"url": "https://clinicaltrials.caseyjhand.com/mcp"
}
}
} [mcp_servers.cyanheads-clinicaltrialsgov-mcp-server] url = "https://clinicaltrials.caseyjhand.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-clinicaltrialsgov-mcp-server": {
"type": "remote",
"url": "https://clinicaltrials.caseyjhand.com/mcp",
"enabled": true
}
}
} openclaw mcp add cyanheads-clinicaltrialsgov-mcp-server --url 'https://clinicaltrials.caseyjhand.com/mcp' --transport streamable-http
mcp_servers:
cyanheads-clinicaltrialsgov-mcp-server:
url: "https://clinicaltrials.caseyjhand.com/mcp" {
"McpServers": {
"cyanheads-clinicaltrialsgov-mcp-server": {
"Transport": "http",
"Url": "https://clinicaltrials.caseyjhand.com/mcp"
}
}
} assistant mcp add cyanheads-clinicaltrialsgov-mcp-server -t streamable-http -u 'https://clinicaltrials.caseyjhand.com/mcp'
{
"mcpServers": {
"cyanheads-clinicaltrialsgov-mcp-server": {
"type": "http",
"url": "https://clinicaltrials.caseyjhand.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 18 Sept 26 0
- Server version: 2.9.7 → 2.9.8 functional
- 13 Sept 26 0
- Server version: 2.9.6 → 2.9.7 functional
- 12 Sept 26 0
- Tool “clinicaltrials_get_study_results” rewrote its description, which is the text the model reads security
- Server version: 2.9.5 → 2.9.6 functional
- Server version: 2.9.4 → 2.9.5 functional
- Server version: 2.9.3 → 2.9.4 functional
- “clinicaltrials_get_study_results” added an optional parameter “otherEventOffset” cosmetic
- “clinicaltrials_get_study_results” added an optional parameter “outcomeOffset” cosmetic
- “clinicaltrials_get_study_results” added an optional parameter “seriousEventOffset” cosmetic
- “clinicaltrials_search_studies” reworded the description of “geoFilter” cosmetic
- “clinicaltrials_get_study_results” reworded the description of “nctIds” cosmetic
- “clinicaltrials_get_study_results” reworded the description of “summary” cosmetic
- 9 Sept 26 +1
- Stability: 0.97 → pass security
- 7 Sept 26 −1
- Stability: pass → 0.93 functional
- 3 Sept 26 0
- Server version: 2.9.2 → 2.9.3 functional
- 26 Aug 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 25 Aug 26 0
- Stability: 0.97 → pass security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Sept 2026 · Probed https://clinicaltrials.caseyjhand.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=caseyjhand.com | CN=WE1,O=Google Trust Services,C=US | 4 Sept 2026 | 3 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | a6985204ed51ae050e7738aa6be668e9 |
| SANs: caseyjhand.com, *.caseyjhand.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC secure
Validation of clinicaltrials.caseyjhand.com. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| caseyjhand.com. | present | 2371 | 13 | Verified |
| clinicaltrials.caseyjhand.com. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000; includeSubDomains; preload |
| x-content-type-options | nosniff |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://clinicaltrials.caseyjhand.com/mcp | Verified | 200 | |
| http (plaintext) | http://clinicaltrials.caseyjhand.com/mcp | HTTPS enforced | 301 | https://clinicaltrials.caseyjhand.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
clinicaltrials_find_eligible Clinicaltrials Find Eligible ~524
Match patient demographics and conditions to eligible recruiting clinical trials. Provide age, sex, conditions, and location to find studies with matching eligibility criteria, contact information, and recruiting locations. 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, its nearest recruiting site is added, so an enrollable site is never hidden behind a closer closed one. Fetch a study's complete record with clinicaltrials_get_study_record.
| Name | Type | Req | Description |
|---|---|---|---|
| age | integer | yes | Patient age in years. |
| conditions | array | yes | Medical conditions or diagnoses, e.g. ["Type 2 Diabetes", "Hypertension"]. Each entry is matched as a condition (multi-word entries match as a phrase); multiple entries are combined with OR, so studi… |
| healthyVolunteer | boolean | – | Whether the patient is a healthy volunteer. When true, only studies accepting healthy volunteers are queried. |
| location | object | yes | Patient location as `{ country (required), state?, city? }`. Country is required; state/city narrow the match. For radius-based geographic search, use clinicaltrials_search_studies with geoFilter. |
| locationLimit | integer | – | 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;… |
| maxResults | integer | – | Maximum results to return. |
| recruitingOnly | boolean | – | Only include actively recruiting studies. |
| sex | string | yes | Patient's biological sex. Use 'ALL' to include studies regardless of sex restrictions. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| funnel | object | – | Match counts at each filter stage. Shows where the funnel collapsed — e.g., conditionMatched=298 but demographicsMatched=2 means age/sex/status are the constraint. |
| notice | string | – | Recovery guidance when no studies matched — identifies which filter stage collapsed and suggests how to broaden. Absent when results are returned. |
| searchCriteria | object | – | Normalized search criteria applied to this eligibility query, including the exact upstream query strings needed to reproduce the full match set via clinicaltrials_search_studies (replay with includeU… |
| studies | array | – | Matching studies with eligibility and location fields. Each candidate's protocolSection.contactsLocationsModule.locations is BOUNDED to the sites matching the requested location (capped at locationLi… |
| totalCount | number | – | Total matching studies from the API. |
No examples provided.
clinicaltrials_get_field_definitions Clinicaltrials Get Field Definitions ~341
Resolve valid field names from the ClinicalTrials.gov data model — the canonical PascalCase identifiers (OverallStatus, EnrollmentCount, LeadSponsorName) accepted by the `fields`, `advancedFilter`, and `sort` parameters of other tools, and as input to clinicaltrials_get_field_values. Select a mode: `"search"` — keyword search returning ranked matches (pass `query`, e.g. "enrollment", "sponsor", "adverse events"); `"drill"` — drill into a specific section by dot-notation path (pass `path`, e.g. "protocolSection.designModule"); `"overview"` — top-level summary of all sections (no additional args).
| Name | Type | Req | Description |
|---|---|---|---|
| includeIndexedOnly | boolean | – | drill mode only. Only return indexed (searchable) fields. Default: false. |
| limit | integer | – | search mode only. Maximum results to return. Default: 20. |
| mode | string | yes | Operation mode. "search" — keyword search (requires `query`); "drill" — drill into a section by path (requires `path`); "overview" — list all top-level sections (no other args needed). |
| path | string | – | drill mode only. Dot-notation path to drill into — e.g., "protocolSection.designModule", "protocolSection.eligibilityModule", "resultsSection". Returns the section's individual fields. |
| query | string | – | search mode only. Keyword to search field names by — e.g., "enrollment", "sponsor", "adverse events". Returns matching field names ranked by relevance with their full paths and data types. |
| Name | Type | Req | Description |
|---|---|---|---|
| cap | number | – | The limit cap applied to this search (search mode only). |
| error | object | – | Present when the call failed. Absent on success. |
| fields | array | – | Field definitions, ordered by relevance when mode is "search". |
| notice | string | – | Recovery guidance when search mode returns no matches, or a truncation note when results are capped. |
| resolvedPath | string | – | Resolved path when mode is "drill". |
| searchQuery | string | – | Echo of the keyword used in search mode. Absent for drill and overview. |
| shown | number | – | Number of fields returned (search mode only). |
| totalFields | number | – | Total fields returned. |
| totalMatches | number | – | Total fields matching the query before the limit cap was applied (search mode only). Compare against `shown` to size a follow-up limit, or to see that a capped result set is barely over the cap rathe… |
| truncated | boolean | – | True when the field list was capped by the limit parameter (search mode only). |
No examples provided.
clinicaltrials_get_field_values Clinicaltrials Get Field Values ~120
Discover valid values for ClinicalTrials.gov fields with study counts per value. Use to explore available filter options before building a search — e.g., valid OverallStatus, Phase, InterventionType, StudyType, or LeadSponsorClass values.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | – | yes | PascalCase field name(s) to get value statistics for — an empty list is rejected, not treated as "every field". Examples: OverallStatus, Phase, StudyType, Sex, LeadSponsorClass. Use clinicaltrials_ge… |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| fieldStats | array | – | One entry per requested field: canonical path, PascalCase piece name, data type, and the statistics variant that type carries — top values with study counts plus unique/longest for ENUM/STRING, trueC… |
No examples provided.
clinicaltrials_get_study_count Clinicaltrials Get Study Count ~1,331
Get total clinical trial study count from ClinicalTrials.gov matching a query, without fetching study data. Fast and lightweight. Use for quick statistics or to build breakdowns by calling multiple times with different filters (e.g., count by phase, count by status, count recruiting vs completed for a condition).
| Name | Type | Req | Description |
|---|---|---|---|
| advancedFilter | string | – | Advanced filter using AREA[FieldName]value syntax. Examples: "AREA[StudyType]INTERVENTIONAL", "AREA[EnrollmentCount]RANGE[100, 1000]", "AREA[Phase]PHASE2 AND AREA[StudyType]INTERVENTIONAL", "(AREA[Ph… |
| conditionQuery | string | – | Condition/disease-specific search. E.g., "Type 2 Diabetes", "non-small cell lung cancer". Matches Condition, BriefTitle, OfficialTitle, ConditionMeshTerm, ConditionAncestorTerm, Keyword, and NCTId. C… |
| includeUnknownEnrollment | boolean | – | Include studies whose EnrollmentCount is the upstream "unknown" sentinel (99999999). Excluded by default — the sentinel pollutes RANGE[N, MAX] queries. Set true for data-quality audits. |
| interventionQuery | string | – | Intervention/treatment search. E.g., "pembrolizumab", "cognitive behavioral therapy". Matches InterventionName, InterventionType, ArmGroupType, InterventionOtherName, BriefTitle, OfficialTitle, ArmGr… |
| locationQuery | string | – | Location search — city, state, country, or facility name. Matches LocationCity, LocationState, LocationCountry, LocationFacility, and LocationZip; a study matches when any of its sites does. Plain wo… |
| outcomeQuery | string | – | Search within outcome measure fields. Matches PrimaryOutcomeMeasure, SecondaryOutcomeMeasure, OtherOutcomeMeasure, and OutcomeMeasureTitle, plus their description counterparts PrimaryOutcomeDescripti… |
| phaseFilter | – | – | Filter by trial phase. Omit to count all phases — an empty list is rejected, not treated as "no filter". Values: EARLY_PHASE1, PHASE1, PHASE2, PHASE3, PHASE4, NA. |
| query | string | – | General free-text search across all fields. Runs the 57-field relevance search ClinicalTrials.gov publishes for this parameter — NCTId, NCTIdAlias, OrgStudyId, SecondaryId, Acronym, BriefTitle, Offic… |
| sponsorQuery | string | – | Sponsor/collaborator name search. Matches LeadSponsorName, CollaboratorName, and OrgFullName. Plain words plus AND/OR/NOT. `[ ]` are valid only inside an AREA[FieldName]value or RANGE[min, max] expre… |
| statusFilter | – | – | Filter by study status. Omit to count all statuses — an empty list is rejected, not treated as "no filter". Values: RECRUITING, COMPLETED, ACTIVE_NOT_RECRUITING, NOT_YET_RECRUITING, ENROLLING_BY_INVI… |
| titleQuery | string | – | Search within study titles and acronyms only. Matches Acronym, BriefTitle, and OfficialTitle. Plain words plus AND/OR/NOT. `[ ]` are valid only inside an AREA[FieldName]value or RANGE[min, max] expre… |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| notice | string | – | Recovery guidance when totalCount is 0 — suggests how to broaden the query or filters. |
| searchCriteria | object | – | Echo of active query/filter criteria applied to this count, including sentinelFilterActive when the default unknown-enrollment exclusion is in effect. |
| totalCount | number | – | Total studies matching the query/filters. |
No examples provided.
clinicaltrials_get_study_record Clinicaltrials Get Study Record ~391
Fetch a single clinical trial study by NCT ID from ClinicalTrials.gov. Returns the full study record including protocol details, eligibility criteria, outcomes, arms, interventions, contacts, and locations. Optional locationLimit / outcomeLimit / referenceLimit / nearLocation parameters trim locations, outcomes, and references — original totals are preserved in `filtersApplied` only when a cap actually trims the set.
| Name | Type | Req | Description |
|---|---|---|---|
| locationLimit | integer | – | Optional cap on the number of locations returned. Omit for no cap (full upstream list). Pairs naturally with nearLocation for narrowing a large multi-site trial. Original total preserved in filtersAp… |
| nctId | string | yes | NCT identifier — format `NCT` followed by 8 digits (e.g., `NCT03722472`). |
| nearLocation | object | – | Filter returned locations to those within radius of (lat, lon) and sort by distance. Adds distanceMi to each location. Locations without published coordinates are dropped — most US sites carry them;… |
| outcomeLimit | integer | – | Optional cap on the number of secondary and other outcomes returned. Omit for no cap (full upstream lists). Primary outcomes are never capped. Original totals preserved in filtersApplied.totalSeconda… |
| referenceLimit | integer | – | Optional cap on the number of references returned. Omit for no cap (full upstream list). Original total preserved in filtersApplied.totalReferences only when the cap trims the list. seeAlsoLinks are… |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| filtersApplied | object | – | Metadata about the filtering applied to `study`. |
| resultsSummary | object | – | Compact counts of posted results, present when hasResults is true. The full resultsSection is intentionally omitted from this record-level tool — fetch it via clinicaltrials_get_study_results or the… |
| study | object | – | Full study record with caller-requested filters already applied to locations and outcomes. Top-level keys: protocolSection (identification, status, sponsor, conditions, design, arms/interventions, ou… |
No examples provided.
clinicaltrials_get_study_results Clinicaltrials Get Study Results ~945
Fetch clinical trial results data from ClinicalTrials.gov for completed studies — outcome measures with statistics, adverse events, participant flow, baseline characteristics, and results metadata (limitations & caveats, certain-agreement disclosure restrictions, results point of contact). Only available for studies where hasResults is true. Use clinicaltrials_search_studies first to find studies with results. A results-rich record can exceed 500KB per study in full mode — bound it with summary=true, narrower sections, or the outcomeLimit / adverseEventLimit caps. A bounded list is resumable: outcomeOffset / seriousEventOffset / otherEventOffset start the next window, and each study's filtersApplied reports what was trimmed and the next offset for every list left short. A previous (alias) NCT ID resolves to its canonical study, named in canonicalNctId.
| Name | Type | Req | Description |
|---|---|---|---|
| adverseEventLimit | integer | – | Optional cap on the number of serious and other adverse events returned per study, applied to each list separately in upstream order. Omit for no cap (every event). Applies to full mode only — summar… |
| nctIds | – | yes | One or more NCT IDs (max 20) — an empty list is rejected, and a repeated ID collapses to one results entry in first-occurrence order. E.g., "NCT12345678" or ["NCT12345678", "NCT87654321"]. Use summar… |
| otherEventOffset | integer | – | Optional index of the first other (non-serious) adverse event to return, in upstream order. Omit or 0 to start at the first. Pages independently of seriousEventOffset and pairs with adverseEventLimit… |
| outcomeLimit | integer | – | Optional cap on the number of outcome measures returned per study, taken in the order ClinicalTrials.gov publishes them. Omit for no cap (every measure). Applies to full mode only — summary mode is a… |
| outcomeOffset | integer | – | Optional index of the first outcome measure to return, in the order ClinicalTrials.gov publishes them. Omit or 0 to start at the first. Pair with outcomeLimit to page a long list: each response repor… |
| sections | – | – | Filter which sections to return. Values: outcomes, adverseEvents, participantFlow, baseline, moreInfo. Omit for all sections — an empty list is rejected, not treated as omission. |
| seriousEventOffset | integer | – | Optional index of the first serious adverse event to return, in upstream order. Omit or 0 to start at the first. Pages independently of otherEventOffset — the two lists have uncorrelated lengths — an… |
| summary | boolean | – | Return condensed summaries instead of full data. Full mode renders every row and field on both output channels, so a large results set can exceed 500KB per study; summary mode typically cuts that to… |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| fetchErrors | array | – | Studies that could not be fetched. |
| results | array | – | Results per study. |
| studiesWithoutResults | array | – | NCT IDs that do not have results data. |
| truncated | boolean | – | True when a bound — a cap or an offset — trimmed a list on at least one study; absent when nothing was trimmed, matching filtersApplied one level down. Which study, which list, and where to resume is… |
No examples provided.
clinicaltrials_search_studies Clinicaltrials Search Studies ~1,816
Search for clinical trial studies from ClinicalTrials.gov. Supports full-text and field-specific queries, status/phase/geographic filters, pagination, sorting, and field selection. Returns a compact per-study index by default; pass the fields parameter to get specific leaves at full fidelity — full study records are ~70KB each.
| Name | Type | Req | Description |
|---|---|---|---|
| advancedFilter | string | – | Advanced filter using AREA[FieldName]value syntax. Examples: "AREA[StudyType]INTERVENTIONAL", "AREA[EnrollmentCount]RANGE[100, 1000]", "AREA[Phase]PHASE2 AND AREA[StudyType]INTERVENTIONAL", "(AREA[Ph… |
| conditionQuery | string | – | Condition/disease-specific search. E.g., "Type 2 Diabetes", "non-small cell lung cancer". Matches Condition, BriefTitle, OfficialTitle, ConditionMeshTerm, ConditionAncestorTerm, Keyword, and NCTId. C… |
| countTotal | boolean | – | Include total study count in response. Only computed on the first page. |
| fields | array | – | PascalCase leaf names to return; strongly recommended since full records are ~70KB. Omit for the compact index projection — an empty list is rejected, not treated as omission. Common leaves: NCTId, B… |
| geoFilter | string | – | Geographic proximity filter. Format: distance(lat,lon,radius), where radius carries a `mi` or `km` suffix — e.g. "distance(47.6062,-122.3321,50mi)" for studies within 50 miles of Seattle. The suffix… |
| includeUnknownEnrollment | boolean | – | Include studies whose EnrollmentCount is the upstream "unknown" sentinel (99999999). Excluded by default — the sentinel pollutes RANGE[N, MAX] queries and EnrollmentCount:desc sorts. Set true for dat… |
| interventionQuery | string | – | Intervention/treatment search. E.g., "pembrolizumab", "cognitive behavioral therapy". Matches InterventionName, InterventionType, ArmGroupType, InterventionOtherName, BriefTitle, OfficialTitle, ArmGr… |
| locationQuery | string | – | Location search — city, state, country, or facility name. Matches LocationCity, LocationState, LocationCountry, LocationFacility, and LocationZip; a study matches when any of its sites does. Plain wo… |
| nctIds | – | – | Filter to specific NCT IDs for batch lookups. Omit to search every study — an empty list is rejected, not treated as "no filter". Supplying this lifts the default unknown-enrollment exclusion, so an… |
| outcomeQuery | string | – | Search within outcome measure fields. Matches PrimaryOutcomeMeasure, SecondaryOutcomeMeasure, OtherOutcomeMeasure, and OutcomeMeasureTitle, plus their description counterparts PrimaryOutcomeDescripti… |
| pageSize | integer | – | Results per page, 1–200. |
| pageToken | string | – | Pagination cursor from a previous response. |
| phaseFilter | – | – | Filter by trial phase. Omit to search all phases — an empty list is rejected, not treated as "no filter". Values: EARLY_PHASE1, PHASE1, PHASE2, PHASE3, PHASE4, NA. |
| query | string | – | General free-text search across all fields. Runs the 57-field relevance search ClinicalTrials.gov publishes for this parameter — NCTId, NCTIdAlias, OrgStudyId, SecondaryId, Acronym, BriefTitle, Offic… |
| sort | string | – | Sort order. Format: FieldName:asc or FieldName:desc. E.g., "LastUpdatePostDate:desc", "EnrollmentCount:desc". Max 2 fields comma-separated. For "largest trials" queries, pair EnrollmentCount:desc wit… |
| sponsorQuery | string | – | Sponsor/collaborator name search. Matches LeadSponsorName, CollaboratorName, and OrgFullName. Plain words plus AND/OR/NOT. `[ ]` are valid only inside an AREA[FieldName]value or RANGE[min, max] expre… |
| statusFilter | – | – | Filter by study status. Omit to search all statuses — an empty list is rejected, not treated as "no filter". Values: RECRUITING, COMPLETED, ACTIVE_NOT_RECRUITING, NOT_YET_RECRUITING, ENROLLING_BY_INV… |
| titleQuery | string | – | Search within study titles and acronyms only. Matches Acronym, BriefTitle, and OfficialTitle. Plain words plus AND/OR/NOT. `[ ]` are valid only inside an AREA[FieldName]value or RANGE[min, max] expre… |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| nextPageToken | string | – | Token for the next page. Absent when this response already carries every matching study; otherwise it mirrors the upstream cursor, which ClinicalTrials.gov emits whenever a page fills to pageSize — s… |
| notice | string | – | Recovery guidance when no studies matched — echoes the constraint and suggests how to broaden, and names nctIds as part of the unmatched criteria when an ID list was supplied. Absent on pages with re… |
| pageExhausted | boolean | – | True when this call supplied a pageToken and the continuation page came back empty — the walk is finished and no further pages exist. Absent on every other response, including an empty first page, wh… |
| requestedFields | array | – | Echo of the explicit fields parameter — present only when the caller passed fields. Signals that studies carry the requested leaves at full fidelity (not the default compact index) and that the rende… |
| searchCriteria | object | – | Echo of active query/filter criteria applied to this search, including sentinelFilterActive when the default unknown-enrollment exclusion is in effect. Present on every response. |
| studies | array | – | Matching studies. By default each entry is a COMPACT index projection — nctId, briefTitle, overallStatus, phases, enrollmentCount, leadSponsor, conditions, and a bounded locations summary ({ total, n… |
| totalCount | number | – | Total matching studies (first page only when countTotal=true). |
No examples provided.
What is the io.github.cyanheads/clinicaltrialsgov-mcp-server server?
io.github.cyanheads/clinicaltrialsgov-mcp-server is listed in the public MCP registry as io.github.cyanheads/clinicaltrialsgov-mcp-server. Search ClinicalTrials.gov, find studies, retrieve results, match patients to eligible trials. This page covers its hosted endpoint (https://clinicaltrials.caseyjhand.com/mcp).
Is the io.github.cyanheads/clinicaltrialsgov-mcp-server server safe to use?
io.github.cyanheads/clinicaltrialsgov-mcp-server scores 82 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.cyanheads/clinicaltrialsgov-mcp-server server expose?
io.github.cyanheads/clinicaltrialsgov-mcp-server exposes 7 tools: clinicaltrials_search_studies, clinicaltrials_get_study_record, clinicaltrials_get_study_count, clinicaltrials_get_field_values, clinicaltrials_get_field_definitions, and 2 more. Their descriptions and schemas cost roughly 5,468 tokens of context every time the server is loaded.
Does the io.github.cyanheads/clinicaltrialsgov-mcp-server server require authentication?
No. We connected to io.github.cyanheads/clinicaltrialsgov-mcp-server without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the io.github.cyanheads/clinicaltrialsgov-mcp-server server still maintained?
io.github.cyanheads/clinicaltrialsgov-mcp-server is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.