AWS Support MCP Server

A Model Context Protocol (MCP) server implementation for interacting with the AWS Support API. This server enables AI assistants to create and manage AWS support cases programmatically.

Features

Create and manage AWS support cases
Retrieve case information and communications
Add communications to existing cases
Resolve support cases
Determine appropriate Issue Type, Service Code, and Category Code
Determine appropriate Severity Level for a case

Requirements

Python 3.7+
AWS credentials with Support API access
Business, Enterprise On-Ramp, or Enterprise Support plan

Prerequisites

Install uv from Astral or the GitHub README
Install Python using uv python install 3.10

Installation

Configure the MCP server in your MCP client configuration (e.g., for Amazon Q Developer CLI, edit ~/.aws/amazonq/mcp.json):


{
   "mcpServers": {
      "awslabs_support_mcp_server": {
         "command": "uvx",
         "args": [
            "-m", "awslabs.aws-support-mcp-server@latest",
            "--debug",
            "--log-file",
            "./logs/mcp_support_server.log"
         ],
         "env": {
            "AWS_PROFILE": "your-aws-profile"
         }
      }
   }
}

Alternatively:



uv pip install -e .
uv run awslabs/aws_support_mcp_server/server.py

{
   "mcpServers": {
      "awslabs_support_mcp_server": {
         "command": "path-to-python",
         "args": [
            "-m",
            "awslabs.aws_support_mcp_server.server",
            "--debug",
            "--log-file",
            "./logs/mcp_support_server.log"
         ],
         "env": {
            "AWS_PROFILE": "manual_enterprise"
         }
      }
   }
}

Usage

Start the server:

python -m awslabs.aws_support_mcp_server.server [options]

Options:

--port PORT: Port to run the server on (default: 8888)
--debug: Enable debug logging
--log-file: Where to save the log file

Configuration

The server can be configured using environment variables:

AWS_REGION: AWS region (default: us-east-1)
AWS_PROFILE: AWS credentials profile name

Documentation

For detailed documentation on available tools and resources, see the API Documentation.

License

Licensed under the Apache License, Version 2.0 (the "License").

AWS Support MCP Server