AWS HealthOmics — Claude Code MCP server: what it does
Connects AI assistants to AWS HealthOmics to launch genomic workflows, validate WDL or CWL code, track tasks, and query CloudWatch OpenTelemetry metrics.
Apache-2.0 ★ 9,939 updated 2026-10-23
Open on GitHubWhat AWS HealthOmics does
This server connects coding assistants to AWS HealthOmics for managing genomic workflows. It allows models to create, lint, and bundle pipelines written in WDL, CWL, or Nextflow. Workflow validation relies on miniwdl and cwltool. Tools can also locate genomics data across S3 buckets and sequence stores, pairing BAM files with BAI indexes automatically.
Beyond authoring, it handles execution tracking and failure diagnosis. An agent can launch runs with custom VPC networking, inspect engine logs, and evaluate hardware bottlenecks across CPU, memory, and I/O. Fine-grained telemetry is retrieved via the CloudWatch PromQL API. Because metrics sample roughly every 30 seconds, tasks that finish in under 60 seconds produce no datapoints, leaving run manifests as the only fallback for quick steps.
What it helps with
- Lint WDL and CWL workflow files using
miniwdlandcwltool - Launch genomics workflow runs in AWS HealthOmics with custom VPC settings
- Discover and group paired FASTQ files or BAM/BAI indexes in S3
- Diagnose failed workflow runs through engine and task logs
- Compare CPU and memory resource consumption across separate runs
Example prompts for the agent
- Lint this WDL workflow file before deploying it to HealthOmics.
- Search the S3 bucket for paired FASTQ files and associated indexes.
- Inspect the task logs of my latest failed HealthOmics run and pinpoint the error.
How to install AWS HealthOmics
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AWS HealthOmics
What does the AWS HealthOmics MCP server do?
It enables AI tools to build, lint, and run genomics workflows in AWS HealthOmics, find bioinformatics files in S3, and diagnose execution failures.
Which tools validate workflow definitions?
The server runs miniwdl and cwltool to lint individual files or multi-file bundles in WDL and CWL formats.
Why might CloudWatch telemetry be missing for a run?
Fine-grained metrics require runs started after 2026-09-09 and sample roughly every 30 seconds. Tasks finishing under 60 seconds do not generate data points.