clinicaltrials-mcp
Conversational access to 400,000+ clinical trials. Python MCP server for ClinicalTrials.gov
Install / Use
claude mcp add agents100x -- npx -y github:agents100x/clinicaltrials-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of clinicaltrials-mcp
clinicaltrials-mcp scores 74/100 on our quality scale, 844th of 947 AI & Machine Learning skills we index.
Its MCP Server is 9.4 KB long, well organised into 19 sections with 12 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 7 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-09-23 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 81/100, with 3 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
clinicaltrials-mcp compared with similar skills
All 4 of these similar skills score higher than clinicaltrials-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| clinicaltrials-mcp (this skill)by agents100x | 74 | 3 | 7mo ago | MCP Server |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
Frequently asked questions
- How do I install clinicaltrials-mcp?
- Run
claude mcp add agents100x -- npx -y github:agents100x/clinicaltrials-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does clinicaltrials-mcp work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is clinicaltrials-mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 81/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is clinicaltrials-mcp still maintained?
- The repository was last updated about 7 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubclinicaltrials-mcp
Conversational access to 400,000+ clinical trials — for pharma analysts, CRO teams, and health-tech builders.
A Python MCP server that connects Cursor, Claude Desktop, and any MCP-compatible client directly to ClinicalTrials.gov. Ask questions in plain English. Get clean, structured answers in seconds — no API keys, no setup, no parsing raw JSON.
The Problem
ClinicalTrials.gov is the world's largest registry of clinical research — 400,000+ trials, decades of outcomes data, all publicly accessible via a free API.
But the API gives you this:
{
"protocolSection": {
"eligibilityModule": {
"eligibilityCriteria": "Inclusion Criteria:\n\n* Willing to sign the informed consent form;\n* ≥18 years old;\n* Diagnosed histologically or cytologically with local advanced or metastatic HER2-positive malignant solid cancer...",
"stdAges": ["ADULT", "OLDER_ADULT"]
},
"adverseEventsModule": {
"eventGroups": [...],
"seriousEvents": [...],
"otherEvents": [...]
}
}
}
Every field is optional. Eligibility criteria are a single wall of free text. Adverse events are split across two arrays that reference a separate groups table by ID. Every trial returns a different shape.
To compare eligibility across 10 trials, you write 10 scripts — or spend two days copying into Excel. To find the adverse event profile of a completed study, you navigate five nested objects and cross-reference three tables. To do a competitive landscape analysis across a therapeutic area, you're looking at a week of work.
This is not a data problem. It is a tooling problem.
With clinicaltrials-mcp, the same work takes a conversation:
"Compare the eligibility criteria for these 5 NASH trials" "What were the Grade 3+ adverse events in NCT02142803?" "Find recruiting HER2-positive trials near Mumbai"
Seconds. Followed up. Drilled down. No scripts, no parsing, no Excel.
Install & Setup
Step 1 — Install
pip install clinicaltrials-mcp
No API key. No account. No configuration required.
Step 2 — Add to your MCP client
{
"mcpServers": {
"clinicaltrials": {
"command": "uvx",
"args": ["clinicaltrials-mcp"]
}
}
}
uvx runs the package without requiring it on your $PATH. If you don't have uv: pip install uv.
Restart your MCP client. The 5 tools appear automatically.
Running from source (contributors / developers)
git clone https://github.com/agents100x/clinicaltrials-mcp
cd clinicaltrials-mcp
uv sync
{
"mcpServers": {
"clinicaltrials": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/clinicaltrials-mcp",
"clinicaltrials-mcp"
]
}
}
}
Where is the config file?
| Client | Config file location |
|---|---|
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor | .cursor/mcp.json or Settings → MCP |
| VS Code / forks | Settings → MCP Servers → Edit config |
Restart the client after saving. The 5 tools appear automatically.
Sample Queries
Organised by real analyst workflows. All queries work in plain English — no syntax required.
Competitive Intelligence
"Show me recruiting Phase III trials for breast cancer"
"Find all active Phase II Alzheimer's trials in Europe"
"What NASH trials completed in the last 2 years?"
"Are there any recruiting trials for KRAS-mutant lung cancer?"
"Show me TERMINATED trials for diabetes — I want to know what failed"
The last query uses the status override: "...status='TERMINATED'" — WITHDRAWN and TERMINATED trials are excluded by default, but you can always ask for them explicitly.
Patient Eligibility & Site Feasibility (CRO Teams)
"Get the full eligibility criteria for NCT04280341"
"Find recruiting HER2-positive breast cancer trials near Mumbai, India"
"Find Type 2 Diabetes trials recruiting near Bangalore, India"
"Are there any recruiting immunotherapy trials near London?"
Note on site status: Results are filtered by overall trial status. Always verify the specific site's recruitment status at clinicaltrials.gov before contacting a site.
Protocol Comparison (Medical Writers / Researchers)
"Compare NCT04280341 and NCT02142803 on eligibility criteria"
"Compare the design and timeline of NCT04280341 and NCT03817944"
"Compare the endpoints of these three pembrolizumab trials: NCT04280341, NCT03817944, NCT02142803"
Focus the comparison with compare_on:
"...compare on design"— phase, randomisation, blinding, arms"...compare on eligibility"— inclusion/exclusion criteria side by side"...compare on endpoints"— primary and secondary outcomes"...compare on timeline"— start dates, completion dates, enrollment targets"...compare on locations"— countries and site counts
Results & Safety Review
"What were the adverse events reported in NCT02142803?"
"Show me all Grade 1 and above adverse events for NCT02142803"
"Give me a quick summary of the primary outcome of NCT02142803"
"What were the participant flow and dropout reasons in NCT02142803?"
Results options:
- Default shows serious adverse events only (Grade 3+)
- "...include all grades" → adds Grade 1/2 events
- "...summary only" → returns just the primary outcome in 2–3 lines, useful for scanning many trials
Edge Cases the Tool Handles Cleanly
"Get results for NCT03444521"
→ Returns: "Trial completed in 2022 but no results posted — this is common,
~60% of completed trials never post results. It does not mean the trial failed."
"Find recruiting trials for Niemann-Pick disease near Paris"
→ Returns: helpful no-results message with suggestions to broaden the search
"Find terminated trials for a condition"
→ Requires explicit status override — the tool tells you exactly how
The 5 Tools
| Tool | What It Does | Key Design Decision |
|---|---|---|
| search_trials | Search by condition, phase, status, location | WITHDRAWN + TERMINATED excluded by default — always explained, always overridable |
| get_trial_details | Full structured summary by NCT ID | Eligibility always verbatim — never paraphrased |
| compare_trials | Side-by-side comparison of 2–5 trials | compare_on param: all, design, eligibility, endpoints, timeline, locations |
| get_trial_results | Outcomes, AEs, participant flow | AE grade note top + bottom; 4-case no-results handling |
| find_recruiting_near | Recruiting trials near a location | City → country location rings, honest about CT.gov's city-level data |
Why This Is Different
Every other ClinicalTrials.gov MCP passes raw JSON from the API to the LLM and calls it done.
This is a workflow tool, not an API wrapper:
- Outputs designed around what analysts do — not what the API can return
- Opinionated defaults — RECRUITING sorts first, Grade 3+ AEs shown, status filter always explained
- Honest about data gaps — ~60% of completed trials never post results; we say so every time
- Verbatim eligibility criteria — never paraphrased, too risky to interpret clinical text
- Verification by design — NCT hyperlinks appear at the top and bottom of every trial detail
Limitations
- Data is self-reported by sponsors on ClinicalTrials.gov — not independently verified by us
- ~60% of completed trials have no posted results on CT.gov
- Trial status and site data may lag real-world updates by weeks
- Location filtering is city/country level — no GPS radius search available
- Not all trials in the world are registered on CT.gov
Data returned by this tool should never be used directly in regulatory submissions, publications, or clinical decisions without independent verification at clinicaltrials.gov.
Full scope and data disclaimer: DISCLAIMER.md
How It Works
Claude or Cursor
|
| MCP tool call over stdio
|
server.py — registers 5 tools, routes calls, catches all errors gracefully
|
client.py — async httpx client for CT.gov API v2 (public, no auth required)
|
ClinicalTrials.gov — public REST API, 400,000+ registered trials
|
formatters.py — transforms raw JSON into clean, structured markdown
|
Claude or Cursor — reads formatted output and responds to the user
Stack: Python 3.12+ · MCP Python SDK · httpx · uv
Contributing
git clone https://github.com/agents100x/clinicaltrials-mcp
cd clinicaltrials-mcp
uv sync
uv run pytest tests/ -m "not integration" # offline unit tests, ~0.3s
uv run pytest tests/ # full suite including live API
Bug reports and pull requests welcome at github.com/agents100x/clinicaltrials-mcp/issues.
License
MIT — see LICENSE for details.
Built by agents100x.
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
