Skip to content

Quickstart

mcpwn wraps a stdio MCP server: the host launches mcpwn, mcpwn launches the real server and relays the traffic, logging every message to stderr (stdout/stdin stay byte-clean for the protocol).

Terminal window
# Passive X-ray — watch all traffic, change nothing
mcpwn -v -- npx -y @modelcontextprotocol/server-filesystem /tmp
# Interactive — hold every message and decide: forward / drop / edit / tamper
mcpwn -i -- node ./my-server.js
# Tamper headlessly — apply JSON rules to messages in flight
mcpwn -r attack.json -- node ./my-server.js
# Record a session log (JSONL) for later review
mcpwn -l session.jsonl -- node ./my-server.js
Terminal window
# Drives the handshake, enumerates every surface, samples content, runs all
# passive detectors, and fails CI on findings at/above a severity.
mcpwn scan --fuzz --findings-out ./out --fail-on high -- node ./my-server.js
mcpwn scan --http https://mcp.example.com/mcp --findings-out ./out
Terminal window
npm run demo # end-to-end inject -> exfil demo (no network, no API key)
npm run dvmcp # the Damn-Vulnerable MCP scoreboard