Skip to content

MCP server

AWS MCP server

The AWS API MCP server from AWS Labs lets AI run AWS CLI commands, suggest commands and plan changes, with read-only and consent modes.

At a glance

Maintained by
AWS Labs (Amazon Web Services)
Tools exposed
3 listed below
Reviewed
September 24, 2026

Why it matters

What it does and why it matters

AWS runs a large share of business infrastructure. The AWS API MCP server, from AWS Labs, gives an assistant three tools: run AWS CLI commands, suggest the right commands for a task and produce an execution plan. That covers almost any AWS service, from listing resources to reading logs and, if allowed, making changes.

AWS now also offers a managed AWS MCP Server, generally available since May 2026, and its repository recommends it first for many uses. The API server remains useful for teams that want to run it themselves.

Two settings matter most. Read-only mode blocks any change, and consent mode asks for confirmation before each write. We use read-only mode by default, with a dedicated IAM role that has minimal permissions, and never connect admin credentials.

Use cases

Best business use cases

Resource inventory

List what is running in each region.

Incident help

Read logs and metrics during an incident.

Cost questions

Find unused resources that cost money.

Security checks

Review settings against good practice. See compliance monitoring.

Command help

Get the right CLI command for a task.

Tools

Available tools

Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.

The AWS API server only exposes three tools; call_aws reaches almost every AWS API through the CLI.

Read and write: Read and write across AWS APIs. Set READ_OPERATIONS_ONLY=true for read-only, or REQUIRE_MUTATION_CONSENT=true to confirm each write.

  • call_aws

    Run a validated AWS CLI command and return the result.

  • suggest_aws_commands

    Suggest AWS CLI commands from a plain-language request.

  • get_execution_plan

    Experimental. Give step-by-step guidance for complex AWS tasks.

Workflows

Example workflows

Find idle resources

  1. 1

    Connect in read-only mode.

  2. 2

    Ask for stopped instances and unattached volumes.

  3. 3

    The assistant runs list commands.

  4. 4

    It totals likely monthly cost.

  5. 5

    An engineer decides what to remove.

Plan a change safely

  1. 1

    Describe the change.

  2. 2

    The assistant produces an execution plan.

  3. 3

    An engineer reviews it.

  4. 4

    With consent mode on, each write is confirmed.

  5. 5

    The change is logged in CloudTrail.

Prompts

Example prompts

  • “List EC2 instances in us-east-1 that have been stopped for over 30 days.”

  • “Which S3 buckets allow public access?”

  • “Show me the plan to add a tag to all production instances, but do not run it.”

Setup

Installation and configuration

Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.

Claude Desktop: claude_desktop_config.json

{
    "mcpServers": {
        "awslabs.aws-api-mcp-server": {
            "command": "uvx",
            "args": [
                "awslabs.aws-api-mcp-server@latest"
            ],
            "env": {
                "AWS_REGION": "us-east-1"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

Claude Code: terminal

claude mcp add awslabs-aws-api-mcp-server -e AWS_REGION=us-east-1 -- uvx awslabs.aws-api-mcp-server@latest
  • Hosted server: Self-deploy to Amazon Bedrock AgentCore (see DEPLOYMENT.md). AWS also runs a managed AWS MCP Server (preview) at https://aws-mcp.us-east-1.api.aws/mcp..
  • Local server: PyPI: awslabs.aws-api-mcp-server (run with uvx, stdio).
  • Needs: Standard AWS credentials (profile via AWS_API_MCP_PROFILE_NAME, or default credential chain). IAM permissions limit what it can do..

Security

Security considerations

  • Read-only first

    Start with read access and add actions only for reviewed tasks.

  • Scoped credentials

    Use a dedicated role or token with the least access, never an owner or admin key.

  • Separate environments

    Keep production changes out of assistant sessions, or require approval for them.

  • Audit

    Use AWS CloudTrail to review every call.

Related servers

Servers that pair well with it

AWS S3

Amazon S3 is handled through the managed AWS MCP Server, which lets AI run scripted AWS actions, create presigned links and search AWS docs.

Azure

Microsoft's Azure MCP server lets AI work with many Azure services, from storage and Key Vault to SQL, monitoring and AKS, with a read-only mode.

Google Cloud

Google's gcloud MCP servers let AI run gcloud commands, read logs, metrics, alerts and traces, and work with Cloud Storage.

Keep exploring

FAQ

Questions people ask us

Have a question that is not here? Ask us directly.

Start a project

Want this connected to your own systems? We build AI workflows with MCP.

Send a short brief. We reply with questions, a suggested plan and an estimate you can compare with other offers.

Your privacy choices

We use necessary storage to run this site. With your permission we also use Google Analytics to see which pages help people, and load maps from Google. You can change this at any time. Read the cookie policy.