Karma MCP Server

Instructions

Implementation Reference

• src/karma_mcp/server.py:320-348 (handler)

  The `list_alerts` tool handler fetches alert data and formats it into a summary string.

  async def list_alerts() -> str:
      """List all active alerts in Karma"""
      data, error = await fetch_karma_alerts()
      if error:
          return error
  
      # Process alerts using utility functions
      total_alerts = 0
      alert_text = ""
  
      grids = data.get("grids", [])
      for grid in grids:
          for group in grid.get("alertGroups", []):
              alerts = group.get("alerts", [])
              total_alerts += len(alerts)
  
              for alert in alerts[:10]:  # Show max 10 alerts per group
                  metadata = extract_alert_metadata(group, alert)
  
                  alert_text += f"• {metadata['alertname']}\n"
                  alert_text += f"  Severity: {metadata['severity']}\n"
                  alert_text += f"  State: {metadata['state']}\n"
                  alert_text += f"  Namespace: {metadata['namespace']}\n\n"
  
      if total_alerts == 0:
          return "No active alerts"
  
      alert_text = f"Found {total_alerts} alerts:\n\n" + alert_text
      return alert_text