Title100/100
Search Clinical Trials
The title clearly communicates the tool’s action and subject. Keep it concise.
Description85/100
Search ClinicalTrials.gov database for clinical trials. This is the PRIMARY tool for finding trials. WHEN TO USE: - Finding trials for a disease/condition (e.g., 'What trials exist for lung cancer?') - Finding trials testing a specific drug/treatment (e.g., 'Find pembrolizumab trials') - Finding trials in a geographic area (e.g., 'Clinical trials in Boston') - General trial discovery and research questions USE DIFFERENT TOOLS FOR: - Detailed info on a specific trial by NCT ID -> use get_trial_details - All trials by a specific company -> use search_by_sponsor (or search_trials with sponsor=...) - Analyzing endpoints/outcomes -> use analyze_endpoints - Patient eligibility matching -> use search_by_eligibility QUERY SYNTAX (for condition, intervention, sponsor, location): - Boolean: 'cancer AND immunotherapy', 'aspirin OR ibuprofen', 'tumor NOT benign' - Exact phrase: '"breast cancer"' (with quotes) - Grouping: '(lung OR breast) AND cancer' - Synonyms are automatically included (e.g., 'heart attack' finds 'myocardial infarction') BEST PRACTICES: - Start with condition parameter for disease-focused searches - Add status=['RECRUITING'] to find active trials patients can join - Use phase filter for specific development stages (PHASE1, PHASE2, PHASE3, PHASE4) - Set count_total=true to know total matches (useful for: 'How many trials exist for X?') - Use page_size=50-100 for broader overviews, page_size=10 for quick lookups
The description explains the capability, when to use it, and what to expect.
Inputs84/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
condition
Disease or condition to search. This is the most common search parameter. Examples: 'diabetes', 'lung cancer', 'Alzheimer', 'COVID-19'. Supports Boolean operators: 'diabetes AND neuropathy', 'cancer NOT skin'. Use quotes for exact phrases: '"type 2 diabetes"'. Medical synonyms are automatically included in search.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
intervention
Drug, treatment, or intervention name. Examples: 'pembrolizumab', 'metformin', 'CAR-T therapy', 'radiation'. Use OR for alternatives: 'aspirin OR ibuprofen OR naproxen'. Brand and generic names both work.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
location
Geographic location for trial sites. Can be city, state, country, or region. Examples: 'Boston', 'California', 'United States', 'Germany', 'Europe'. Useful for finding trials patients can physically access.
Clear enough to supply this argument.
sponsor
Organization sponsoring or funding the trial. Examples: 'Pfizer', 'NIH', 'Novartis', 'Mayo Clinic'. For comprehensive sponsor analysis, use search_by_sponsor tool instead.
Clear enough to supply this argument.
advanced_query
Advanced query using Essie expression syntax. Only use when basic parameters are insufficient. Syntax: AREA[FieldName]value or AREA[FieldName]RANGE[min,max]. Examples: - Date filter: 'AREA[StartDate]RANGE[2023-01-01,MAX]' (trials started after Jan 2023) - Enrollment: 'AREA[EnrollmentCount]RANGE[100,MAX]' (100+ participants) - List size: 'AREA[Phase:size]2' (trials with exactly 2 phases) - Geo proximity: Use filter.geo parameter instead for distance-based searches
Clear enough to supply this argument.
status
Filter by recruitment status. Common values: - RECRUITING: Actively enrolling patients (use this to find trials patients can join) - COMPLETED: Trial finished (use for historical research) - ACTIVE_NOT_RECRUITING: Ongoing but not enrolling - NOT_YET_RECRUITING: Approved but not started - TERMINATED/WITHDRAWN: Stopped early Can select multiple: ['RECRUITING', 'NOT_YET_RECRUITING']
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
phase
Filter by trial phase. Values: - EARLY_PHASE1: Initial safety testing - PHASE1: Safety and dosage testing in small groups - PHASE2: Efficacy and side effects testing - PHASE3: Large-scale efficacy confirmation - PHASE4: Post-market surveillance - NA: Not applicable (observational studies) Can select multiple: ['PHASE2', 'PHASE3']
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
study_type
Type of clinical study: - INTERVENTIONAL: Tests a treatment/intervention (most common for drug trials) - OBSERVATIONAL: Observes outcomes without intervention - EXPANDED_ACCESS: Provides experimental treatment outside trials
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_size
Number of results per page. Default 10. Use 50-100 for comprehensive searches, 5-10 for quick lookups.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page_token
Token from previous response's next_page_token to get next page. Do not set for first request.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
count_total
Set to true to get total count of matching trials. Useful for questions like 'How many trials exist for X?'. Slightly slower.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search Clinical Trials",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Output schema86/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"required": [
"count",
"items"
],
"properties": {
"count": {
"type": "integer",
"description": "Number of trials returned in this response"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"default": null,
"description": "Study phases. Values: EARLY_PHASE1, PHASE1, PHASE2, PHASE3, PHASE4, NA. A trial can span multiple phases (e.g., ['PHASE1', 'PHASE2'])"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Official title of the study - full scientific title as registered"
},
"nct_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "NCT identifier - unique ClinicalTrials.gov ID (e.g., 'NCT04567890')"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Overall recruitment status. Values: NOT_YET_RECRUITING, RECRUITING, ENROLLING_BY_INVITATION, ACTIVE_NOT_RECRUITING, COMPLETED, SUSPENDED, TERMINATED, WITHDRAWN"
},
"sponsor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Lead sponsor organization name (e.g., 'Pfizer', 'National Cancer Institute')"
},
"conditions": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"default": null,
"description": "Medical conditions or diseases being studied (e.g., ['Type 2 Diabetes', 'Obesity'])"
},
"enrollment": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Target number of participants to enroll in the study"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Study start date in YYYY-MM-DD format or 'Month YYYY' format"
},
"study_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Type of study. Values: INTERVENTIONAL (tests treatments), OBSERVATIONAL (observes outcomes without intervention), EXPANDED_ACCESS (provides access outside trials)"
},
"interventions": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"default": null,
"description": "Interventions or treatments being tested (e.g., ['Drug: Metformin', 'Procedure: Bariatric Surgery'])"
},
"locations_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total number of study sites/facilities where the trial is conducted"
},
"primary_completion_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Expected date when primary outcome measures will be collected for all participants"
}
},
"description": "Compact trial summary for search results."
},
"description": "List of trial summaries"
},
"total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total number of matching trials (only if count_total=true)"
},
"next_page_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Token to retrieve the next page of results"
}
},
"description": "Response from trial search operations."
}