How to Use the Harvard ClinicalTrials MCP in Windsurf

Q: Can Windsurf write code using Harvard ClinicalTrials data?

Yes, Cascade pulls raw trial data via getstudy and immediately writes custom scripts to parse the JSON. It handles the entire lifecycle from querying the Harvard server to saving the structured output.

Q: Can Windsurf fetch completed trial results from the Harvard database?

Definitely. Cascade uses searchcompleted to find finished studies, and then queries getstudyresults to retrieve the primary outcome data for your analysis.

Search and analyze 400k+ clinical trials directly inside Windsurf using Cascade's autonomous tool chaining.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Harvard ClinicalTrials MCP to Windsurf

Create your Vinkius account to connect Harvard ClinicalTrials to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Harvard ClinicalTrials with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map trial registries autonomously with Cascade

This Harvard ClinicalTrials MCP Server exposes the `search_by_condition` tool to let Cascade automatically scan your workspace files, find medical conditions, and fetch active studies. Cascade doesn't just stop at search results. It chains the output to run `get_study` and extract specific patient enrollment criteria, leaving you with a clean markdown table of target studies in seconds.

Run deep pipeline analysis on drug interventions

When you ask Windsurf to analyze a specific treatment pathway, Cascade executes `search_by_intervention` to pull every trial matching that drug. It parses the trial phases to separate early-stage safety profiles from large phase 3 efficacy studies. If a study catches your eye, Cascade calls `get_study_results` and `get_study_timeline` to map out exactly when the trials wrapped up and what the primary outcomes look like.

Track regional trial sites for patient cohorts

Tracking down active study sites requires the `search_by_location` tool to filter trials near your target areas. By feeding this geographical data directly into Cascade along with `search_recruiting`, your agent builds localized patient-matching pipelines using this MCP integration.

Setup guide

Set up Harvard ClinicalTrials MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Harvard ClinicalTrials MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Harvard ClinicalTrials payment history." If connected, Cascade will call the Harvard ClinicalTrials tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "harvard-clinicaltrials-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ClinicalTrials.gov. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Harvard ClinicalTrials now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Harvard ClinicalTrials MCP in Windsurf

This integration links Cascade directly to the ClinicalTrials.gov database via the MCP Server. When you ask Cascade a clinical research question, it uses tools like `search_studies` to fetch live data without making you leave your IDE.

Yes, Cascade pulls raw trial data via `get_study` and immediately writes custom scripts to parse the JSON. It handles the entire lifecycle from querying the Harvard server to saving the structured output.

You just tell Cascade to find pediatric trials for a condition, and it automatically calls `search_pediatric` and matches it with `search_by_condition` to isolate the exact cohort parameters you need.

Definitely. Cascade uses `search_completed` to find finished studies, and then queries `get_study_results` to retrieve the primary outcome data for your analysis.

The server only pulls public, de-identified clinical trial protocols and aggregate study results from ClinicalTrials.gov. Vinkius runs the server in an isolated sandbox, meaning your proprietary research prompts and patient cohort queries never leak to the public web.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript