🪶 emmu — Autonomous Cyber AI Bridge¶
emmu (Enhanced MCP Utilities) is a premium, high-performance automation bridge for Cybersecurity AI (CAI). It transforms the Deepmind CAI engine into a modular, production-ready automation stack designed for rapid red teaming, autonomous bug bounty hunting, and mission execution.
![]() |
![]() |
The AI Bridge Philosophy¶
[!NOTE] The Problem: External LLM models (like Claude, Codex, or Gemini-CLI) operate in isolation and cannot natively interface with complex cybersecurity toolchains, debuggers, or CTF environments.
The Solution: Emmu acts as a Synchronous Orchestrator and MCP Bridge. It translates high-level AI reasoning into low-level execution by adopting internal Python functions and exposing them to external models, providing them with over 50 specific cybersecurity tools.
Emmu is not just a script; it is an Enterprise-Grade AI Framework. By enforcing strict Planner-Reviewer loops, isolating execution into specialized agents, and persisting state across a persistent Scratchpad memory, Emmu eliminates LLM hallucination and enables true autonomous operations.
Core Capabilities¶
Emmu operationalizes AI through three distinct modes:
- emmuOEC (Campaign-Centric Analysis)
A loop-based static analysis engine designed for auditing source code, binaries, and APKs with reviewer-gated findings. - CTF Event Orchestrator
A live event manager capable of ingesting CTF challenges, managing custom prompts via theprompt_engine, solving via playbooks, and verifying flags natively. - Autonomous Bug Bounty
Multi-phase pipelines (Recon -> Discovery -> Analysis) for Web and Mobile pentesting, connected natively to HackerOne and Intigriti.
Architecture at a Glance¶
The following diagram illustrates how user requests flow through Emmu's non-blocking orchestrator and are executed by the specialized AI workforce.
graph LR
%% External Interfaces
subgraph Interfaces["External Models & Interfaces"]
A[Gemini CLI]
B[Claude / Codex]
C[Web Dashboard]
end
%% Emmu Core
subgraph Emmu["Emmu AI Orchestration Core"]
D((MCP Bridge))
E{Synchronous Orchestrator}
F[(Specialists & Tools)]
D -->|Routes Prompts| E
E -->|Executes Native Functions| F
end
A --> D
B --> D
C --> E
%% Styling
classDef ext fill:#2d3436,stroke:#74b9ff,stroke-width:2px,color:#fff;
classDef core fill:#0984e3,stroke:#fff,stroke-width:2px,color:#fff;
class A,B,C ext;
class D,E,F core;
Documentation Index¶
Explore the framework architecture and setup guides below to understand how Emmu operates at scale.
1. Getting Started¶
2. Core Architecture¶
3. Modules & Integrations¶
- Model Context Protocol (MCP) Utilities
- Bug Bounty Platforms (H1/Intigriti)
- Discord Command & Control (C2)

