AWS Support MCP Server

0.1.19 verified Fri May 01 auth: no python

An MCP server implementation that provides tools for interacting with the AWS Support API. It enables AI agents (like Claude Desktop) to create, describe, and manage AWS support cases. Current version 0.1.19, maintained by AWS Labs, released on a weekly/biweekly cadence.

pip install awslabs-aws-support-mcp-server

Common errors

error ModuleNotFoundError: No module named 'awslabs_aws_support_mcp_server' ↓

cause Package not installed or installed in wrong Python environment.

fix

Run pip install awslabs-aws-support-mcp-server in the correct environment. If using venv, activate it first.

error botocore.exceptions.ClientError: An error occurred (SubscriptionRequiredException) when calling the CreateCase operation: You must have a Business or Enterprise support plan to use the AWS Support API. ↓

cause The AWS account does not have an active Business or Enterprise support plan.

fix

Upgrade your AWS support plan to Business or Enterprise. See https://aws.amazon.com/premiumsupport/plans/

error TypeError: object NoneType can't be used in 'await' expression ↓

cause Attempting to use the server without an async context or misconfiguring the client.

fix

Ensure the server is run as an asyncio task. Use asyncio.run(main()) as shown in the quickstart.

Warnings

breaking Python >=3.10 required. The server uses async/await and type hints introduced in later Python versions. ↓

fix Ensure Python 3.10 or newer is installed. Check with `python --version`.

breaking AWS Support API is only available in certain regions (us-east-1, us-west-2, eu-west-1). The server defaults to us-east-1. ↓

fix Explicitly set AWS_REGION or AWS_DEFAULT_REGION environment variable to a supported region, or use `--region` CLI argument.

breaking The server requires permissions to call AWS Support API (support:*). The IAM policy must include these actions. ↓

fix Attach the AWS managed policy 'AWSSupportAccess' to the IAM role/user. Or create a custom policy with actions: support:CreateCase, support:DescribeCases, support:ResolveCase.

gotcha The server runs over stdio transport. Tools like Claude Desktop need to execute the Python script as a subprocess. ↓

fix Configure the MCP client to invoke `python path/to/server.py` or the installed entry point `aws-support-mcp-server`.

Install

pip install git+https://github.com/awslabs/aws-support-mcp-server.git

Imports

AwsSupportServer
```
from awslabs_aws_support_mcp_server import server as mcp_server
```
The server is typically started via CLI or as a module. Direct class import is not the standard pattern.

Quickstart

Run the MCP server as a standalone script. The server will listen for MCP requests over stdio. Requires AWS credentials configured (via environment variables, ~/.aws/credentials, or IAM role).

import asyncio
from awslabs_aws_support_mcp_server import server

async def main():
    await server.main()

if __name__ == "__main__":
    asyncio.run(main())