MCP Integration

Cloud Guardian includes a Model Context Protocol (MCP) server that enables Claude Code and other MCP-compatible AI assistants to interact with your cloud infrastructure.

What is MCP?

The Model Context Protocol is a standard for connecting AI assistants to external tools and data sources. Cloud Guardian's MCP server exposes 70+ tools for managing organizations, scanning infrastructure, viewing costs, and executing remediation.

Quick Setup

Add to your .mcp.json at the project root:

{
  "mcpServers": {
    "cloud-guardian": {
      "command": "bash",
      "args": ["-c", "cd services && exec go run ./cmd/mcp"]
    }
  }
}

Then authenticate:

> Use the cg_login tool to authenticate

This opens a browser window for Google Sign-In. Tokens are stored securely at ~/.config/cloud-guardian/auth.json.

Tool Categories

| Category | Tools | Description | |----------|-------|-------------| | Auth | cg_login, cg_whoami | Authentication and identity | | Organizations | cg_list_organizations, cg_create_organization, etc. | Org management | | Projects | cg_get_project_status, cg_list_org_projects, etc. | Project management | | Infrastructure | cg_get_infrastructure_status, cg_list_checks, etc. | Infrastructure scanning | | Costs | cg_get_cost_trend, cg_get_cost_breakdown, etc. | Cost analysis | | Remediation | cg_plan_remediation, cg_execute_remediation, etc. | Fix violations | | Alerts | cg_list_cost_alerts, cg_acknowledge_cost_alert | Alert management | | API Keys | cg_create_api_key, cg_list_api_keys, cg_revoke_api_key | Programmatic access | | Ops | cg_trigger_scan, cg_get_operational_health | Operations |

Next Steps