Clinical Trials Database
google-deepmind/science-skills
Query ClinicalTrials.gov via APIv2. An agent skill from google-deepmind/science-skills.
Clinical trial registry database search API. An agent skill from wentorai/research-plugins.
Install Clinicaltrials API
$ npx skills add wentorai/research-plugins --skill clinicaltrials-api -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install wentorai/research-plugins clinicaltrials-api --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/domains/biomedical/clinicaltrials-api .claude/skills/clinicaltrials-api && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "clinicaltrials-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/biomedical/clinicaltrials-api into .claude/skills/clinicaltrials-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clinicaltrials-api", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/wentorai/research-plugins/tree/main/skills/domains/biomedical/clinicaltrials-apiType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add wentorai/research-plugins --skill clinicaltrials-api -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install wentorai/research-plugins clinicaltrials-api --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/domains/biomedical/clinicaltrials-api .agents/skills/clinicaltrials-api && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "clinicaltrials-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/biomedical/clinicaltrials-api into .agents/skills/clinicaltrials-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clinicaltrials-api", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add wentorai/research-plugins --skill clinicaltrials-api -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install wentorai/research-plugins clinicaltrials-api --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/domains/biomedical/clinicaltrials-api .cursor/skills/clinicaltrials-api && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "clinicaltrials-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/biomedical/clinicaltrials-api into .cursor/skills/clinicaltrials-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clinicaltrials-api", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/wentorai/research-plugins.git --path skills/domains/biomedical/clinicaltrials-api--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add wentorai/research-plugins --skill clinicaltrials-api -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install wentorai/research-plugins clinicaltrials-api --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/domains/biomedical/clinicaltrials-api .gemini/skills/clinicaltrials-api && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "clinicaltrials-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/biomedical/clinicaltrials-api into .gemini/skills/clinicaltrials-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clinicaltrials-api", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install wentorai/research-plugins clinicaltrials-apiInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add wentorai/research-plugins --skill clinicaltrials-api -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/domains/biomedical/clinicaltrials-api .github/skills/clinicaltrials-api && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "clinicaltrials-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/biomedical/clinicaltrials-api into .github/skills/clinicaltrials-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clinicaltrials-api", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add wentorai/research-plugins --skill clinicaltrials-api -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install wentorai/research-plugins clinicaltrials-api --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/domains/biomedical/clinicaltrials-api .opencode/skills/clinicaltrials-api && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "clinicaltrials-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/biomedical/clinicaltrials-api into .opencode/skills/clinicaltrials-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clinicaltrials-api", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
clinicaltrials-api- GitHub stars
- 298
- Used in
- 1 other repo
- Token cost
- ~2.1k tokens
- SKILL.md length
- 569 words
- Files
- 1
- Skills in repo
- 405
- Repo updated
- First seen
- Licence
- MIT
At a glance
Clinical trial registry database search API. An agent skill from wentorai/research-plugins.
- Tasks that involve Clinical and healthcare research
- SKILL.md covers Overview, Authentication, Core Endpoints and Rate Limits, plus 2 more sections
- Calls curl; reaches clinicaltrials.gov
What it does
Clinicaltrials API is an agent skill from wentorai/research-plugins. Clinical trial registry database search API
Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Research & Science, covering Clinical and healthcare research. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.
When your agent uses it
- Tasks that involve Clinical and healthcare research
Example prompts
- “/clinicaltrials-api”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit bf44b3c. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
clinicaltrials.gov
Also links to:
aact.ctti-clinicaltrials.orgtrialsearch.who.intncbi.nlm.nih.gov
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Clinicaltrials API loads about 2.1k tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 569 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 569 words, ~2,064 tokens.
Download SKILL.mdSave it as
.claude/skills/clinicaltrials-api/SKILL.md (or your agent's skills folder).- name
- clinicaltrials-api
- description
- Clinical trial registry database search API
ClinicalTrials API Guide
Overview
ClinicalTrials.gov is a registry and results database of publicly and privately supported clinical studies conducted around the world, maintained by the U.S. National Library of Medicine (NLM) at the National Institutes of Health (NIH). It contains registration records for over 500,000 clinical trials from more than 220 countries, making it the largest and most comprehensive clinical trial registry in the world.
The ClinicalTrials.gov API provides programmatic access to this vast repository of clinical trial data. Researchers can search for trials by condition, intervention, sponsor, location, phase, status, and many other criteria. The API returns detailed structured data including study design, eligibility criteria, outcome measures, enrollment information, study contacts, and results when available.
Clinical researchers, pharmaceutical companies, systematic reviewers, epidemiologists, public health officials, patient advocacy groups, and health policy analysts use the ClinicalTrials.gov API to monitor the clinical trial landscape, identify recruiting studies, conduct meta-analyses, analyze research trends, and ensure comprehensive evidence coverage in systematic reviews. The database is a critical resource for evidence-based medicine and regulatory compliance.
Authentication
No authentication required. The ClinicalTrials.gov API is freely accessible without any API key, token, or registration. All endpoints are publicly available. Users are expected to comply with the NCBI usage policies and make requests at a reasonable rate.
Core Endpoints
query/full_studies: Search Clinical Trials
Search the ClinicalTrials.gov database and retrieve full study records with comprehensive metadata about trial design, eligibility, interventions, and outcomes.
- URL:
GET https://clinicaltrials.gov/api/v2/studies - Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| query.term | string | No | Free-text search query across all fields |
| query.cond | string | No | Condition or disease filter |
| query.intr | string | No | Intervention or treatment filter |
| query.spons | string | No | Sponsor or collaborator filter |
| filter.overallStatus | string | No | Status filter: RECRUITING, COMPLETED, ACTIVE_NOT_RECRUITING |
| filter.phase | string | No | Phase filter: PHASE1, PHASE2, PHASE3, PHASE4 |
| filter.geo | string | No | Geographic filter (distance:lat,lng) |
| sort | string | No | Sort field and direction |
| pageSize | int | No | Results per page (default 10, max 1000) |
| pageToken | string | No | Token for next page of results |
| format | string | No | Response format: json (default) or csv |
- Example:
# Search for recruiting cancer immunotherapy trials
curl "https://clinicaltrials.gov/api/v2/studies?query.cond=cancer&query.intr=immunotherapy&filter.overallStatus=RECRUITING&pageSize=5"
# Search by sponsor
curl "https://clinicaltrials.gov/api/v2/studies?query.spons=NIH&filter.phase=PHASE3&pageSize=10"- Response: Returns
totalCount,nextPageToken, andstudiesarray. Each study containsprotocolSectionwithidentificationModule(NCT ID, title, organization),statusModule(overall status, start/completion dates),descriptionModule(brief summary, detailed description),conditionsModule(conditions and keywords),designModule(study type, phases, allocation, intervention model),armsInterventionsModule,eligibilityModule(criteria, gender, age range),contactsLocationsModule, andoutcomesModule.
Show full SKILL.md (190 more words)Show less
Single Study Retrieval
Retrieve a specific clinical trial by its NCT identifier.
- URL:
GET https://clinicaltrials.gov/api/v2/studies/{nctId} - Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| nctId | string | Yes | NCT identifier (e.g., NCT04280705) |
- Example:
curl "https://clinicaltrials.gov/api/v2/studies/NCT04280705"- Response: Returns the complete study record with all protocol sections, including detailed eligibility criteria, primary and secondary outcome measures, study arms and interventions, sponsor information, and references.
Rate Limits
No formal rate limits are documented for the ClinicalTrials.gov API. However, the service follows NCBI usage guidelines which recommend no more than 3 requests per second without an API key, and up to 10 requests per second with an NCBI API key. For bulk data access, ClinicalTrials.gov provides downloadable data files at https://clinicaltrials.gov/AllPublicXML.zip and via the AACT (Aggregate Analysis of ClinicalTrials.gov) database at https://aact.ctti-clinicaltrials.org/.
Common Patterns
Monitor Recruiting Trials for a Condition
Track actively recruiting trials for a specific disease or condition:
import requests
params = {
"query.cond": "Alzheimer's Disease",
"filter.overallStatus": "RECRUITING",
"filter.phase": "PHASE3",
"pageSize": 20
}
resp = requests.get("https://clinicaltrials.gov/api/v2/studies", params=params)
data = resp.json()
print(f"Found {data['totalCount']} recruiting Phase 3 Alzheimer's trials\n")
for study in data["studies"]:
proto = study["protocolSection"]
ident = proto["identificationModule"]
status = proto["statusModule"]
print(f"{ident['nctId']}: {ident['briefTitle']}")
print(f" Status: {status['overallStatus']}")
print(f" Start: {status.get('startDateStruct', {}).get('date', 'N/A')}")
print()Systematic Review: Comprehensive Trial Search
Perform a comprehensive search for systematic review inclusion screening:
import requests
all_studies = []
page_token = None
while True:
params = {
"query.cond": "type 2 diabetes",
"query.intr": "metformin",
"filter.overallStatus": "COMPLETED",
"pageSize": 100
}
if page_token:
params["pageToken"] = page_token
resp = requests.get("https://clinicaltrials.gov/api/v2/studies", params=params)
data = resp.json()
all_studies.extend(data["studies"])
page_token = data.get("nextPageToken")
if not page_token:
break
print(f"Total completed metformin trials for T2D: {len(all_studies)}")Analyze Trial Characteristics
Extract and analyze study design features for research landscape mapping:
import requests
from collections import Counter
params = {
"query.cond": "COVID-19",
"filter.phase": "PHASE3",
"pageSize": 100
}
resp = requests.get("https://clinicaltrials.gov/api/v2/studies", params=params)
data = resp.json()
sponsors = Counter()
for study in data["studies"]:
org = study["protocolSection"]["identificationModule"].get("organization", {})
sponsors[org.get("fullName", "Unknown")] += 1
print("Top sponsors of Phase 3 COVID-19 trials:")
for sponsor, count in sponsors.most_common(10):
print(f" {sponsor}: {count} trials")References
- Official API documentation: https://clinicaltrials.gov/data-api/api
- ClinicalTrials.gov homepage: https://clinicaltrials.gov/
- AACT database for bulk analysis: https://aact.ctti-clinicaltrials.org/
- WHO ICTRP (international registry portal): https://trialsearch.who.int/
- NCBI usage policies: https://www.ncbi.nlm.nih.gov/home/about/policies/
© wentorai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/domains/biomedical/clinicaltrials-api of wentorai/research-plugins.
Open the folder on GitHubat commit bf44b3c
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Clinicaltrials API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Clinicaltrials API this skillwentorai/research-plugins | 298 | 1 repos | ~2.1k | Automated safety check: Pass | MIT | |
| Clinical Trials Databasegoogle-deepmind/science-skills | 3.2k | 2 repos | ~3.2k | Automated safety check: Pass | Apache-2.0 | |
| CHARLS Paper Reproduction Guidexjtulyc/MedgeClaw | 617 | 1 repos | ~1.8k | Automated safety check: Pass | None | |
| Biomedical Analysis Dispatchxjtulyc/MedgeClaw | 617 | 1 repos | ~2k | Automated safety check: Pass | None | |
| Research Paperluwill/research-skills | 860 | — | ~1.9k | Automated safety check: Pass | None | |
| Research Proposalluwill/research-skills | 860 | — | ~4.5k | Automated safety check: Notes | None |
Similar skills
CHARLS Paper Reproduction Guide
xjtulyc/MedgeClaw
Guides an agent through reproducing papers built on the CHARLS health and retirement survey, from variable mapping to cognition, depression and isolation scores.
Biomedical Analysis Dispatch
xjtulyc/MedgeClaw
Routes bioinformatics, drug discovery, clinical and multi-omics tasks from a chat interface to Claude Code sessions running K-Dense scientific skills, with a live dashboard per task.
Research Paper
luwill/research-skills
A skill your agent uses when the user asks to write or draft an ORIGINAL RESEARCH ARTICLE — IMRaD paper, conference paper, short/workshop paper, 研究论文/期刊论文/会议论文 — reporting their own completed…
Research Proposal
luwill/research-skills
A skill your agent uses when the user asks to write or draft a PhD / doctoral research proposal, research plan, 研究计划书, or 开题报告 — a forward-looking plan of background, gap, research questions…
Medical Imaging Review
LeonChaoX/qinyan-academic-skills
Write comprehensive literature reviews for medical imaging AI research.
More from wentorai/research-plugins
All 405 skills in this repoAbstract Writing Guide
wentorai/research-plugins
Craft structured research abstracts that maximize clarity and journal acceptance
Academic Citation Manager
wentorai/research-plugins
Manage academic citations across BibTeX, APA, MLA, and Chicago formats
Academic Paper Summarizer
wentorai/research-plugins
Summarize academic papers with structured extraction of key elements
Academic Study Methods
wentorai/research-plugins
Evidence-based study techniques for academic learning and retention
Academic Tone Guide
wentorai/research-plugins
Adjust writing tone and register for academic audiences and venues
Academic Translation Guide
wentorai/research-plugins
Academic translation, post-editing, and Chinglish correction guide
Related
Categories
Questions about Clinicaltrials API
What does Clinicaltrials API do?
Clinical trial registry database search API. An agent skill from wentorai/research-plugins. Clinicaltrials API is an agent skill from wentorai/research-plugins.
When should I use Clinicaltrials API?
Clinicaltrials API fits situations like: tasks that involve Clinical and healthcare research.
How do I install Clinicaltrials API in Claude Code?
Run `npx skills add wentorai/research-plugins --skill clinicaltrials-api -a claude-code`. Or copy the skill folder (skills/domains/biomedical/clinicaltrials-api in wentorai/research-plugins) into .claude/skills/clinicaltrials-api in your project. Claude Code loads it when a task matches its description.
How do I install Clinicaltrials API in Codex?
Run `npx skills add wentorai/research-plugins --skill clinicaltrials-api -a codex`. Or copy the skill folder (skills/domains/biomedical/clinicaltrials-api in wentorai/research-plugins) into .agents/skills/clinicaltrials-api in your project. Codex loads it when a task matches its description.
Can I use Clinicaltrials API in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wentorai/research-plugins --skill clinicaltrials-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clinicaltrials-api, .gemini/skills/clinicaltrials-api, .github/skills/clinicaltrials-api and .opencode/skills/clinicaltrials-api in your project.
What does Clinicaltrials API need to run?
Going by SKILL.md and its folder, Clinicaltrials API needs the command-line tools its instructions call (curl). Our summary lists: Python 3.
Does Clinicaltrials API access the network?
SKILL.md names 4 domains. In commands or code: clinicaltrials.gov; the agent is likely to contact it when it follows the instructions. As links in the text: aact.ctti-clinicaltrials.org, trialsearch.who.int and ncbi.nlm.nih.gov. This is read from the text; nothing was executed.
Is Clinicaltrials API safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Clinicaltrials API use?
Clinicaltrials API is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Clinicaltrials API use?
About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Clinicaltrials API?
Skills that share tags, products or a category with Clinicaltrials API: Clinical Trials Database (google-deepmind/science-skills, 3.2k stars), CHARLS Paper Reproduction Guide (xjtulyc/MedgeClaw, 617 stars), Biomedical Analysis Dispatch (xjtulyc/MedgeClaw, 617 stars) and Research Paper (luwill/research-skills, 860 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Clinicaltrials API?
wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.
Source: wentorai/research-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.