search_clinical_trials
Find clinical trials by condition, intervention, location, or NCT ID to access study protocols, interventions, and outcomes data from ClinicalTrials.gov.
Instructions
Search clinical trials using ClinicalTrials.gov API v2. Returns study information including protocols, interventions, and outcomes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| condition | No | Medical condition or disease. Example: 'lung cancer', 'diabetes' | |
| intervention | No | Drug or intervention name. Example: 'Vemurafenib', 'chemotherapy' | |
| outcome | No | Outcome measure. Example: 'overall survival', 'adverse events' | |
| sponsor | No | Study sponsor. Example: 'National Cancer Institute' | |
| status | No | Study status. Example: 'RECRUITING', 'COMPLETED' | |
| location | No | Study location. Example: 'New York', 'United States' | |
| nct_id | No | Specific NCT ID. Example: 'NCT04267848' | |
| pageSize | No | Maximum number of records to return (1-1000) | |
| countTotal | No | Whether to count total number of studies |
Implementation Reference
- src/index.ts:411-427 (handler)The handler function that executes the search clinical trials logic by making an API request.
private async searchClinicalTrials(params: ClinicalTrialSearchParams) { const data = await this.makeRequest(params); return { content: [ { type: "text", text: JSON.stringify({ totalCount: data.totalCount, nextPageToken: data.nextPageToken, studies_count: data.studies?.length || 0, studies: data.studies || [] }, null, 2) } ] }; } - src/index.ts:104-125 (registration)The tool registration block containing the definition and schema for search_clinical_trials.
name: "search_clinical_trials", description: "Search clinical trials using ClinicalTrials.gov API v2. Returns study information including protocols, interventions, and outcomes.", inputSchema: { type: "object", properties: { condition: { type: "string", description: "Medical condition or disease. Example: 'lung cancer', 'diabetes'" }, intervention: { type: "string", description: "Drug or intervention name. Example: 'Vemurafenib', 'chemotherapy'" }, outcome: { type: "string", description: "Outcome measure. Example: 'overall survival', 'adverse events'" }, sponsor: { type: "string", description: "Study sponsor. Example: 'National Cancer Institute'" }, status: {