AEGIS Governance MCP Server

Six-gate governance for AI agents: PROCEED/PAUSE/HALT decisions with hash-chained audit trails.

Documentation

AEGIS Governance — MCP Server

Quantitative governance for AI agents and engineering decisions. AEGIS evaluates proposals through six quantitative gates — Risk, Profit, Novelty, Complexity, Quality, Utility — and returns a structured decision (PROCEED / PAUSE / HALT / ESCALATE) with confidence scores, rationale, and a hash-chained audit trail.

Give your agent a decision gate it can call before it acts — and an audit record compliance can actually read (NIST AI RMF, EU AI Act Annex IV).

Works immediately, no signup: the local server runs in sandbox mode (10 evaluations/day).
6 local tools (evaluations, risk checks, health, decision history, usage) — 10 on the hosted server.
Hosted server with hash-chained audit trails — free Community tier (100 evaluations/month, no credit card).
Want to see it before connecting? Try the Advisor in your browser — no install, no signup.

Quickstart (local, no account needed)

pip install "aegis-governance[mcp]"

Claude Code

claude mcp add aegis -- aegis-mcp-server

Cursor (.cursor/mcp.json) / Windsurf / any stdio MCP client:

{
  "mcpServers": {
    "aegis": { "command": "aegis-mcp-server" }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "aegis": { "type": "stdio", "command": "aegis-mcp-server" }
  }
}

Runs in sandbox mode out of the box. Set AEGIS_API_KEY in the server's environment (free key) to unlock decision history, usage reports, and risk checks. Requires Python >= 3.10.

Hosted server (streamable-http, full 10-tool surface)

Get a free API key at portal.undercurrentholdings.com (GitHub/Google sign-in, key provisioned automatically), then:

Claude Code

claude mcp add --transport streamable-http aegis https://mcp.aegis.undercurrentholdings.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor (.cursor/mcp.json) / Windsurf / any streamable-http MCP client:

{
  "mcpServers": {
    "aegis": {
      "type": "streamable-http",
      "url": "https://mcp.aegis.undercurrentholdings.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "aegis": {
      "type": "http",
      "url": "https://mcp.aegis.undercurrentholdings.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Prefer a local SDK instead of MCP?

The Python SDK has a sandbox mode that works with no account at all (10 evaluations/day):

pip install aegis-governance

from aegis import Aegis

decision = Aegis().evaluate(
    proposal_summary="Add Redis caching layer to reduce API latency",
    risk_baseline=0.02, risk_proposed=0.05,
    novelty_score=0.75, complexity_score=0.8, quality_score=0.9,
)
print(decision.status)  # "proceed"

The local stdio MCP server above ships in aegis-governance >= 1.3.0 via the [mcp] extra.

Tools

Tool	What it does
`aegis_evaluate_proposal`	Full six-gate evaluation of a proposal; returns PROCEED/PAUSE/HALT/ESCALATE with per-gate scores and rationale
`aegis_quick_risk_check`	Fast risk screen for a proposed change
`aegis_check_thresholds`	Current gate threshold configuration
`aegis_get_scoring_guide`	Domain-specific guidance for deriving gate parameters (e.g. `cicd`)
`aegis_record_proposal`	Record a proposal for later verification
`aegis_list_proposals`	List recorded proposals
`aegis_verify_proposals`	Verify recorded proposals against outcomes
`aegis_list_decisions`	List past governance decisions
`aegis_get_decision`	Fetch a specific decision with full audit detail
`aegis_crypto_status`	Hash-chain audit integrity status

Why a governance gate?

AI agents make thousands of decisions with no record of why. AEGIS gives every consequential action a quantitative evaluation and a tamper-evident audit entry — so "the agent decided to deploy" becomes a signed, replayable record with gate scores and rationale.

Six gates: Risk, Profit, Novelty, Complexity, Quality, Utility — calibrated thresholds, KL-divergence drift detection
Audit-ready: hash-chained decision log; NIST AI RMF and EU AI Act Annex IV artifact generation
Five integration surfaces: MCP (this repo), Python SDK, REST API, CLI, GitHub Action

AEGIS Governance MCP Server

Documentation