Add MCP plugin for Claude Code

AgentBreak now works as an MCP server, giving Claude structured tools
for chaos testing instead of shell commands.

- Add agentbreak/mcp_server.py with 11 tools: init, analyze,
  generate_config, inspect, validate, start, wire, revert, stop,
  scorecard, status
- Add `agentbreak mcp-server` CLI command with lazy import
- Add `[plugin]` optional dependency for mcp>=1.0.0
- Rewrite skill to use MCP tools (420 lines → 90 lines)
- Add plugin and skill docs pages to docs-site
- Update README with plugin install and config

Key safety guarantee: agentbreak_stop auto-reverts .env — the user's
app config is never left pointing at a dead proxy.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

Author: mnvsk97

README.md

@@ -89,13 +89,28 @@ agentbreak history compare 1 2    # diff two runs
 
 ## Claude Code
 
-If you use [Claude Code](https://docs.anthropic.com/en/docs/claude-code), AgentBreak has a guided skill that scans your codebase, generates scenarios, and walks you through results:
+AgentBreak works as an MCP plugin for [Claude Code](https://docs.anthropic.com/en/docs/claude-code):
 
 ```bash
-npx skills add mnvsk97/agentbreak
+pip install agentbreak[plugin]
 ```
 
-Then type `/agentbreak` in Claude Code.
+Add to your Claude Code settings:
+
+```json
+{
+  "mcpServers": {
+    "agentbreak": {
+      "command": "agentbreak",
+      "args": ["mcp-server"]
+    }
+  }
+}
+```
+
+Now Claude has tools to analyze your codebase, generate chaos scenarios, start the proxy, wire your agent, and auto-revert when done. Your `.env` is never left broken — `agentbreak_stop` auto-reverts.
+
+For a guided workflow, add the skill: `npx skills add mnvsk97/agentbreak`, then type `/agentbreak`.
 
 ## Full reference
 

agentbreak/main.py

@@ -1222,6 +1222,20 @@ def verify() -> None:
     subprocess.run(command, cwd=repo_root, check=True)
 
 
+@cli.command("mcp-server", help="Start AgentBreak as an MCP server for Claude Code.")
+def mcp_server_command() -> None:
+    try:
+        from agentbreak.mcp_server import run_server
+    except ImportError:
+        typer.echo(
+            "MCP server requires the plugin extra. Install it with:\n\n"
+            "  pip install agentbreak[plugin]\n",
+            err=True,
+        )
+        raise typer.Exit(code=1)
+    run_server()
+
+
 history_cli = typer.Typer(help="View past run history.")
 cli.add_typer(history_cli, name="history")