Harvard ClinicalTrials MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 16 tools to Get Api Version, Get Study, Get Study Results, and more
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Harvard ClinicalTrials through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The Harvard ClinicalTrials MCP Server for OpenAI Agents SDK is a standout in the Data Analytics category — giving your AI agent 16 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="Harvard ClinicalTrials Assistant",
instructions=(
"You help users interact with Harvard ClinicalTrials. "
"You have access to 16 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from Harvard ClinicalTrials"
)
print(result.final_output)
asyncio.run(main())
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Harvard ClinicalTrials MCP Server
Connect to the ClinicalTrials.gov API v2 — the largest database of clinical studies worldwide, maintained by the U.S. National Library of Medicine.
The OpenAI Agents SDK auto-discovers all 16 tools from Harvard ClinicalTrials through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Harvard ClinicalTrials, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Study Search — Search 400K+ clinical trials from 220+ countries
- Condition Filter — Find trials for specific diseases (cancer, diabetes, Alzheimer's)
- Intervention Filter — Search by drug, device, or therapy name
- Sponsor Search — Find trials by organization (Pfizer, NIH, Roche)
- Phase Filter — Filter by Phase 1-4 to track drug development stages
- Recruiting — Find trials currently enrolling participants
- Location — Search by city or country for accessible trials
- FDA Regulated — Filter for FDA-regulated drug and device trials
- Pediatric — Find trials including children
- Rare Diseases — Discover research for orphan conditions
- Results — Get outcome data from completed studies
The Harvard ClinicalTrials MCP Server exposes 16 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 16 Harvard ClinicalTrials tools available for OpenAI Agents SDK
When OpenAI Agents SDK connects to Harvard ClinicalTrials through Vinkius, your AI agent gets direct access to every tool listed below — spanning clinical-trials, medical-research, drug-development, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Get api version on Harvard ClinicalTrials
gov API version and the timestamp of the most recent data update. Useful for verifying data currency and API availability. Get API version and data timestamp
Get study on Harvard ClinicalTrials
g. "NCT04368728"). Returns title, status, phase, enrollment, conditions, interventions, eligibility criteria, sponsor, and study locations. Get clinical trial details by NCT ID
Get study results on Harvard ClinicalTrials
Not all trials report results — this is most useful for completed Phase 2-4 studies. Get primary outcome results for a trial
Get study timeline on Harvard ClinicalTrials
Essential for understanding the progress and currency of a study. Get the complete timeline of a clinical trial
Search by condition on Harvard ClinicalTrials
Examples: "diabetes", "breast cancer", "Alzheimer disease", "COVID-19", "depression", "hypertension". Search trials by medical condition
Search by intervention on Harvard ClinicalTrials
Examples: "pembrolizumab", "metformin", "radiation therapy", "cognitive behavioral therapy". Search trials by drug or treatment
Search by location on Harvard ClinicalTrials
Essential for finding trials accessible to patients in a particular area. Search trials by geographic location
Search by phase on Harvard ClinicalTrials
Phase values: "PHASE1", "PHASE2", "PHASE3", "PHASE4", "EARLY_PHASE1". Phase 3 trials are the largest and most definitive, while Phase 1 trials focus on safety. Search trials by study phase
Search by sponsor on Harvard ClinicalTrials
Examples: "Pfizer", "National Cancer Institute", "Roche", "Novartis", "NIH". Search trials by sponsoring organization
Search completed on Harvard ClinicalTrials
Completed trials are more likely to have published results and outcomes data. Search completed clinical trials
Search device trials on Harvard ClinicalTrials
Covers diagnostic devices, surgical tools, implants, and digital health technologies. Search medical device clinical trials
Search fda regulated on Harvard ClinicalTrials
S. Food and Drug Administration. These trials follow the most rigorous regulatory standards. Search FDA-regulated drug trials
Search pediatric on Harvard ClinicalTrials
Essential for pediatricians, child health researchers, and parents seeking trials for children. Search pediatric clinical trials
Search rare diseases on Harvard ClinicalTrials
Examples: "cystic fibrosis", "sickle cell disease", "Huntington disease", "amyotrophic lateral sclerosis". Search rare disease clinical trials
Search recruiting on Harvard ClinicalTrials
Essential for patients seeking to enroll in trials or researchers tracking active studies. Search for currently recruiting studies
Search studies on Harvard ClinicalTrials
gov database of over 400,000 clinical studies from 200+ countries. Returns NCT IDs, titles, status, phases, sponsors, conditions, interventions, and locations. Search 400K+ clinical trials worldwide
Connect Harvard ClinicalTrials to OpenAI Agents SDK via MCP
Follow these steps to wire Harvard ClinicalTrials into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the Harvard ClinicalTrials MCP Server
OpenAI Agents SDK provides unique advantages when paired with Harvard ClinicalTrials through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Harvard ClinicalTrials + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the Harvard ClinicalTrials MCP Server delivers measurable value.
Automated workflows: build agents that query Harvard ClinicalTrials, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries Harvard ClinicalTrials, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through Harvard ClinicalTrials tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query Harvard ClinicalTrials to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for Harvard ClinicalTrials in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Harvard ClinicalTrials immediately.
"Find recruiting Phase 3 trials for breast cancer immunotherapy"
"Search for Alzheimer's disease trials sponsored by NIH in Boston"
"Find pediatric clinical trials for cystic fibrosis"
Troubleshooting Harvard ClinicalTrials MCP Server with OpenAI Agents SDK
Common issues when connecting Harvard ClinicalTrials to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
Harvard ClinicalTrials + OpenAI Agents SDK FAQ
Common questions about integrating Harvard ClinicalTrials MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
NeetoInvoice
20 toolsAutomate billing and project management via NeetoInvoice — manage clients, track time, and generate invoices directly from any AI agent.

Rio Grande do Sul (Dados RS)
11 toolsAccess the official Open Data portal of Rio Grande do Sul — query public datasets, government organizations, and thematic groups directly.

BoomTown (OvationCXM)
10 toolsOrchestrate customer journeys via OvationCXM — manage journeys, teams, and support issues directly from any AI agent.

PMC Open Access (PubMed Central)
8 toolsAccess millions of open-access biomedical and life sciences research articles. Search metadata, convert IDs, and discover full-text resources.
