Serveur MCP

clinicaltrialsgov

io.usefulapi/clinicaltrialsgov

Ce que fait ce MCP

Searches and retrieves ClinicalTrials.gov studies, metadata, sites, outcomes and registry statistics.

count_studies
Count matching clinical trials
Return only the total NUMBER of studies matching a query, without fetching any records. Accepts the same query terms and filters as search_studies (term, condition, intervention, title, location, sponsor, status, geoFilter, advanced). Returns { totalCount }. GET /studies with countTotal=true and pageSize=1.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'term': {'type': 'string', 'description': "General full-text 'other terms' query (maps to query.term)."}, 'title': {'type': 'string', 'description': 'Words in the study title (maps to query.titles).'}, 'status': {'type': 'array', 'items': {'enum': ['ACTIVE_NOT_RECRUITING', 'COMPLETED', 'ENROLLING_BY_INVITATION', 'NOT_YET_RECRUITING', 'RECRUITING', 'SUSPENDED', 'TERMINATED', 'WITHDRAWN', 'AVAILABLE', 'NO_LONGER_AVAILABLE', 'TEMPORARILY_NOT_AVAILABLE', 'APPROVED_FOR_MARKETING', 'WITHHELD', 'UNKNOWN'], 'type': 'string'}, 'description': 'Filter by overall recruitment status (maps to filter.overallStatus). One or more of: ACTIVE_NOT_RECRUITING, COMPLETED, ENROLLING_BY_INVITATION, NOT_YET_RECRUITING, RECRUITING, SUSPENDED, TERMINATED, WITHDRAWN, AVAILABLE, NO_LONGER_AVAILABLE, TEMPORARILY_NOT_AVAILABLE, APPROVED_FOR_MARKETING, WITHHELD, UNKNOWN.'}, 'sponsor': {'type': 'string', 'description': 'Sponsor / collaborator name (maps to query.spons).'}, 'advanced': {'type': 'string', 'description': 'Advanced Essie expression applied as an additional filter (maps to filter.advanced).'}, 'location': {'type': 'string', 'description': 'Study location text, e.g. a city/state/country (maps to query.locn).'}, 'condition': {'type': 'string', 'description': "Disease / condition to match (maps to query.cond), e.g. 'diabetes'."}, 'geoFilter': {'type': 'string', 'description': "Geo filter as a raw geo-function string (maps to filter.geo), e.g. 'distance(39.0027,-77.1,50mi)'."}, 'intervention': {'type': 'string', 'description': 'Treatment / drug / intervention to match (maps to query.intr).'}}}
get_api_version
Get the ClinicalTrials.gov API version
Return the ClinicalTrials.gov API version and the timestamp of the underlying data snapshot: { apiVersion, dataTimestamp }. GET /version.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_studies_stats
Get study size statistics
Return overall study-size statistics across the registry: { totalStudies, averageSizeBytes, percentiles, ranges, largestStudies }. Useful for understanding data volume. GET /stats/size.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_study
Get a clinical trial by NCT ID
Fetch a single ClinicalTrials.gov study by its NCT id (format NCT######## — the letters 'NCT' followed by digits, e.g. NCT00841061). Returns the full study object { protocolSection, derivedSection?, hasResults? }. Use `fields` to return only specific fields/modules. GET /studies/{nctId}.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['nctId'], 'properties': {'nctId': {'type': 'string', 'pattern': '^NCT\\d+$', 'description': "The study's NCT id, format NCT######## (e.g. NCT00841061)."}, 'fields': {'type': 'array', 'items': {'type': 'string'}, 'description': "Fields or modules to return, e.g. ['protocolSection.identificationModule','protocolSection.statusModule']. Omit for the full record."}}}
get_study_metadata
Get the study data-model (field tree)
Return the ClinicalTrials.gov study data model as a tree of module nodes (each with name/title/type/children). Use this to explore what fields/modules exist and their nesting, to build `fields` selections or `sort`/filter expressions. GET /studies/metadata.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'includeIndexedOnly': {'type': 'boolean', 'description': 'Include fields that are indexed-only (searchable but not part of the main data model).'}, 'includeHistoricOnly': {'type': 'boolean', 'description': 'Include fields that exist only in historic study versions.'}}}
list_field_values
List value statistics for study fields
Discover valid values / enums for one or more study fields. Returns per-field value statistics — for each field: its type, unique-value count and topValues [{value, studiesCount}]. Great for finding valid enum values (e.g. OverallStatus, Phase) before building a filter. GET /stats/field/values.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['fields'], 'properties': {'types': {'type': 'array', 'items': {'enum': ['ENUM', 'STRING', 'DATE', 'INTEGER', 'NUMBER', 'BOOLEAN'], 'type': 'string'}, 'description': 'Restrict to fields of these value types (ENUM, STRING, DATE, INTEGER, NUMBER, BOOLEAN).'}, 'fields': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': "Field names to get value statistics for, e.g. ['OverallStatus','Phase']."}}}
search_studies
Search clinical trials (ClinicalTrials.gov)
Search the ClinicalTrials.gov v2 study registry. Provide any combination of query terms (condition, intervention, title, location, sponsor, general term) — multiple query.* terms are ANDed together — plus optional filters (status, geo, advanced Essie expression, explicit NCT ids). Returns { totalCount?, studies: [...], nextPageToken? }. Use `fields` to trim the response to specific fields/modules, `sort` to order (e.g. '@relevance', 'LastUpdatePostDate:desc', 'EnrollmentCount:desc'), and pageSize/pageToken to page. GET /studies.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ids': {'type': 'array', 'items': {'type': 'string'}, 'description': "Restrict to these NCT ids (maps to filter.ids), e.g. ['NCT00841061']."}, 'sort': {'type': 'string', 'description': "Sort order, e.g. '@relevance', 'LastUpdatePostDate:desc', 'EnrollmentCount:desc', 'StudyFirstPostDate:desc'."}, 'term': {'type': 'string', 'description': "General full-text 'other terms' query (maps to query.term)."}, 'title': {'type': 'string', 'description': 'Words in the study title (maps to query.titles).'}, 'fields': {'type': 'array', 'items': {'type': 'string'}, 'description': "Fields or modules to return, e.g. ['NCTId','BriefTitle','OverallStatus'] or ['protocolSection.identificationModule']. Omit to return full study records."}, 'status': {'type': 'array', 'items': {'enum': ['ACTIVE_NOT_RECRUITING', 'COMPLETED', 'ENROLLING_BY_INVITATION', 'NOT_YET_RECRUITING', 'RECRUITING', 'SUSPENDED', 'TERMINATED', 'WITHDRAWN', 'AVAILABLE', 'NO_LONGER_AVAILABLE', 'TEMPORARILY_NOT_AVAILABLE', 'APPROVED_FOR_MARKETING', 'WITHHELD', 'UNKNOWN'], 'type': 'string'}, 'description': 'Filter by overall recruitment status (maps to filter.overallStatus). One or more of: ACTIVE_NOT_RECRUITING, COMPLETED, ENROLLING_BY_INVITATION, NOT_YET_RECRUITING, RECRUITING, SUSPENDED, TERMINATED, WITHDRAWN, AVAILABLE, NO_LONGER_AVAILABLE, TEMPORARILY_NOT_AVAILABLE, APPROVED_FOR_MARKETING, WITHHELD, UNKNOWN.'}, 'sponsor': {'type': 'string', 'description': 'Sponsor / collaborator name (maps to query.spons).'}, 'advanced': {'type': 'string', 'description': 'Advanced Essie expression applied as an additional filter (maps to filter.advanced).'}, 'location': {'type': 'string', 'description': 'Study location text, e.g. a city/state/country (maps to query.locn).'}, 'pageSize': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Number of studies per page (1–1000; API default 10).'}, 'condition': {'type': 'string', 'description': "Disease / condition to match (maps to query.cond), e.g. 'diabetes'."}, 'geoFilter': {'type': 'string', 'description': "Geo filter as a raw geo-function string (maps to filter.geo), e.g. 'distance(39.0027,-77.1,50mi)'."}, 'pageToken': {'type': 'string', 'description': "Opaque token from a previous response's nextPageToken, to fetch the next page."}, 'countTotal': {'type': 'boolean', 'description': 'Include the total number of matching studies (totalCount) on the first page.'}, 'intervention': {'type': 'string', 'description': 'Treatment / drug / intervention to match (maps to query.intr).'}}}
Modifié
get_api_version
2 October 2026 02:40
Modifié
get_studies_stats
2 October 2026 02:40
Modifié
get_study_metadata
2 October 2026 02:40
Modifié
list_field_values
2 October 2026 02:40
Modifié
count_studies
2 October 2026 02:40
Modifié
get_study
2 October 2026 02:40
Modifié
search_studies
2 October 2026 02:40
Ajouté
get_api_version
30 September 2026 02:40
Ajouté
get_studies_stats
30 September 2026 02:40
Ajouté
get_study_metadata
30 September 2026 02:40
Ajouté
list_field_values
30 September 2026 02:40
Ajouté
count_studies
30 September 2026 02:40
Ajouté
get_study
30 September 2026 02:40
Ajouté
search_studies
30 September 2026 02:40