Define-XML MCP Server
Enables the generation of metadata summaries and entity reports from CDISC Define-XML documents in Markdown format.
Provides comprehensive tools for loading, parsing, and querying CDISC Define-XML (versions 2.0 and 2.1) files, including support for datasets, variables, codelists, and Analysis Results Metadata (ARM).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Define-XML MCP Server summarize the clinical metadata for /clinical/data/sdtm/define.xml"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
define-xml-mcp-server
TypeScript MCP server for CDISC Define-XML.
Features
Supports Define-XML 2.0 and 2.1
Detects Define version and ARM presence from ODM attributes
Supports both MCP transports:
stdio(default)Streamable HTTP (
/mcpendpoint)
Local file-path input only
Multi-document in-memory cache using
document_idResponse formats:
jsonmarkdown
Related MCP server: MCP-Typescribe
Install
npm installBuild
npm run buildRun
stdio (default)
npm run devor
node dist/index.js --transport=stdioStreamable HTTP
node dist/index.js --transport=http --port=3000Server endpoint:
POST /mcp
Tool Catalog
Document Tools
define_load_documentInput:
file_path,response_formatLoads/parses XML and returns
document_id
define_close_documentInput:
document_id,response_formatRemoves document from cache
define_get_metadata_summaryInput:
document_id,response_formatReturns metadata and entity counts
Required List/Get Tools
Datasets
define_list_datasetsdefine_get_dataset
Variables
define_list_variablesdefine_get_variable
Codelists
define_list_codelistsdefine_get_codelist
ARM
define_list_arm_resultsdefine_get_arm_result
Search Tool
define_search
Notes
ARM is optional. ARM tools return empty results when ARM data is not present.
All list tools support pagination via
offsetandlimit.
Available Tools
13 toolsdefine_close_documentClose Define-XML DocumentADestructiveIdempotent
Remove a loaded Define-XML document from in-memory cache by document_id.
Inputs: document_id (required), response_format.
define_get_arm_resultGet Define-XML ARM ResultBRead-onlyIdempotent
Get a single ARM analysis result by OID or name from a loaded Define-XML document.
Inputs: oid (required), document_id (required), response_format.
define_get_codelistGet Define-XML CodelistARead-onlyIdempotent
Get a single codelist by name from a loaded Define-XML document.
Inputs: name (required), document_id (required), include_terms, response_format.
define_get_datasetGet Define-XML DatasetARead-onlyIdempotent
Get a single dataset by OID or name from a loaded Define-XML document.
Inputs: name (required), document_id (required), response_format, include_variables.
define_get_metadata_summaryGet Define-XML Metadata SummaryARead-onlyIdempotent
Return high-level document metadata and counts of datasets/variables/codelists/ARM results.
Inputs: document_id (required), response_format.
define_get_variableGet Define-XML VariableARead-onlyIdempotent
Get a single variable by name and dataset name from a loaded Define-XML document.
Inputs: name (required), document_id (required), dataset_name (required), response_format.
define_list_arm_resultsList Define-XML ARM ResultsARead-onlyIdempotent
List ARM analysis results from a loaded Define-XML document (empty when ARM not present).
Inputs: document_id (required), limit, offset, response_format.
define_list_codelistsList Define-XML CodelistsARead-onlyIdempotent
List codelists from a loaded Define-XML document with pagination.
Inputs: document_id (required), limit, offset, response_format.
define_list_datasetsList Define-XML DatasetsARead-onlyIdempotent
List datasets (ItemGroupDef) from a loaded Define-XML document with pagination.
Inputs: document_id (required), limit, offset, response_format.
define_list_variablesList Dataset VariablesARead-onlyIdempotent
List variables of a specific dataset from a loaded Define-XML document with pagination.
Inputs: document_id (required), dataset_name (required), limit, offset, +1 more.
define_load_documentLoad Define-XML DocumentARead-onlyIdempotent
Load and parse a local Define-XML file. Returns a document_id for subsequent tool calls.
Inputs: file_path (required), response_format.
define_reload_documentReload Define-XML DocumentBRead-only
Reload a previously loaded Define-XML document from disk, replacing the cached version. Returns the new document_id.
Inputs: document_id (required), response_format.
define_searchSearch Define-XML EntitiesARead-onlyIdempotent
Search across datasets, variables, codelists, and ARM results in a loaded Define-XML document.
Inputs: query (required), document_id (required), response_format.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool has a clearly distinct purpose: loading, closing, listing, and getting specific components (datasets, variables, codelists, ARM results) plus metadata summary and search. No overlap in functionality.
All tools follow the consistent pattern 'define_verb_noun' (e.g., define_load_document, define_list_datasets). Verbs and nouns are descriptive and uniform.
13 tools is well-scoped for a Define-XML document server: covers loading, reloading, querying individual items, listing with pagination, search, metadata summary, and memory management (close). Not excessive nor too sparse.
The tool set covers all fundamental read operations for Define-XML documents: load, list and get datasets/variables/codelists/ARM results, search, and metadata summary. Minor gaps like retrieving item groups beyond datasets or getting raw XML snippets exist but don't hinder core usage.
Related MCP Connectors
Token-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval.
An MCP server that provides congressional transcripts
MCP server for US nursing facility search and ownership lookup (NursingHomeDatabase).
Hosted MCP server for AI-driven data ops. Create apps, manage schemas, and CRUD structured data.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceA TypeScript-based MCP server that connects to FHIR servers, allowing access to healthcare data via fhir:// URIs and providing search capabilities for FHIR resources.65-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables LLMs to understand and work with TypeScript APIs they haven't been trained on by providing structured access to TypeScript type definitions and documentation.46MIT
- AlicenseNot gradedqualityDmaintenanceA TypeScript MCP server for managing persistent knowledge graphs with entities, directional relations, and time-based observations. It enables users to create, search, and track structured information with built-in concurrency control and JSON file storage.MIT
- FlicenseNot gradedqualityDmaintenanceA TypeScript MCP server that validates codebases against configurable rules. It analyzes files for violations and generates JSON reports, supporting custom rule definitions and file extensions.-