English Français العربية

com.undercurrentholdings/aegis

Official registry Other

Local stdio MCP server for the AEGIS governance client. The hosted evaluation service is offline.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package aegis-governance
Claude Code 
claude mcp add aegis -e 'AEGIS_API_KEY=<your aegis_api_key>' -- aegis-mcp-server aegis-governance==1.4.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "aegis": {
            "command": "aegis-mcp-server",
            "args": [
                "aegis-governance==1.4.2"
            ],
            "env": {
                "AEGIS_API_KEY": "<your aegis_api_key>"
            }
        }
    }
}

Environment variables

  • AEGIS_API_KEY secret API key for the hosted AEGIS API. The hosted service is offline, so tool calls do not return evaluations. See https://undercurrentholdings.com/status/

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. AEGIS Governance — MCP Server
  2. What the package is
  3. Install
  4. Local stdio MCP configuration
  5. Tools
  6. Reading the source

AEGIS Governance — MCP Server

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/

What the package is

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.

Install

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.

Local stdio MCP configuration

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

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.

ToolDescription (quoted from the server)
aegis_evaluate_proposalEvaluate an engineering proposal through the AEGIS gate checks.
aegis_quick_risk_checkQuick risk threshold check without a full Bayesian evaluation.
aegis_healthCheck AEGIS API health (service status, version, components).
aegis_list_decisionsList recent governance decisions for the authenticated customer.
aegis_get_decisionFetch a specific governance decision by ID, with full gate detail.
aegis_get_usageGet the authenticated customer's evaluation usage report.

Reading the source

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.

Frequently asked questions

What is com.undercurrentholdings/aegis?

Local stdio MCP server for the AEGIS governance client. The hosted evaluation service is offline.

How do I install com.undercurrentholdings/aegis?

It runs on your machine. In Claude Code: claude mcp add aegis -e 'AEGIS_API_KEY=<your aegis_api_key>' -- aegis-mcp-server aegis-governance==1.4.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.undercurrentholdings/aegis need an API key?

Yes. It expects AEGIS_API_KEY, which you set in its configuration.

Is com.undercurrentholdings/aegis open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.undercurrentholdings/aegis?

It is published by undercurrentai. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.