AACT Clinical Trials MCP Server

Overview

A Model Context Protocol (MCP) server implementation that provides access to the AACT (Aggregate Analysis of ClinicalTrials.gov) database using the FastMCP framework. This server allows AI assistants to directly query clinical trial data from the ClinicalTrials.gov database.

Features

Tools

list_tables
- Get an overview of all available tables in the AACT database
- Useful for understanding the database structure before analysis
describe_table
- Examine the detailed structure of a specific AACT table
- Shows column names and data types
- Example: {"table_name": "studies"}
read_query
- Execute a SELECT query on the AACT clinical trials database
- Safely handle SQL queries with validation
- Example: {"query": "SELECT nct_id, brief_title FROM ctgov.studies LIMIT 5", "max_rows": 50}

Configuration

Database Access

Create a free account at https://aact.ctti-clinicaltrials.org/users/sign_up
Set environment variables:
- DB_USER: AACT database username
- DB_PASSWORD: AACT database password

Usage with Claude Desktop

Note that you need Claude Desktop and a Claude subscription at the moment.

Add one of the following configurations to the file claude_desktop_config.json. (On macOS, the file is located at /Users/YOUR_USERNAME/Library/Application Support/Claude/claude_desktop_config.json and you will need to create it yourself if it does not exist yet).

Option 1: Using the published package

{
  "mcpServers": {
    "CTGOV-MCP": {
      "command": "uvx",
      "args": [
        "mcp-server-aact"
      ],
      "env": {
        "DB_USER": "USERNAME",
        "DB_PASSWORD": "PASSWORD"
      }
    }
  }
}

Option 2: Using Docker

Simply add this configuration to claude_desktop_config.json (no build required):

{
  "mcpServers": {
    "CTGOV-MCP-DOCKER": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env", "DB_USER=YOUR_USERNAME",
        "--env", "DB_PASSWORD=YOUR_PASSWORD",
        "navisbio/mcp-server-aact:latest"
      ]
    }
  }
}

Option 3: Running from source (development)

Simply add this configuration to claude_desktop_config.json (no build required):

{
  "mcpServers": {
    "CTGOV-MCP-DOCKER": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env", "DB_USER=YOUR_USERNAME",
        "--env", "DB_PASSWORD=YOUR_PASSWORD",
        "navisbio/mcp-server-aact:latest"
      ]
    }
  }
}

Example Prompts

Here are some example prompts to use with this plugin:

"What are the most common types of interventions in breast cancer clinical trials?"
"How many phase 3 clinical trials were completed in 2023?"
"Show me the enrollment statistics for diabetes trials across different countries"
"What percentage of oncology trials have reported results in the last 5 years?"

Troubleshooting

`spawn uvx ENOENT` Error

This error has been reported when the system cannot find the uvx command which might happen when uvx is installed in a non-standard location (like ~/.local/bin/).

Potential Solution: Update your configuration with the full path. For example:

{
"mcpServers": {
    "CTGOV-MCP": {
      "command": "/Users/username/.local/bin/uvx",
      "args": [
        "mcp-server-aact"
      ],
      "env": {
        "DB_USER": "USERNAME",
        "DB_PASSWORD": "PASSWORD"
      }
    }
}
}

Contributing

We welcome contributions! Please:

Open an issue on GitHub
Start a discussion
Email: jonas.walheim@navis-bio.com

Acknowledgements

This project was inspired by and initially based on code from:

Thanks to these awesome projects for showing us the way! 🙌

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides access to the ClinicalTrials.gov AACT database, enabling analysis of clinical trial data, tracking development trends, and generating therapeutic landscape insights.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Cortellis MCP Server
uh-joan
A
security
A
license
A
quality
Enables searching for drugs and exploring ontology terms in the Cortellis database, providing access to comprehensive drug development status information with structured JSON responses.
Last updated -
7
123
1
MIT License
BioMCP
genomoncology
A
security
A
license
A
quality
Provides LLMs with structured access to critical biomedical databases including PubTator3 (PubMed/PMC), ClinicalTrials.gov, and MyVariant.info through the Model Context Protocol.
Last updated -
35
277
MIT License
AACT Clinical Trials MCP Server
navisbio
-
security
A
license
-
quality
Provides AI assistants with direct query access to the AACT (Aggregate Analysis of ClinicalTrials.gov) database, allowing structured retrieval and analysis of clinical trial data.
Last updated -
16
GPL 3.0
Mutation Clinical Trial Matching MCP
pickleton89
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude Desktop to search clinicaltrials.gov for matching clinical trials based on genetic mutations provided in natural language queries.
Last updated -
MIT License

View all related MCP servers

AACT Clinical Trials MCP Server