aws-health-mcp-server

# AWS Health MCP Server > **Disclaimer:** This AWS content is provided subject to the terms of the AWS Customer Agreement available at https://aws.amazon.com/agreement or other written agreement between the Customer and Amazon Web Services. This is sample code for demonstration purposes only. It is not intended for production use. You should work with your security and legal teams to meet your organizational security, regulatory, and compliance requirements before any deployment. MCP server that exposes AWS Health API as tools. Works with Claude Desktop, Kiro or any MCP-compatible client. 📖 **Blog:** [Building an AWS Health MCP Server for Agentic Operations](https://medium.com/@jsanketh1799/building-an-aws-health-mcp-server-for-agentic-operations-cda234012e38) ## Prerequisites - Python 3.10+ - AWS credentials configured (`aws configure` or environment variables) - AWS **Business or Enterprise Support** plan (required for Health API) - For org-level tools: AWS Organizations with Health service access enabled ## Setup Add this to your MCP config file: - **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Kiro**: `~/.kiro/settings/mcp.json` - **Amazon Q CLI**: `~/.aws/amazonq/mcp.json` ### Using uvx from PyPI (recommended) ```json { "mcpServers": { "aws-health": { "command": "uvx", "args": ["aws-health-mcp-server"], "env": { "AWS_PROFILE": "default" } } } } ``` ### Using pip ```bash pip install aws-health-mcp-server ``` ### From a local clone ```json { "mcpServers": { "aws-health": { "command": "uv", "args": ["run", "--directory", "/path/to/aws-health-mcp-server", "aws-health-mcp-server"], "env": { "AWS_PROFILE": "default" } } } } ``` That's it. `uv` handles the venv and dependencies automatically. ## Tools ### Account-Level | Tool | Description | |------|-------------| | `get_service_health` | All active health events | | `g…