cloud-agent-swarm
Provides tools for autonomous Kubernetes incident response, including running chaos scenarios such as pod OOM cascades, triggering swarm investigations, and retrieving generated SRE post-mortem reports.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
π― What is CloudAgentSwarm?
CloudAgentSwarm is an autonomous incident response platform where specialized AI agents collaborate to triage, investigate, contain, and remediate cloud infrastructure outages.
Instead of a single monolithic prompt, tasks are distributed across role-specific agents that analyze telemetry, evaluate blast radius, enforce safety guardrails, and execute remediation with rollback guarantees.
[Alert] βββΊ [Incident Commander] βββΊ [Telemetry Investigator]
β (Root Cause)
βΌ
[Safe Execution] βββ [Guardrails & HITL] βββ [Blast Radius Analyst]
β β
βΌ βΌ
[Post-Mortem] βββββββββββββββββββββββ [Remediation Planner]Related MCP server: devops-mcp-server
π€ Specialized Agents
Agent | Role | Focus |
Incident Commander | War Room Lead | Severity classification (SEV-1 to SEV-4) and consensus orchestration. |
Telemetry Investigator | Observability | Correlates CloudWatch metrics, PromQL queries, and pod logs to find root causes. |
Blast Radius Analyst | Safety & Security | Evaluates IAM privilege risks, VPC boundaries, and financial exposure. |
Remediation Planner | Site Reliability | Generates atomic remediation actions with deterministic rollback commands. |
π‘οΈ Safety & Guardrails
Hard Guardrails: Destructive operations (
drop_database,delete_vpc,destroy_kms_key) are blocked at policy level.Human-in-the-Loop (HITL): Actions with risk score $> 40.0$ or flagged as destructive mandate interactive human approval.
Rollback Guarantee: Every action requires a verified inverse rollback command before execution.
π Quick Start
1. Installation
git clone https://github.com/ekrmcakir/cloud-agent-swarm.git
cd cloud-agent-swarm
pip install -e .2. Run Chaos Simulations
# List available scenarios
cloud-swarm list-scenarios
# Run Kubernetes OOM cascade simulation
cloud-swarm simulate --scenario oom_cascade
# Run with JSON output
cloud-swarm simulate --scenario iam_key_leak --jsonπ Model Context Protocol (MCP)
CloudAgentSwarm runs as a native MCP stdio server, allowing Claude Desktop, Cursor, or Antigravity to trigger investigations:
{
"mcpServers": {
"cloud-agent-swarm": {
"command": "cloud-swarm",
"args": ["mcp"]
}
}
}Exposed Tools:
list_scenariosβ Lists runnable chaos outage scenarios.trigger_investigationβ Runs the swarm against an incident.get_postmortemβ Fetches the generated SRE post-mortem report.
π₯ Included Chaos Scenarios
oom_cascade(SEV-1): Kubernetes pod memory exhaustion (Exit code 137) triggering 502/504 errors.iam_key_leak(SEV-1): Leaked administrator IAM key with unauthorized S3 data scraping.dynamodb_throttling(SEV-2): Capacity burst exceeding provisioned RCU on hot partition.split_brain_partition(SEV-2): Transit Gateway route drop causing cross-AZ communication failure.
π§ͺ Testing
make test
# or
python3 -m unittest discover -s tests -p "test_*.py"π License
Apache 2.0 Β© 2026 Ekrem Cakir.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Autonomous and governed SRE & MLOps control plane for AI agent platforms.
MCP-native AI SRE: ask what's broken in production, get a reviewed GitHub fix PR.
Hosted MCP memory and agent control plane for durable conversations, jobs, and operations.
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables autonomous SRE incident investigation by allowing users to describe incidents in natural language. The agent follows a governed state machine to gather read-only evidence and produce grounded conclusions.MIT
- FlicenseNot gradedqualityDmaintenanceExposes DevOps/SRE operations like Kubernetes pod status, Prometheus metrics queries, and deploy history as tools for MCP-compatible clients.-
- FlicenseNot gradedqualityDmaintenanceProvides MCP tools to search engineering runbooks and historical incidents using semantic retrieval, supporting evidence-grounded incident investigation.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to investigate production incidents by exposing service health, logs, and deployment data through MCP tools.9 npmISC