Intelligent tool-call review system for AI agents
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"superego-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Superego MCP [](https://www.python.org/downloads/) [](LICENSE) [](https://github.com/astral-sh/ruff) [](http://mypy-lang.org/) Intelligent tool-call review system for AI agents ## Overview Superego MCP Server provides a configurable review system to AI agents to reduce the amount of manual approvals needed as well as provide automated guardrails against dangerous operations. It analyzes incoming tool calls against a set of rules and if no rule is matched it defers to another agent for review or escalation to a human. ## Features - **Rule-based interception**: Define flexible rules using YAML configuration with advanced pattern matching (regex, glob, JSONPath) - **Multiple actions**: Allow, block, or require approval (sampling) based on configurable policies - **Claude Code Hooks Integration**: Direct integration with Claude Code for real-time security evaluation - **Multi-transport Support**: STDIO, HTTP, and SSE transports for flexible deployment - **Hot reload**: Configuration changes are applied without restart - **AI-powered evaluation**: Optional AI inference for complex security decisions - **Performance optimized**: Request batching, caching, and connection pooling - **Comprehensive monitoring**: Built-in metrics, health checks, and performance dashboard - **Structured logging**: Comprehensive logging with structured output - **MCP compatibility**: Full Model Context Protocol support with FastMCP framework ## Quick Start ### Installation ```bash # Install with uv (recommended) uv pip install superego-mcp # Or install from source git clone https://github.com/toolprint/superego-mcp cd superego-mcp uv sync ``` ### Basic Usage 1. **Run security evaluation (for Claude Code hooks)**: ```…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.