{"id":26762,"library":"awslabs-aws-support-mcp-server","title":"AWS Support MCP Server","description":"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.","status":"active","version":"0.1.19","language":"python","source_language":"en","source_url":"https://github.com/awslabs/aws-support-mcp-server","tags":["mcp","aws-support","claude","model-context-protocol","ai-agent"],"install":[{"cmd":"pip install awslabs-aws-support-mcp-server","lang":"bash","label":"Install from PyPI"},{"cmd":"pip install git+https://github.com/awslabs/aws-support-mcp-server.git","lang":"bash","label":"Install from GitHub"}],"dependencies":[{"reason":"AWS SDK for Python, used to call Support API.","package":"boto3","optional":false},{"reason":"Model Context Protocol server framework.","package":"mcp","optional":false}],"imports":[{"note":"The server is typically started via CLI or as a module. Direct class import is not the standard pattern.","wrong":"","symbol":"AwsSupportServer","correct":"from awslabs_aws_support_mcp_server import server as mcp_server"}],"quickstart":{"code":"import asyncio\nfrom awslabs_aws_support_mcp_server import server\n\nasync def main():\n    await server.main()\n\nif __name__ == \"__main__\":\n    asyncio.run(main())","lang":"python","description":"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)."},"warnings":[{"fix":"Ensure Python 3.10 or newer is installed. Check with `python --version`.","message":"Python >=3.10 required. The server uses async/await and type hints introduced in later Python versions.","severity":"breaking","affected_versions":"all"},{"fix":"Explicitly set AWS_REGION or AWS_DEFAULT_REGION environment variable to a supported region, or use `--region` CLI argument.","message":"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.","severity":"breaking","affected_versions":"all"},{"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.","message":"The server requires permissions to call AWS Support API (support:*). The IAM policy must include these actions.","severity":"breaking","affected_versions":"all"},{"fix":"Configure the MCP client to invoke `python path/to/server.py` or the installed entry point `aws-support-mcp-server`.","message":"The server runs over stdio transport. Tools like Claude Desktop need to execute the Python script as a subprocess.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install awslabs-aws-support-mcp-server` in the correct environment. If using venv, activate it first.","cause":"Package not installed or installed in wrong Python environment.","error":"ModuleNotFoundError: No module named 'awslabs_aws_support_mcp_server'"},{"fix":"Upgrade your AWS support plan to Business or Enterprise. See https://aws.amazon.com/premiumsupport/plans/","cause":"The AWS account does not have an active Business or Enterprise support plan.","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."},{"fix":"Ensure the server is run as an asyncio task. Use `asyncio.run(main())` as shown in the quickstart.","cause":"Attempting to use the server without an async context or misconfiguring the client.","error":"TypeError: object NoneType can't be used in 'await' expression"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}