What is AWS Support MCP Server?
AWS Support MCP Server is an MCP-compliant server that allows AI tools, coding assistants, or custom workflow engines to seamlessly interact with AWS Support services. It exposes functions for case creation, status tracking, and management—enabling programmatic or AI-driven support operations securely, without leaving your local development environment or chat interface. This streamlines the process of getting help on AWS, making support case management accessible to developers and AI agents alike.
How to Configure AWS Support MCP Server
-
Installation
- Install
uv
from Astral. - Install Python 3.10+ if you haven't already.
- Ensure your environment has AWS credentials with required permissions for AWS Support operations.
- Pull or install the MCP server package (
awslabs.aws-support-mcp-server
) viauvx
or as a Docker container.
- Install
-
Client Configuration
- Add an entry in your MCP client configuration (e.g.,
mcp.json
) similar to:{ "awslabs.aws-support-mcp-server": { "command": "uvx", "args": ["awslabs.aws-support-mcp-server@latest"], "env": { "AWS_PROFILE": "your-aws-profile", "AWS_REGION": "us-east-1", "FASTMCP_LOG_LEVEL": "ERROR" } } }
- If running in Docker, configure AWS credentials via environment variables or by mounting the
.aws
directory.
- Add an entry in your MCP client configuration (e.g.,
-
IDE or Assistant Integration
- Supported platforms: Amazon Q CLI, Cursor, Cline, VS Code, Windsurf, and others.
- Refer to your tool's documentation for specifics about adding a custom MCP server.
How to Use AWS Support MCP Server
- Discover Tools
- Use the
tools/list
endpoint or your assistant's UI to view available support operations (e.g.,list_support_cases
,create_support_case
,update_support_case
).
- Use the
- Create a Support Case
- Use your AI assistant or MCP client to invoke the support case creation tool, providing details like issue type, subject, and description.
- Example prompt: "Create a high-severity case for an EC2 outage."
- Query and Manage Cases
- Use tools for listing open cases, fetching case details, or updating case correspondences.
- Example prompt: "Show me all open support cases in my account."
- Example prompt: "Add a comment to support case #123456789."
- Monitor Status
- Check the progress of ongoing cases within your IDE, chat interface, or automated workflow.
Key Features
- Natural Language Orchestration: Enables AI assistants and agents to handle support interactions comprehensively and directly within your tools.
- Automated Case Management: Create, list, update, and monitor AWS Support cases programmatically or through natural language requests.
- Secure and Local: Keep credentials and support information local (when running the server locally), with strict security.
- Works Everywhere: Integrates with popular IDEs, coding assistants, and conversational UIs via standard MCP configuration.
- Up-to-date Support Workflows: Maps directly to the AWS Support API, ensuring access to latest case types, categories, and fields.
- Best Practices: Minimizes manual effort, reduces errors, and seamlessly pulls necessary context from environment, codebase, or previous operations.
Use Cases
- AI-assisted Incident Response: Prompt an AI to file a support ticket the moment a critical CloudWatch alarm fires.
- DevOps & SRE Automation: Integrate support case actions into deployment pipelines or monitoring dashboards for rapid issue escalation.
- Conversational Troubleshooting: Use a chat-based assistant to search current cases, open new ones, or update ticket threads without leaving your code editor.
- Onboarding and Guidance: Help new developers file or check on AWS support queries directly from their IDE, with contextual help and validation.
- Audit and Reporting: Programmatically export support case histories for compliance or reporting.
FAQ
Q1: What permissions does the AWS Support MCP Server require?
A1: The server needs AWS credentials with appropriate IAM permissions for AWS Support APIs (support:*Support*
). Attach the "AWSSupportAccess" policy for full functionality.
Q2: Can I run the AWS Support MCP Server locally for privacy?
A2: Yes, running the server locally ensures all support interactions and credentials remain on your machine; no support case data leaves your environment except to AWS over the secure API.
Q3: Does the AWS Support MCP Server handle all AWS Support plans?
A3: Some AWS Support APIs (such as create support case) require a Business or Enterprise support plan. Please check your account's support plan or use the tool to query current plan info.
Q4: Can I use the AWS Support MCP Server in my automated pipelines?
A4: Absolutely. You can invoke its endpoints or integrate it into your CI/CD or monitoring workflows, allowing for event-driven case creation and management by agents or scripts.
Q5: How do I ensure only authorized users create or view support cases?
A5: Enforce security at the IAM role or profile level. Each invocation uses the credentials of the user or role running the server. You can further limit actions via standard AWS IAM policies.