AWS DATA SERVICES / AWS Labs
AWS Labs HealthOmics
Inspects genomic workflows and run diagnostics and can create or execute HealthOmics workflows and related resources.
“A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to AWS HealthOmics services for genomic workflow management, execution, and analysis.”
01 / THE REASONING
Why this made the selection.
- Specialized publisher integration with documented IAM and data access boundaries.
- Investigate a failed genomic workflow using run/task logs and bounded metrics.
- The catalogue does not already have src/aws-healthomics-mcp-server/README.md.
- The README names three transports, says an unset value selects stdio, and shows a shell install line that does not pass --transport.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- src/aws-healthomics-mcp-server/README.md
- src/aws-healthomics-mcp-server/pyproject.toml
- src/aws-healthomics-mcp-server/awslabs/aws_healthomics_mcp_server/server.py
- Root README.md and LICENSE
- LICENSE
Our findings
- All registrations pass through a pagination wrapper, but workflow and run writes are still registered. The server distinguishes ordinary credential resolution from explicitly configured multi-tenant execution.
- The transport section says the default is stdio, and that streamable-http and sse are the network transports. The table maps each name to a --transport flag and to MCP_TRANSPORT. An unset value selects stdio.
- The shell install line is uvx awslabs.aws-healthomics-mcp-server with no --transport flag. Multi-tenant mode requires streamable-http or sse, and the README says combining it with stdio makes the server exit.
- StartAHORun includes an optional inline IAM session policy to scope down the run role. The required-permission sample includes omics workflow and store actions and iam:PassRole on arn:aws:iam::*:role/HealthOmicsExecutionRole*.
Not established by this review
- Server startup, authentication, live tool execution and security isolation were not tested.
- Published package/container parity with a source revision and hosted implementation internals were not tested.
- The resource was not executed and its tools were not called.
- No HealthOmics or CloudWatch call was made.
- stdio, streamable-http, and sse were not opened.
- Multi-tenant mode was not started.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
uvx awslabs.aws-healthomics-mcp-server@latest Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- Configure AWS credentials for the intended account/region and an initial read-only investigation role.
- Use stdio and resolve the workflow/run/task IDs before retrieving bounded logs or metrics.
- Review input/output locations, workflow version, execution role and costs before any start/batch action; leave mock endpoint overrides unset.
Before you start
- Python 3.10 or newer, uv/uvx and an MCP client that can launch a local stdio process.
- An AWS account, configured credentials and access to the intended region and service resources.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"mcpServers": {
"awslabs-healthomics": {
"command": "uvx",
"args": [
"awslabs.aws-healthomics-mcp-server@latest"
],
"env": {
"AWS_PROFILE": "YOUR_RESTRICTED_PROFILE",
"AWS_REGION": "us-east-1",
"HEALTHOMICS_DEFAULT_MAX_RESULTS": "10"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/aws-healthomics-mcp-server/README.md
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/aws-healthomics-mcp-server/pyproject.toml
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/aws-healthomics-mcp-server/awslabs/aws_healthomics_mcp_server/server.py
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/README.md
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
- Applicable licence ↗Checked
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/LICENSE
Supports: license
- HealthOmics MCP README ↗Checked
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/aws-healthomics-mcp-server/README.md
Supports: stdio default and streamable-http and sse
- Repository LICENSE ↗Checked
https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/LICENSE
Supports: Apache License Version 2.0