Wrath MCP Server
Provides MCP tools for managing the Wrath Grok addon, including doctor, config, policy_check, journal_tail, session_stats, and set_enabled.
README
Wrath V2 — Grok Build control plane
GPLv3. Cold drive, profiles (incl. yolo), modular policy, lifecycle journal, privacy/fleet/IL, /wrath-* + MCP.
Not a second agent runtime. Heuristic guards — not a full sandbox (SECURITY.md).
Install
git clone https://github.com/Warexpor/wrath-addon.git
cd wrath-addon
.\install.ps1
.\install.ps1 -Rules # optional ~/.grok/rules
Or: grok plugin install . --trust then reload plugins.
install.ps1 reinstalls and patches MCP to an absolute launcher path.
Requires Python 3.10+ and the src/wrath package (ships with the plugin).
What you get (V2)
| Piece | Effect |
|---|---|
| SessionStart | Status line + drive pack + MCP self-heal |
| PreToolUse | Modular policy (nested shell depth 3, privacy, spawn model pin, footguns) |
| Full lifecycle | PermissionDenied, SubagentStart/Stop, Compact, SessionEnd, StopFailure |
| Profiles | default · thin · strict · privacy · fleet · max · yolo |
| Journal schema 2 | rule_id denials, subagents, harness denials |
| MCP | status, last_deny, policy_check (any tool), set_profile/privacy, session_report |
Profiles
| Profile | Modes |
|---|---|
| default | Baseline guards, privacy upload warn |
| thin | Lighter privacy |
| strict | Strict denials + spawn model warn |
| privacy | Strict + privacy upload deny |
| fleet | orchestrate + il + spawn model warn |
| max | All of the above hard |
| yolo | Soft guards (anti-max): force-push / reset --hard / pipe / bulk upload allowed; catastrophic fs + project deny still blocked |
# .wrath.toml
version = 2
profile = "default"
[policy]
nested_shell_depth = 3
budget_tools = 80
reread_warn = 3
privacy_upload = "warn" # off | warn | deny
require_spawn_model = "off"
deny = ["\\bnuke-prod\\b"]
[modes]
strict = false
Walks up from cwd / GROK_PROJECT_DIR. v1 configs still load.
Overrides
| Env | Effect |
|---|---|
WRATH_ALLOW_FORCE=1 |
Allow force-push main/master |
WRATH_ALLOW_HARD=1 |
Allow git reset --hard |
WRATH_ALLOW_CLEAN=1 |
Allow git clean -f[dx] |
WRATH_ALLOW_PIPE_EXEC=1 |
Allow curl|bash / iwr|iex |
WRATH_STRICT=1 |
Force STRICT |
WRATH_ORCHESTRATE=1 |
Force fleet mode |
WRATH_IL=1 |
Force IL dialect |
WRATH_PRIVACY=1 |
Force privacy (bulk upload deny) |
WRATH_YOLO=1 |
Force YOLO soft-guard mode |
WRATH_BUDGET_TOOLS=N |
Budget nudge threshold |
WRATH_REREAD_WARN=N |
Re-read warn threshold |
WRATH_NESTED_DEPTH=N |
Shell unwrap depth (1–8) |
WRATH_OFF=1 / WRATH_ON=1 |
Force runtime off/on |
Commands
| Command | Effect |
|---|---|
/wrath |
Hub |
/wrath-on / /wrath-off |
Runtime |
/wrath-profile <name> |
Profile switch |
/wrath-privacy |
Privacy mode |
/wrath-yolo |
YOLO soft guards |
/wrath-strict |
Strict mode |
/wrath-orchestrate |
Fleet multi-model |
/wrath-il |
IL agent wire |
/wrath-status · /wrath-doctor · /wrath-why |
Inspect |
/wrath-thin · /wrath-check · /wrath-ship · /wrath-budget · /wrath-review |
Workflows |
Verify
python -m pytest
ruff check src hooks mcp tests
grok plugin details wrath
Docs
- HOOK_CONTRACT.md — Grok Build hook surface
- SECURITY.md — residual risk
License
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.