Skip to content

hypnguyen1209/offensive-claude / skills/web-pentest

web-pentest

Flagged

Use when pentesting a web application or API — injection, XSS/CSP, SSRF/cloud-metadata, HTTP desync & cache poisoning, SSTI/prototype-pollution/deserialization, JWT/OAuth/GraphQL/IDOR, business logic & single-packet race

references/proxy-mcp-integration.md

View on GitHub
# Live Proxy MCP Integration (Burp / Caido)

The single biggest force-multiplier for web/network work: give the model **ground truth** about
real traffic, auth, and scope instead of blind-generating `curl`. An intercepting-proxy MCP exposes
the proxy's history, scope, and replay engine as tools, so the model reasons over *actual* requests
and responses (with real session state) and can replay-with-auth.

This skill does **not** ship a proxy server — use the upstream ones:

- **Burp Suite MCP** — PortSwigger's official MCP extension (install from the BApp Store; it runs an
  MCP server Claude Code connects to). Exposes proxy history, repeater/replay, scope, and scanner findings.
- **Caido MCP** — Caido's MCP plugin (HTTP endpoint). Lighter-weight alternative to Burp.

Use **one** of them. Both are registered as disabled examples in `settings.json` under
`_mcpServers_examples` — move the chosen entry into `mcpServers` and reload.

## Secret hygiene at the data boundary (mandatory)

Captured traffic carries live `Authorization` / `Cookie` / `Set-Cookie` / API-key headers. Do **not**
rely on a prompt telling the model "don't echo secrets." Redact mechanically before the data is
summarized, logged, or written to a finding:

```python
from redact_headers import redact_headers, redact_text   # skills/coding-mastery/scripts/_lib
safe = redact_headers(resp_headers)        # dict -> dict, sensitive values masked
print(redact_text(raw_http_exchange))      # raw request/response dump, tokens stripped
```

```bash
# filter a saved exchange before pasting/attaching it
python skills/coding-mastery/scripts/_lib/redact_headers.py < exchange.txt > exchange.redacted.txt
```

The mask keeps a short hint (`Bearer eyJ***REDACTED***xZ`) for correlation without leaking the secret.

## Workflow with a proxy MCP

1. **Scope sync** — keep the proxy's target scope aligned with `.engage/scope/scope.json`; confirm any
   replay target with `scope_guard.py check` first (out-of-scope replay is a `block`, per `action_guard.py`).
2. **Observe** — pull proxy history for the in-scope host; let the model map the real attack surface
   (params, auth flow, state) from genuine requests — feed it via `redact_text`.
3. **Replay-with-auth** — use the proxy's repeater/replay to re-issue a captured authenticated request
   with a mutated parameter (the input-signal routing table in `SKILL.md` picks the test); this is how
   IDOR/access-control and business-logic tests get *real* session context.
4. **Confirm** — capture the response as evidence; set the structured proof signal (e.g.
   `cross_identity_confirmed`) for `validate_findings.py`.

## OPSEC

- Mutating replays (`POST`/`PUT`/`DELETE`) go through `action_guard.py` → `require_approval` unless ROE opts in.
- The proxy logs everything you send — assume the blue team can see the same history.
- Never paste un-redacted captures into chat, tickets, or the report; redaction is one import away.

## Do NOT

- Write our own proxy server — reference the upstream Burp/Caido MCPs.
- Require both Burp and Caido — document them as alternatives.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall