Science
Data source: ClinicalTrials.gov
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/clinicaltrials/
claude_desktop_config.json
{
"mcpServers": {
"gnist-clinicaltrials": {
"url": "https://context.gnist.ai/mcp/clinicaltrials/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/clinicaltrials/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_trial", "arguments": {"nct_id": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/clinicaltrials/
5 endpoints available:
GET /rest/clinicaltrials/search_trialsGET /rest/clinicaltrials/get_trialGET /rest/clinicaltrials/get_trials_by_conditionGET /rest/clinicaltrials/get_trials_by_sponsorGET /rest/clinicaltrials/report_feedback
Shell
curl "https://context.gnist.ai/rest/clinicaltrials/get_trial?nct_id=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/clinicaltrials/get_trial",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"nct_id": "example"
},
)
print(resp.json())
Command Line
Command
gc clinicaltrials
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
search_trialsSearch ClinicalTrials.gov for clinical trials with flexible filters.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | any | optional | General search term (searches all fields). Examples: "aspirin heart", "mRNA vaccine", "CRISPR gene therapy". |
condition | any | optional | Filter by condition or disease. Examples: "diabetes", "breast cancer", "Alzheimer's disease", "COVID-19". |
intervention | any | optional | Filter by intervention/treatment. Examples: "pembrolizumab", "cognitive behavioral therapy", "radiation". |
status | any | optional | Filter by trial status. One of: RECRUITING, NOT_YET_RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED, ENROLLING_BY_INVITATION, UNKNOWN. |
phase | any | optional | Filter by trial phase. One of: EARLY_PHASE1, PHASE1, PHASE2, PHASE3, PHASE4, NA. |
sponsor | any | optional | Filter by sponsor organization. Examples: "Pfizer", "NIH", "Mayo Clinic". |
max_results | integer | optional | Number of results to return (1-50, default 10). (default: 10) |
get_trialGet detailed information about a specific clinical trial by NCT ID.
| Parameter | Type | Required | Description |
|---|---|---|---|
nct_id | string | required | ClinicalTrials.gov NCT identifier (e.g., "NCT03367897", "NCT04368728"). Found in search_trials results or on clinicaltrials.gov. |
get_trials_by_conditionFind clinical trials studying a specific condition or disease.
| Parameter | Type | Required | Description |
|---|---|---|---|
condition | string | required | The condition or disease to search for. Examples: "lung cancer", "type 2 diabetes", "major depressive disorder", "rheumatoid arthritis". |
status | any | optional | Optional status filter. One of: RECRUITING, NOT_YET_RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED, ENROLLING_BY_INVITATION, UNKNOWN. |
max_results | integer | optional | Number of results to return (1-50, default 10). (default: 10) |
get_trials_by_sponsorFind clinical trials run by a specific sponsor organization.
| Parameter | Type | Required | Description |
|---|---|---|---|
sponsor | string | required | Sponsor organization name. Examples: "Pfizer", "Novartis", "National Cancer Institute", "Mayo Clinic", "Roche". |
status | any | optional | Optional status filter. One of: RECRUITING, NOT_YET_RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED, ENROLLING_BY_INVITATION, UNKNOWN. |
max_results | integer | optional | Number of results to return (1-50, default 10). (default: 10) |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |