HUB
Sign inSign up
aws-healthomics-mcp-server logo

mcp/aws-healthomics-mcp-server

Verified Publisher

By mcp

•Updated 4 months ago

Generate, run, debug lifescience workflows.

Image
Machine learning & AI
0

10K+

mcp/aws-healthomics-mcp-server repository overview

⁠AWS HealthOmics MCP Server

Generate, run, debug lifescience workflows.

What is an MCP Server?⁠

⁠MCP Info

⁠Image Building Info

AttributeDetails
Dockerfilehttps://github.com/awslabs/mcp/blob/636aca8e109b5559006044f035bb89c16e9e5410/src/aws-healthomics-mcp-server/Dockerfile⁠
Commit636aca8e109b5559006044f035bb89c16e9e5410
Docker Image built byDocker Inc.
Docker Scout Health ScoreDocker Scout Health Score
Verify SignatureCOSIGN_REPOSITORY=mcp/signatures cosign verify mcp/aws-healthomics-mcp-server --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
LicenceApache License 2.0

⁠Available Tools (73)

Tools provided by this ServerShort Description
ActivateAHOReadSetsActivate archived read sets in a HealthOmics sequence store.
AnalyzeAHORunPerformanceAnalyze AWS HealthOmics workflow run performance and provide optimization recommendations.
CancelAHORunBatchCancel all runs in a HealthOmics batch.
CheckContainerAvailabilityCheck if a container image is available in ECR and accessible by HealthOmics.
CloneContainerToECRClone a container image to a private ECR repository for HealthOmics use.
CreateAHOConfigurationCreate a new HealthOmics configuration.
CreateAHORunCacheCreate a new HealthOmics run cache.
CreateAHORunGroupCreate a new HealthOmics run group.
CreateAHOSequenceStoreCreate a new HealthOmics sequence store.
CreateAHOWorkflowCreate a new HealthOmics workflow.
CreateAHOWorkflowVersionCreate a new version of an existing workflow.
CreateCodeConnectionCreate a new CodeConnection.
CreateContainerRegistryMapCreate a container registry map for HealthOmics workflows.
CreatePullThroughCacheForHealthOmicsCreate a pull-through cache rule configured for HealthOmics.
DeleteAHOBatchDelete a HealthOmics batch metadata (does not delete runs).
DeleteAHOConfigurationDelete a HealthOmics configuration.
DeleteAHORunBatchDelete all runs in a HealthOmics batch.
DiagnoseAHORunFailureProvides comprehensive diagnostic information for a failed workflow run.
GenerateAHORunTimelineGenerate a Gantt-style timeline visualization for an AWS HealthOmics workflow run.
GetAHOBatchGet details of a specific HealthOmics batch.
GetAHOConfigurationGet details of a specific HealthOmics configuration.
GetAHOReadSetExportJobGet details about a read set export job.
GetAHOReadSetImportJobGet details about a read set import job.
GetAHOReadSetMetadataGet metadata for a specific read set in a HealthOmics sequence store.
GetAHOReferenceImportJobGet details about a reference import job.
GetAHOReferenceMetadataGet metadata for a specific reference in a HealthOmics reference store.
GetAHOReferenceStoreGet details about a specific HealthOmics reference store.
GetAHORunGet details about a specific run.
GetAHORunCacheGet details of a specific HealthOmics run cache.
GetAHORunEngineLogsRetrieve engine logs containing STDOUT and STDERR from the workflow engine process.
GetAHORunGroupGet details of a specific HealthOmics run group.
GetAHORunLogsRetrieve high-level run logs that show workflow execution events.
GetAHORunManifestLogsRetrieve run manifest logs produced when a workflow completes or fails.
GetAHORunTaskGet details about a specific task.
GetAHOSequenceStoreGet details about a specific HealthOmics sequence store.
GetAHOSupportedRegionsGet the list of AWS regions where HealthOmics is available.
GetAHOTaskLogsRetrieve logs for a specific workflow task containing STDOUT and STDERR.
GetAHOWorkflowGet details about a specific workflow.
GetCodeConnectionGet details about a specific CodeConnection.
GetSupportedFileTypesGet information about supported genomics file types.
GrantHealthOmicsRepositoryAccessGrant HealthOmics access to an ECR repository.
LintAHOWorkflowBundleLint multi-file WDL or CWL workflow bundles and return validation findings.
LintAHOWorkflowDefinitionLint WDL or CWL workflow definitions and return validation findings.
ListAHOBatchesList HealthOmics batches.
ListAHOConfigurationsList HealthOmics configurations.
ListAHOReadSetExportJobsList read set export jobs for a sequence store.
ListAHOReadSetImportJobsList read set import jobs for a sequence store.
ListAHOReadSetsList read sets in a HealthOmics sequence store with optional filtering.
ListAHOReferenceImportJobsList reference import jobs for a reference store.
ListAHOReferenceStoresList HealthOmics reference stores.
ListAHOReferencesList references in a HealthOmics reference store with optional filtering.
ListAHORunCachesList HealthOmics run caches.
ListAHORunGroupsList HealthOmics run groups.
ListAHORunTasksList tasks for a specific run.
ListAHORunsList workflow runs.
ListAHORunsInBatchList runs within a HealthOmics batch.
ListAHOSequenceStoresList HealthOmics sequence stores.
ListAHOWorkflowVersionsList versions of a workflow.
ListAHOWorkflowsList available HealthOmics workflows.
ListCodeConnectionsList available CodeConnections.
ListECRRepositoriesList ECR repositories with HealthOmics accessibility status.
ListPullThroughCacheRulesList pull-through cache rules with HealthOmics usability status.
PackageAHOWorkflowPackage workflow definition files into a base64-encoded ZIP.
SearchGenomicsFilesSearch for genomics files across S3 buckets, HealthOmics sequence stores, and reference stores.
StartAHOReadSetExportJobStart a read set export job to export read sets from a sequence store to S3.
StartAHOReadSetImportJobStart a read set import job to import genomic files from S3 into a sequence store.
StartAHOReferenceImportJobStart a reference import job to import reference files from S3 into a reference store.
StartAHORunStart a workflow run.
StartAHORunBatchStart a new HealthOmics run batch.
UpdateAHORunCacheUpdate an existing HealthOmics run cache.
UpdateAHORunGroupUpdate an existing HealthOmics run group.
UpdateAHOSequenceStoreUpdate a HealthOmics sequence store.
ValidateHealthOmicsECRConfigValidate ECR configuration for HealthOmics workflows.

⁠Tools Details

⁠Tool: ActivateAHOReadSets

Activate archived read sets in a HealthOmics sequence store.

Starts an activation job to move read sets from archive storage back to active storage.

ParametersTypeDescription
read_set_idsstringList of read set IDs to activate as a JSON list or array, e.g. ["id1", "id2"]
sequence_store_idstringThe ID of the sequence store
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.

⁠Tool: AnalyzeAHORunPerformance

Analyze AWS HealthOmics workflow run performance and provide optimization recommendations.

This tool analyzes HealthOmics workflow runs to help users optimize:

  • Resource utilization patterns (CPU, memory)
  • Cost optimization opportunities
  • Performance bottlenecks
  • Resource allocation efficiency
  • Runtime optimization suggestions

Use this tool when users ask about:

  • "How can I optimize my HealthOmics runs?"
  • "Why is my workflow using too many resources?"
  • "How can I reduce costs for my genomic workflows?"
  • "What resources are being wasted in my runs?"
  • "How can I improve workflow performance?"

The tool summarizes run manifest logs containing task-level metrics and provides a structured report with recommendations for optimization.

ParametersTypeDescription
run_idsstringList of run IDs to analyze for resource optimization. Can be provided as a JSON array string like ["run1", "run2"] or as a comma-separated string like "run1,run2"
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
detailedboolean optionalInclude very detailed task metrics in the report. Typically this is only required for granular analysis and can consume a large number of tokens in the agents context window. Default is False.
headroomnumber optionalHeadroom percentage for instance recommendations (0.0 to 1.0). Default is 0.20 (20%). This adds a buffer to recommended instance sizes to prevent over-optimization. Set this value to 0 for aggressive optimization

⁠Tool: CancelAHORunBatch

Cancel all runs in a HealthOmics batch.

ParametersTypeDescription
batch_idstringID of the batch to cancel
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.

⁠Tool: CheckContainerAvailability

Check if a container image is available in ECR and accessible by HealthOmics.

Queries ECR to determine if a specific container image exists in a repository and whether HealthOmics has the required permissions to pull the image. For pull-through cache repositories, indicates that the image may be pulled on first access even if not currently cached.

When initiate_pull_through is True and the image is not found in a pull-through cache repository that is accessible to HealthOmics, this function will attempt to initiate the pull-through using ECR's batch_get_image API call. This triggers ECR to pull the image from the upstream registry and cache it locally.

ParametersTypeDescription
repository_namestringECR repository name (e.g., "my-repo" or "docker-hub/library/ubuntu")
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
image_digeststring optionalImage digest (sha256:...) - if provided, takes precedence over tag
image_tagstring optionalImage tag to check (default: "latest")
initiate_pull_throughboolean optionalIf True and the image is not found in a pull-through cache repository that is accessible to HealthOmics, attempt to initiate the pull-through using batch_get_image API call

⁠Tool: CloneContainerToECR

Clone a container image to a private ECR repository for HealthOmics use.

This tool copies a container image from an upstream registry (Docker Hub, Quay.io, ECR Public) to your private ECR repository with appropriate HealthOmics access permissions. It uses ECR pull-through cache to perform the copy.

The tool will:

  1. Parse the source image reference (handling Docker Hub shorthand like "ubuntu:latest")
  2. Find an existing pull-through cache rule for the source registry
  3. Use the pull-through cache to pull the image into ECR
  4. Grant HealthOmics access permissions to the repository
  5. Return the ECR URI and digest for use in workflows

Image reference formats supported:

  • "ubuntu:latest" -> registry-1.docker.io/library/ubuntu:latest
  • "myorg/myimage:v1" -> registry-1.docker.io/myorg/myimage:v1
  • "quay.io/biocontainers/samtools:1.17" -> quay.io/biocontainers/samtools:1.17
  • "public.ecr.aws/lts/ubuntu:22.04" -> public.ecr.aws/lts/ubuntu:22.04 Parameters|Type|Description -|-|- source_image|string|Source container image reference (e.g., "ubuntu:latest", "myorg/myimage:v1", "quay.io/org/image:tag") aws_profile|string optional|AWS profile name for this operation. Overrides the default credential chain. aws_region|string optional|AWS region for this operation. Overrides the server default. target_image_tag|string optional|Target image tag. If not provided, uses source tag or "latest". target_repository_name|string optional|Target ECR repository name. Only used if no pull-through cache exists. If not provided, derives from source image.

⁠Tool: CreateAHOConfiguration

Create a new HealthOmics configuration.

ParametersTypeDescription
namestringConfiguration name (max 50 chars)
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
descriptionstring optionalConfiguration description
run_configurationsstring optionalRun configuration settings (e.g. securityGroupIds and subnetIds)
tagsstring optionalResource tags

⁠Tool: CreateAHORunCache

Create a new HealthOmics run cache.

ParametersTypeDescription
cache_behaviorstringCache behavior (CACHE_ALWAYS or CACHE_ON_FAILURE)
cache_s3_locationstringS3 URI for cache storage (e.g., s3://bucket/prefix)
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
cache_bucket_owner_idstring optionalAWS account ID of the S3 bucket owner for cross-account access
descriptionstring optionalDescription for the run cache
namestring optionalName for the run cache
tagsstring optionalTags to apply to the run cache

⁠Tool: CreateAHORunGroup

Create a new HealthOmics run group.

ParametersTypeDescription
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
max_cpusstring optionalMaximum CPUs for the run group (1-100000)
max_durationstring optionalMaximum duration in minutes (1-100000)
max_gpusstring optionalMaximum GPUs for the run group (1-100000)
max_runsstring optionalMaximum concurrent runs (1-100000)
namestring optionalName for the run group (1-128 characters)
tagsstring optionalTags to apply to the run group

⁠Tool: CreateAHOSequenceStore

Create a new HealthOmics sequence store.

ParametersTypeDescription
namestringName for the new sequence store
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
descriptionstring optionalOptional description for the sequence store
fallback_locationstring optionalS3 URI for the fallback location of the sequence store
sse_kms_key_arnstring optionalKMS key ARN for server-side encryption of the sequence store
tagsstring optionalTags to apply to the sequence store as a JSON string or object, e.g. {"key": "value"}

⁠Tool: CreateAHOWorkflow

Create a new HealthOmics workflow.

ParametersTypeDescription
namestringName of the workflow
acceleratorsstring optionalComputational accelerator type (GPU). Currently unused by the HealthOmics service. Reserved for future support.
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
container_registry_mapstring optionalOptional container registry map with registryMappings (upstreamRegistryUrl, ecrRepositoryPrefix, upstreamRepositoryPrefix, ecrAccountId) and imageMappings (sourceImage, destinationImage) arrays
container_registry_map_uristring optionalOptional S3 URI pointing to a JSON file containing container registry mappings. Cannot be used together with container_registry_map
definition_repositorystring optionalGit repository configuration with connection_arn, full_repository_id, source_reference (type and value), and optional exclude_file_patterns. Cannot be used together with definition_source or definition_uri
definition_sourcestring optionalWorkflow definition content: a local ZIP file path, S3 URI (s3://bucket/key.zip), or base64-encoded ZIP content. Cannot be used together with definition_uri or definition_repository.
definition_uristring optionalS3 URI of the workflow definition ZIP file. Cannot be used together with definition_source or definition_repository
definition_zip_base64string optional[Deprecated: use definition_source] Base64-encoded workflow definition ZIP file.
descriptionstring optionalOptional description of the workflow
enginestring optionalWorkflow engine type (WDL, NEXTFLOW, CWL, WDL_LENIENT). WDL_LENIENT allows for some WDL directives that don't strictly meet the WDL spec and can be useful when migrating legacy workflows designed to run on Cromwell
parameter_templatestring optionalOptional parameter template for the workflow
parameter_template_pathstring optionalPath to parameter template JSON file within the repository (only valid with definition_repository)
path_to_mainstring optionalPath to the main file in the workflow definition ZIP file. Not required if there is a top level main.wdl, main.cwl or main.nf files in the workflow package. Not required if there is only a single top level workflow file.
readmestring optionalREADME documentation: markdown content, local .md file path, or S3 URI (s3://bucket/key)
readme_pathstring optionalPath to README markdown file within the repository (only valid with definition_repository)
storage_capacitystring optionalDefault static storage capacity in GiB for workflow runs (required when storage_type is STATIC)
storage_typestring optionalStorage type for workflow runs (STATIC or DYNAMIC)
tagsstring optionalTags to apply to the workflow as a dict or JSON string, e.g. {"key": "value"}
workflow_bucket_owner_idstring optionalExpected AWS account ID of the S3 bucket owner for definition URI validation

⁠Tool: CreateAHOWorkflowVersion

Create a new version of an existing workflow.

ParametersTypeDescription
version_namestringName for the new version
workflow_idstringID of the workflow
acceleratorsstring optionalComputational accelerator type (GPU). Currently unused by the HealthOmics service. Reserved for future support.
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
container_registry_mapstring optionalOptional container registry map with registryMappings (upstreamRegistryUrl, ecrRepositoryPrefix, upstreamRepositoryPrefix, ecrAccountId) and imageMappings (sourceImage, destinationImage) arrays
container_registry_map_uristring optionalOptional S3 URI pointing to a JSON file containing container registry mappings. Cannot be used together with container_registry_map
definition_repositorystring optionalGit repository configuration with connection_arn, full_repository_id, source_reference (type and value), and optional exclude_file_patterns. Cannot be used together with definition_source or definition_uri
definition_sourcestring optionalWorkflow definition content: a local ZIP file path, S3 URI (s3://bucket/key.zip), or base64-encoded ZIP content. Cannot be used together with definition_uri or definition_repository.
definition_uristring optionalS3 URI of the workflow definition ZIP file. Cannot be used together with definition_source or definition_repository
definition_zip_base64string optional[Deprecated: use definition_source] Base64-encoded workflow definition ZIP file.
descriptionstring optionalOptional description of the workflow version
enginestring optionalWorkflow engine type (WDL, NEXTFLOW, CWL, WDL_LENIENT). WDL_LENIENT allows for some WDL directives that don't strictly meet the WDL spec and can be useful when migrating legacy workflows designed to run on Cromwell
parameter_templatestring optionalOptional parameter template for the workflow
parameter_template_pathstring optionalPath to parameter template JSON file within the repository (only valid with definition_repository)
path_to_mainstring optionalPath to the main file in the workflow definition ZIP file. Not required if there is a top level main.wdl, main.cwl or main.nf files in the workflow package. Not required if there is only a single top level workflow file.
readmestring optionalREADME documentation: markdown content, local .md file path, or S3 URI (s3://bucket/key)
readme_pathstring optionalPath to README markdown file within the repository (only valid with definition_repository)
storage_capacitystring optionalStorage capacity in GB (required for STATIC)
storage_typestring optionalStorage type (STATIC or DYNAMIC)
tagsstring optionalTags to apply to the workflow version as a dict or JSON string, e.g. {"key": "value"}
workflow_bucket_owner_idstring optionalExpected AWS account ID of the S3 bucket owner for definition URI validation

⁠Tool: CreateCodeConnection

Create a new CodeConnection.

This function creates a new AWS CodeConnection for connecting to a third-party Git provider. The connection will be created in PENDING status and requires OAuth authorization in the AWS Console to become AVAILABLE.

ParametersTypeDescription
connection_namestringName for the new connection
provider_typestringGit provider type: Bitbucket, GitHub, GitHubEnterpriseServer, GitLab, GitLabSelfManaged
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
tagsstring optionalOptional tags to apply to the connection

⁠Tool: CreateContainerRegistryMap

Create a container registry map for HealthOmics workflows.

Creates a container registry map file that can be used when creating HealthOmics workflows. Registry mappings allow workflows to use container images from upstream registries (Docker Hub, Quay.io, ECR Public) without modifying the workflow definition. The mappings redirect container pulls to your private ECR pull-through caches.

By default, this tool discovers all HealthOmics-usable pull-through cache rules in your ECR registry and creates mappings for them. You can also provide additional registry mappings or specific image mappings for container overrides.

ParametersTypeDescription
additional_registry_mappingsstring optionalAdditional registry mappings to include beyond discovered pull-through caches. Each mapping has 'upstreamRegistryUrl' and 'ecrRepositoryPrefix'.
aws_profilestring optionalAWS profile name for this operation. Overrides the default credential chain.
aws_regionstring optionalAWS region for this operation. Overrides the server default.
ecr_account_idstring optionalAWS account ID for ECR repositories. If not provided, uses the current AWS account.
ecr_regionstring optionalAWS region for ECR repositories. If not provided, uses the current configured region.
image_mappingsstring optionalList of specific image mappings for container overrides. Each mapping has 'sourceImage' and 'destinationImage'. These take precedence over registry mappings.
include_pull_through_cachesboolean optionalIf true, automatically discovers HealthOmics-usable ECR pull-through cache rules and creates registry mappings for them.
output_formatstring optionalOutput format: 'json' for raw JSON string, 'dict' for Python dictionary

⁠Tool: CreatePullThroughCacheForHealthOmics

Create a pull-through cache rule configured for HealthOmics.

Creates an ECR pull-through cache rule for the specified upstream registry and configures the necessary permissions for HealthOmics to use it. This includes:

  1. Creating the pull-through cache rule
  2. Updating the registry permissions policy to allow HealthOmics to create repositories and import images
  3. Creating a repository creation template that grants HealthOmics the required permissions to pull images Parameters|Type|Description -|-|- upstream_registry|string|Upstream registry type: docker-hub, quay, or ecr-public aws_profile|string optional|AWS profile name for this operation. Overrides the default credential chain. aws_region|string optional|AWS region for this operation. Overrides the server default.

[...]

Install from MCP:Hub

Tag summary

Content type

Image

Digest

sha256:ec0cd4776…

Size

209.7 MB

Last updated

4 months ago

docker pull mcp/aws-healthomics-mcp-server

This week's pulls

Pulls:

122

Last week