MCP Server Integration

Connect SOFE to any AI agent (Kiro, Claude, Cursor, Windsurf) via the Model Context Protocol. Your agent can query findings, costs, and remediation directly.

🌊 Endpoint: mcp.sofe.dev

6 tools • MCP Protocol 2024-11-05 • SSE transport

Quick Setup

Kiro CLI

Add to your ~/.kiro/agents/aws-mcp.json or project .kiro/settings/mcp.json:

{
  "mcpServers": {
    "sofe": {
      "url": "https://mcp.sofe.dev/sse?key=sk_sofe_YOUR_KEY"
    }
  }
}

Claude Code / Claude Desktop

{
  "mcpServers": {
    "sofe": {
      "url": "https://mcp.sofe.dev/sse",
      "headers": {
        "X-SOFE-Key": "sk_sofe_YOUR_KEY"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings (Settings → MCP Servers → Add):

URL:    https://mcp.sofe.dev/sse
Header: X-SOFE-Key: sk_sofe_YOUR_KEY

Get Your API Key

  1. Go to platform.sofe.dev/keys
  2. Click "Generate New Key"
  3. Copy the sk_sofe_... key (shown once)
  4. Paste into your MCP config above

Available Tools

sofe_get_findings

Get FinOps findings from latest evaluation. Filter by severity or resource type.

sofe_get_costs

Get AWS cost breakdown by service with monthly totals.

sofe_get_remediation

Get exact AWS CLI commands to fix findings. Copy-paste ready.

sofe_compare_evaluations

Compare latest vs previous: new findings, fixed, trend.

sofe_get_insights

Architecture insights: SPOFs, blast radius, relationships.

sofe_run_evaluation

Trigger a new evaluation on connected AWS account (Pro only).

Example Usage

Once connected, ask your AI agent:

> "What are my critical AWS findings?"
  → Agent calls sofe_get_findings(severity="critical")
  → Returns real findings from your latest evaluation

> "Give me commands to fix my Lambda issues"
  → Agent calls sofe_get_remediation(resource_type="lambda")
  → Returns copy-paste AWS CLI commands

> "Is my account improving?"
  → Agent calls sofe_compare_evaluations()
  → Returns trend (IMPROVING/STABLE/DEGRADING)

Rate Limits

TierTool calls/dayCredits per call
Free101
Pro1,000—
EnterpriseUnlimited—

Verify Connection

Test with curl:

# Health check
curl https://mcp.sofe.dev/health

# List tools
curl -X POST https://mcp.sofe.dev/messages?key=sk_sofe_YOUR_KEY \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":1}'

💡 Tip: The MCP server uses the same API keys as api.sofe.dev. If your key works for evaluations, it works for MCP.