Query clinical data standards (SDTM, ADaM, CDASH, CT) via AI assistants.
CDISC Library MCP Server β Query clinical data standards (SDTM, ADaM, CDASH, CT) directly from AI assistants.
π Translations: δΈζ README Β· ζ₯ζ¬θͺ README
What is This?
The CDISC MCP Server connects AI assistants (Claude, VS Code Copilot, Cursor, etc.) to the CDISC Library REST API, exposing 11 structured tools for querying clinical trial data standards. Ask your AI assistant questions like:
"What variables are in the SDTM AE domain?"/m "Show me the ADSL variables in ADaM IG 1.3" "List all available Controlled Terminology packages"
For full setup instructions, see the User Manual β. See Examples β for real conversation samples.
Quick Start
0 Β· One-Line AI Install
Have an AI assistant install everything for you:
curl -fsSL https://raw.githubusercontent.com/Teninq/cdisc-mcp/main/install.md
Paste the output into Claude, Copilot, or any AI chat β it will read the guide and walk you through the full setup interactively.
1 Β· Get a CDISC Library API Key
Register at https://library.cdisc.org and obtain a personal API key.
2 Β· Install
# Runtime only
pip install -e .
# With dev dependencies
pip install -e ".[dev]"
# With web explorer
pip install -e ".[web]"
3 Β· Set API Key
# Linux / macOS
export CDISC_API_KEY=your_key_here
# Windows β Command Prompt
set CDISC_API_KEY=your_key_here
# Windows β PowerShell
$env:CDISC_API_KEY = "your_key_here"
4 Β· Run
# Start MCP server (for AI assistant integration)
cdisc-mcp
# OR: Start Web Explorer (quick interactive testing)
python web/app.py
Web Explorer β Quick Interactive Testing
The fastest way to verify your setup and explore tools without any AI client.
# 1. Install web dependencies
pip install -e ".[web]"
# 2. Set your API key
export CDISC_API_KEY=your_key_here # Linux/macOS
set CDISC_API_KEY=your_key_here # Windows CMD
$env:CDISC_API_KEY = "your_key_here" # Windows PowerShell
# 3. Start the bridge server
python web/app.py
# 4. Open in browser
# β http://localhost:8080
The explorer provides:
- Sidebar navigation β all 11 tools organized by standard (SDTM / ADaM / CDASH / Terminology)
- Auto-generated forms β dropdowns for versions and domains, text inputs for variables
- Live JSON responses β syntax-highlighted, copyable output with response time
- Bridge status indicator β confirms your API key and connectivity
Tip: Use version strings with dashes β
3-4not3.4,1-3not1.3. Example: SDTM-IG3-4, ADaM-IG1-3, CDASH-IG2-0
Available Tools
| # | Tool | Standard | Description |
|---|---|---|---|
| 1 | list_products |
β | List all available CDISC standards and published versions |
| 2 | get_sdtm_domains |
SDTM | List all datasets in a SDTM-IG version |
| 3 | get_sdtm_domain_variables |
SDTM | List all variables in an SDTM domain/dataset |
| 4 | get_sdtm_variable |
SDTM | Get full definition of a specific SDTM variable |
| 5 | get_adam_datastructures |
ADaM | List all data structures in an ADaM-IG version |
| 6 | get_adam_variable |
ADaM | Get definition of a specific ADaM variable |
| 7 | get_cdash_domains |
CDASH | List all domains in a CDASH-IG version |
| 8 | get_cdash_domain_fields |
CDASH | Get all data collection fields for a CDASH domain |
| 9 | list_ct_packages |
CT | List all available Controlled Terminology packages |
| 10 | get_codelist |
CT | Get definition and metadata of a CT codelist |
| 11 | get_codelist_terms |
CT | List all valid terms in a CT codelist |
Version Reference
| Standard | Available Versions (use dashes) |
|---|---|
| SDTM-IG | 3-4 Β· 3-3 Β· 3-2 Β· 3-1-3 |
| ADaM-IG | 1-3 Β· 1-2 Β· 1-1 Β· 1-0 |
| CDASH-IG | 2-1 Β· 2-0 Β· 1-1-1 |
Connect to an AI Assistant
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"cdisc": {
"command": "cdisc-mcp",
"env": {
"CDISC_API_KEY": "your_key_here"
}
}
Tools (11)
list_productsList all available CDISC standards and published versionsget_sdtm_domainsList all datasets in a SDTM-IG versionget_sdtm_domain_variablesList all variables in an SDTM domain/datasetget_sdtm_variableGet full definition of a specific SDTM variableget_adam_datastructuresList all data structures in an ADaM-IG versionget_adam_variableGet definition of a specific ADaM variableget_cdash_domainsList all domains in a CDASH-IG versionget_cdash_domain_fieldsGet all data collection fields for a CDASH domainlist_ct_packagesList all available Controlled Terminology packagesget_codelistGet definition and metadata of a CT codelistget_codelist_termsList all valid terms in a CT codelistEnvironment Variables
CDISC_API_KEYrequiredPersonal API key from the CDISC LibraryConfiguration
{"mcpServers": {"cdisc": {"command": "cdisc-mcp", "env": {"CDISC_API_KEY": "your_key_here"}}}}