Skip to content
MCP server

Aegis

Credential isolation for AI agents. Inject secrets at the network boundary.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.5
Listing updated
6 days ago

About Aegis

Aegis is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add aegis --env AEGIS_MASTER_KEY='<AEGIS_MASTER_KEY>' --env AEGIS_SALT='<AEGIS_SALT>' -- npx -y @getaegis/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "aegis": {
      "command": "npx",
      "args": [
        "-y",
        "@getaegis/cli"
      ],
      "env": {
        "AEGIS_MASTER_KEY": "<AEGIS_MASTER_KEY>",
        "AEGIS_SALT": "<AEGIS_SALT>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aegis": {
      "command": "npx",
      "args": [
        "-y",
        "@getaegis/cli"
      ],
      "env": {
        "AEGIS_MASTER_KEY": "<AEGIS_MASTER_KEY>",
        "AEGIS_SALT": "<AEGIS_SALT>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "aegis": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getaegis/cli"
      ],
      "env": {
        "AEGIS_MASTER_KEY": "<AEGIS_MASTER_KEY>",
        "AEGIS_SALT": "<AEGIS_SALT>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aegis": {
      "command": "npx",
      "args": [
        "-y",
        "@getaegis/cli"
      ],
      "env": {
        "AEGIS_MASTER_KEY": "<AEGIS_MASTER_KEY>",
        "AEGIS_SALT": "<AEGIS_SALT>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aegis": {
      "command": "npx",
      "args": [
        "-y",
        "@getaegis/cli"
      ],
      "env": {
        "AEGIS_MASTER_KEY": "<AEGIS_MASTER_KEY>",
        "AEGIS_SALT": "<AEGIS_SALT>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • AEGIS_MASTER_KEYMaster encryption key for the credential vaultRequired
  • AEGIS_SALTHex-encoded 32-byte salt for key derivation (generated by aegis init)Required
  • AEGIS_DATA_DIRDirectory for vault databases and registry (default: .aegis/)
  • AEGIS_PORTGate proxy port (default: 3100)
  • AEGIS_LOG_LEVELLog verbosity: debug, info, warn, error (default: info)
  • AEGIS_LOG_FORMATLog output format: json or pretty (default: json)
  • AEGIS_VAULTNamed vault to use (default: default)
  • AEGIS_REQUIRE_AGENT_AUTHRequire agent authentication on every request (true/false, default: false)
  • AEGIS_POLICY_MODEPolicy enforcement mode: enforce, dry-run, or off (default: enforce)
  • AEGIS_POLICIES_DIRDirectory containing YAML policy files
  • AEGIS_METRICSEnable Prometheus metrics endpoint (true/false, default: true)

Pricing

Open source

Aegis FAQ

Is Aegis free?

Yes. Aegis is open source, so you can use and self-host it for free.

How do I add Aegis to Claude Code?

Run this command in your terminal: claude mcp add aegis --env AEGIS_MASTER_KEY='<AEGIS_MASTER_KEY>' --env AEGIS_SALT='<AEGIS_SALT>' -- npx -y @getaegis/cli

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers