Registry /
aws / awslabs-aws-documentation-mcp-server
Install & Compatibility
Where this runs
tested against v1.2.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.9
✕ build_error
✕ build_error
76MB installed
● package 76MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Server Execution
✓ python -m awslabs.aws_documentation_mcp_server.server
This library is designed to run as a server process, typically invoked as a module from the command line or configured by an MCP client, rather than being imported directly into user-written Python code for its core server functionality.
This quickstart demonstrates how to run the AWS Documentation MCP Server as a Python module. Before running, ensure you have Python 3.10+ installed and your AWS CLI credentials are configured (e.g., `aws configure`). The server will use these credentials to interact with AWS services for documentation retrieval. Once running, it can be integrated with compatible MCP clients like Amazon Q Developer, Kiro, or Cursor.
import os
import subprocess
import sys
# Configure AWS credentials (replace with your actual region/profile or ensure they are set in your environment)
os.environ['AWS_PROFILE'] = os.environ.get('AWS_PROFILE', 'default') # Use 'default' profile or env var
os.environ['AWS_REGION'] = os.environ.get('AWS_REGION', 'us-east-1') # Use 'us-east-1' or env var
print(f"Starting AWS Documentation MCP Server using profile: {os.environ['AWS_PROFILE']} in region: {os.environ['AWS_REGION']}")
print("Ensure your AWS credentials are configured (e.g., via `aws configure` or environment variables).")
print("The server will run until interrupted (Ctrl+C).")
try:
# Run the MCP server as a module
process = subprocess.run(
[sys.executable, "-m", "awslabs.aws_documentation_mcp_server.server"],
check=True
)
except subprocess.CalledProcessError as e:
print(f"Error starting server: {e}")
sys.exit(1)
except KeyboardInterrupt:
print("\nServer stopped by user.")
sys.exit(0)
Debug
Known issues
breakingServer-Sent Events (SSE) support was removed from all MCP servers in their latest major versions as of May 26, 2025. Applications that still rely on SSE for client-server communication must use previous major versions of the respective MCP server until they can migrate to alternative transport methods.fixMigrate client applications to use Streamable HTTP transport or other supported communication methods, or explicitly pin to an older major version of the server that still includes SSE support.
affects: All major versions released after 2025-05-26
gotchaThe server requires AWS credentials to function, typically picked up from the default AWS CLI profile or `AWS_PROFILE` environment variable. It also runs in read-only mode by default, restricting operations to only perform read actions. Write-access (for mutating operations like `sam_deploy`) requires explicit configuration (e.g., `enable_write_access_mode`).fixEnsure AWS CLI is installed and configured (`aws configure` or `aws login`). Set `AWS_PROFILE` and `AWS_REGION` environment variables as needed. If write operations are required, consult the server's documentation for enabling write access mode.
affects: All versions
gotchaThe library explicitly requires Python 3.10 or newer. Attempting to run it with older Python versions will result in execution errors.fixUpgrade your Python environment to version 3.10 or higher.
affects: < 1.0.0 (and potentially others, but confirmed for current version)
gotchaRunning multiple AWS-related MCP servers (e.g., `aws-api-mcp-server`, `aws-knowledge-mcp-server`) concurrently in the same MCP client configuration can lead to tool conflicts, ambiguous responses for AI agents, and reduced performance. It's recommended to remove conflicting server entries.fixReview your MCP client's configuration file (e.g., `~/.kiro/settings/mcp.json`, `~/.aws/amazonq/mcp.json`) and remove any entries for other AWS MCP servers that might overlap in functionality with the AWS Documentation MCP Server.
affects: All versions
Upgrade
Version history
1.2.0latest on PyPI · released Aug 26, 2026
Audit
Dependencies
PythonrequiredRequires Python 3.10 or newer for execution.
uvoptionalRecommended tool for environment and dependency management during development and for `uvx` based client configurations, though not strictly required for `pip install`.
AWS CLIrequiredRequired for configuring AWS credentials, which the server uses to authenticate requests to AWS services (e.g., for search APIs).