
If you're building agents that do anything consequential, this gives them a decision checkpoint they can call before acting. It runs six quantitative gates (risk, profit, novelty, complexity, quality, utility) and returns PROCEED, PAUSE, HALT, or ESCALATE with scored rationale. The real win is the hash-chained audit trail: every decision gets a tamper-evident log entry you can hand to compliance. Works locally in sandbox mode with no signup, or connect to the hosted server for full history and verification tools. Designed for NIST AI RMF and EU AI Act artifact generation, so it's aimed at regulated environments where "the agent did it" isn't documentation.
Status: the hosted AEGIS service is offline (since September 2026). The hosted API and the hosted MCP endpoint (
mcp.aegis.undercurrentholdings.com) are offline. The local server does not evaluate proposals itself, so no tool returns an evaluation at this time. Current status: https://undercurrentholdings.com/status/
aegis-governance on PyPI is a Python client for the AEGIS API. It also contains a local
MCP server. The package installs one console script, aegis-mcp-server. This script starts
a local MCP server that uses the stdio transport. The package has no other command-line tool.
The local server has no evaluation engine. By default, the client sends all requests to the hosted AEGIS API. Sandbox mode (the mode without an API key) also uses the hosted API. While the hosted service is offline, tool calls do not return evaluations.
pip install "aegis-governance[mcp]"
The [mcp] extra is necessary for aegis-mcp-server. On Python < 3.10, the extra installs
nothing, and aegis-mcp-server exits with an install hint.
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" }
}
}
tools/list from aegis-mcp-server in aegis-governance 1.4.2 returns these six tools.
Without AEGIS_API_KEY, aegis_evaluate_proposal and aegis_health call the hosted API, and
the other four tools return an AuthenticationError JSON result without an API call. With
AEGIS_API_KEY set, all six tools call the hosted API.
The descriptions below are quoted from the server. They do not describe a service that is available now.
| Tool | Description (quoted from the server) |
|---|---|
aegis_evaluate_proposal | Evaluate an engineering proposal through the AEGIS gate checks. |
aegis_quick_risk_check | Quick risk threshold check without a full Bayesian evaluation. |
aegis_health | Check AEGIS API health (service status, version, components). |
aegis_list_decisions | List recent governance decisions for the authenticated customer. |
aegis_get_decision | Fetch a specific governance decision by ID, with full gate detail. |
aegis_get_usage | Get the authenticated customer's evaluation usage report. |
The aegis-governance source repository is private. To read the published source, download
the source distribution (sdist) from PyPI:
pip download --no-binary :all: --no-deps "aegis-governance==1.4.2"
Or get the .tar.gz file from the PyPI release files.