{"openapi":"3.0.3","info":{"title":"Gnist Context — ClinicalTrials.gov","description":"Search clinical trial registrations — study details, conditions, interventions, and status.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/clinicaltrials/`\n- **Toolkit page:** `/toolkits/clinicaltrials`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/clinicaltrials/search_trials":{"post":{"tags":["Science"],"summary":"search_trials","description":"Search ClinicalTrials.gov for clinical trials with flexible filters.\n\nCovers 500K+ registered clinical trials worldwide. Returns trial summaries\nincluding NCT ID, title, status, phase, conditions, interventions, and sponsor.\n\nArgs:\n    query: General search term (searches all fields). Examples: \"aspirin heart\",\n        \"mRNA vaccine\", \"CRISPR gene therapy\".\n    condition: Filter by condition or disease. Examples: \"diabetes\",\n        \"breast cancer\", \"Alzheimer's disease\", \"COVID-19\".\n    intervention: Filter by intervention/treatment. Examples: \"pembrolizumab\",\n        \"cognitive behavioral therapy\", \"radiation\".\n    status: Filter by trial status. One of: RECRUITING, NOT_YET_RECRUITING,\n        ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED,\n        ENROLLING_BY_INVITATION, UNKNOWN.\n    phase: Filter by trial phase. One of: EARLY_PHASE1, PHASE1, PHASE2,\n        PHASE3, PHASE4, NA.\n    sponsor: Filter by sponsor organization. Examples: \"Pfizer\", \"NIH\",\n        \"Mayo Clinic\".\n    max_results: Number of results to return (1-50, default 10).\n\nReturns:\n    List of trial summaries with nct_id, brief_title, overall_status, phase,\n    conditions, interventions, sponsor, start_date, enrollment.","operationId":"clinicaltrials_search_trials","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"General search term (searches all fields). Examples: \"aspirin heart\", \"mRNA vaccine\", \"CRISPR gene therapy\"."},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by condition or disease. Examples: \"diabetes\", \"breast cancer\", \"Alzheimer's disease\", \"COVID-19\"."},"intervention":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by intervention/treatment. Examples: \"pembrolizumab\", \"cognitive behavioral therapy\", \"radiation\"."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by trial status. One of: RECRUITING, NOT_YET_RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED, ENROLLING_BY_INVITATION, UNKNOWN."},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by trial phase. One of: EARLY_PHASE1, PHASE1, PHASE2, PHASE3, PHASE4, NA."},"sponsor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by sponsor organization. Examples: \"Pfizer\", \"NIH\", \"Mayo Clinic\"."},"max_results":{"default":10,"description":"Number of results to return (1-50, default 10).","type":"integer"}},"type":"object"}}}}}},"/rest/clinicaltrials/get_trial":{"post":{"tags":["Science"],"summary":"get_trial","description":"Get detailed information about a specific clinical trial by NCT ID.\n\nReturns comprehensive trial details including title, summary, status, phase,\nconditions, interventions, sponsor, eligibility criteria, outcomes, and locations.\n\nArgs:\n    nct_id: ClinicalTrials.gov NCT identifier (e.g., \"NCT03367897\", \"NCT04368728\").\n        Found in search_trials results or on clinicaltrials.gov.\n\nReturns:\n    Full trial record with nct_id, brief_title, official_title, brief_summary,\n    overall_status, phase, study_type, conditions, interventions (name/type/description),\n    sponsor, collaborators, start_date, completion_date, enrollment,\n    eligibility_criteria, primary_outcomes, locations.","operationId":"clinicaltrials_get_trial","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"nct_id":{"description":"ClinicalTrials.gov NCT identifier (e.g., \"NCT03367897\", \"NCT04368728\"). Found in search_trials results or on clinicaltrials.gov.","type":"string"}},"required":["nct_id"],"type":"object"}}}}}},"/rest/clinicaltrials/get_trials_by_condition":{"post":{"tags":["Science"],"summary":"get_trials_by_condition","description":"Find clinical trials studying a specific condition or disease.\n\nShortcut for search_trials with condition filter pre-set. Useful for\nquickly finding all trials for a disease.\n\nArgs:\n    condition: The condition or disease to search for. Examples: \"lung cancer\",\n        \"type 2 diabetes\", \"major depressive disorder\", \"rheumatoid arthritis\".\n    status: Optional status filter. One of: RECRUITING, NOT_YET_RECRUITING,\n        ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED,\n        ENROLLING_BY_INVITATION, UNKNOWN.\n    max_results: Number of results to return (1-50, default 10).\n\nReturns:\n    List of trial summaries matching the condition.","operationId":"clinicaltrials_get_trials_by_condition","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"condition":{"description":"The condition or disease to search for. Examples: \"lung cancer\", \"type 2 diabetes\", \"major depressive disorder\", \"rheumatoid arthritis\".","type":"string"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional status filter. One of: RECRUITING, NOT_YET_RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED, ENROLLING_BY_INVITATION, UNKNOWN."},"max_results":{"default":10,"description":"Number of results to return (1-50, default 10).","type":"integer"}},"required":["condition"],"type":"object"}}}}}},"/rest/clinicaltrials/get_trials_by_sponsor":{"post":{"tags":["Science"],"summary":"get_trials_by_sponsor","description":"Find clinical trials run by a specific sponsor organization.\n\nUseful for investigating a company's drug pipeline or an institution's\nresearch portfolio.\n\nArgs:\n    sponsor: Sponsor organization name. Examples: \"Pfizer\", \"Novartis\",\n        \"National Cancer Institute\", \"Mayo Clinic\", \"Roche\".\n    status: Optional status filter. One of: RECRUITING, NOT_YET_RECRUITING,\n        ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED,\n        ENROLLING_BY_INVITATION, UNKNOWN.\n    max_results: Number of results to return (1-50, default 10).\n\nReturns:\n    List of trial summaries from the specified sponsor.","operationId":"clinicaltrials_get_trials_by_sponsor","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"sponsor":{"description":"Sponsor organization name. Examples: \"Pfizer\", \"Novartis\", \"National Cancer Institute\", \"Mayo Clinic\", \"Roche\".","type":"string"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional status filter. One of: RECRUITING, NOT_YET_RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED, ENROLLING_BY_INVITATION, UNKNOWN."},"max_results":{"default":10,"description":"Number of results to return (1-50, default 10).","type":"integer"}},"required":["sponsor"],"type":"object"}}}}}},"/rest/clinicaltrials/report_feedback":{"post":{"tags":["Science"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"clinicaltrials_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Science","description":"Data sources: Science"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}