How do I install the aws sage mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `AWS_PROFILE`, `AWS_DEFAULT_REGION`, `AWS_SAGE_LOCALSTACK_HOST` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Aws Sage MCP Server

A production-grade [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for AWS. Connect AI assistants to your AWS infrastructure

Local serverstdioPython

What is the Aws Sage MCP Server?

A production-grade Model Context Protocol (MCP) server for AWS. Connect AI assistants to your AWS infrastructure and manage it

What it needs from you

Python 3.11+ - AWS credentials configured (~/.aws/credentials or ~/.aws/config) - Any MCP-compatible client (see Compatible Clients above)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
list_profiles	List available AWS profiles
select_profile	Select and authenticate with a profile
get_account_info	Show current account ID, region, identity
set_safety_mode	Switch between READ_ONLY, STANDARD, UNRESTRICTED
aws_query	Natural language AWS queries
validate_operation	Check if an operation is valid without executing
aws_execute	Execute validated AWS operations
get_context	View conversation context and recent resources
set_alias	Create shortcuts for resources (e.g., "prod-db")
list_aliases	View all defined aliases
discover_resources	Find resources by tags across all services
map_dependencies	Show what a resource depends on
impact_analysis	Predict what breaks if you modify/delete something
investigate_incident	Automated incident investigation workflows
search_docs	Search AWS documentation
get_aws_knowledge	Query built-in AWS knowledge base
get_best_practices	Get service-specific best practices
get_service_limits	Show default service quotas
find_idle_resources	Find unused EC2/RDS/EBS/EIP resources
get_rightsizing_recommendations	Get EC2 right-sizing suggestions
get_cost_breakdown	Spending analysis by service/tag
project_costs	Estimate costs before deployment
list_environments	List configured environments (production/localstack)
switch_environment	Switch between LocalStack and production
get_environment_info	Current environment details
check_localstack	Verify LocalStack connectivity
compare_environments	Diff resources between environments
assume_role	Assume role in another account via STS
list_accounts	Show configured accounts
switch_account	Change active account context

How to install the Aws Sage MCP Server

{
  "mcpServers": {
    "aws-sage": {
      "command": "/path/to/python3",
      "args": [
        "-m",
        "aws_sage.server"
      ],
      "env": {
        "AWS_PROFILE": "default"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Python 3.11+ - AWS credentials configured (~/.aws/credentials or ~/.aws/config) - Any MCP-compatible client (see Compatible Clients above)

Variable	Description	Required
AWS_PROFILE	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Aws Sage to Prerequisites.”
“Use Aws Sage to Cursor.”
“Use Aws Sage to Windsurf.”

Frequently asked questions

A production-grade [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for AWS. Connect AI assistants to your AWS infrastructure and manage it Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.