# pwno-mcp

> Stateful MCP server for autonomous pwn and binary research with GDB, pwndbg, and session-aware tooling.

## Docs

- [Architecture](https://docs.pwno.io/architecture.md): Project structure and runtime design decisions behind pwno-mcp.
- [Background Story](https://docs.pwno.io/background-story.md): How pwno-mcp evolved through several iterations before becoming the current open-source project.
- [Claude Code](https://docs.pwno.io/client-setup/claude-code.md): Connect pwno-mcp to Claude Code over HTTP or stdio.
- [Claude Desktop](https://docs.pwno.io/client-setup/claude-desktop.md): Configure pwno-mcp for Claude Desktop over stdio.
- [Codex CLI](https://docs.pwno.io/client-setup/codex-cli.md): Connect pwno-mcp to Codex CLI over HTTP or stdio.
- [Cursor](https://docs.pwno.io/client-setup/cursor.md): Configure pwno-mcp for Cursor using HTTP or stdio transport.
- [OpenCode](https://docs.pwno.io/client-setup/opencode.md): Configure pwno-mcp for OpenCode with remote HTTP or local stdio.
- [Response Shapes](https://docs.pwno.io/concepts/response-shapes.md): Understand how pwno-mcp tools return structured data, JSON strings, and errors.
- [Sessions](https://docs.pwno.io/concepts/sessions.md): Understand session_id, runtime directories, and how pwno-mcp keeps debugger state alive.
- [Transports and Runtime](https://docs.pwno.io/concepts/transports-and-runtime.md): HTTP, stdio, health checks, attach sidecar behavior, and runtime defaults.
- [Workspace Paths](https://docs.pwno.io/concepts/workspace-paths.md): How pwno-mcp resolves file paths, working directories, and runtime artifacts.
- [Contributing](https://docs.pwno.io/contributing.md): How to contribute code or documentation to pwno-mcp.
- [Development](https://docs.pwno.io/development.md): Local development, verification commands, and docs preview for maintainers.
- [Attach to a Running Process](https://docs.pwno.io/guides/attach-to-running-process.md): Use the debugger attach tool or the attach sidecar API to join an existing process.
- [Build and Helper Processes](https://docs.pwno.io/guides/build-and-helper-processes.md): Use run_command, spawn_process, Python helpers, and repo fetching without colliding with debugger flows.
- [First Debug Session](https://docs.pwno.io/guides/first-debug-session.md): Create a session, load a binary, stop at main, inspect state, and step once.
- [Guides](https://docs.pwno.io/guides/index.md): Task-oriented walkthroughs for common pwno-mcp workflows.
- [Interactive Exploit Loop](https://docs.pwno.io/guides/interactive-exploit-loop.md): Start a pwncli driver, send input, read output, collect events, and stop cleanly.
- [Multi-Session Workflows](https://docs.pwno.io/guides/multi-session-workflows.md): Run multiple debugger or exploit sessions in parallel without state collisions.
- [Introduction](https://docs.pwno.io/index.md): Stateful debugging, exploit I/O, and workspace automation for autonomous pwn workflows over MCP.
- [License](https://docs.pwno.io/license.md): Licensing terms for pwno-mcp.
- [Configuration](https://docs.pwno.io/operations/configuration.md): CLI flags, runtime defaults, and environment variables that affect pwno-mcp.
- [Docker and Compose](https://docs.pwno.io/operations/docker-and-compose.md): Container launch patterns, local image builds, and compose usage for pwno-mcp.
- [Quick Start](https://docs.pwno.io/quickstart.md): Run pwno-mcp locally with Docker and connect an MCP client.
- [Attach API](https://docs.pwno.io/tool-reference/attach-api.md): Reference for the local /attach helper API and the bundled Python client helper.
- [Debug Sessions](https://docs.pwno.io/tool-reference/debug-sessions.md): Session lifecycle, file loading, breakpoints, attach flows, and execution control tools.
- [Reference](https://docs.pwno.io/tool-reference/index.md): Tool-by-tool reference for debugger control, inspection, exploit I/O, and automation helpers.
- [Inspection](https://docs.pwno.io/tool-reference/inspection.md): Read current debugger context and inspect memory without changing execution.
- [Processes](https://docs.pwno.io/tool-reference/processes.md): Run helper commands and manage tracked background processes.
- [pwncli Workflows](https://docs.pwno.io/tool-reference/pwncli.md): Interactive exploit-driver flows tied to a debug session.
- [Python](https://docs.pwno.io/tool-reference/python.md): Run inline Python, execute scripts, and manage packages in the shared environment.
- [Repositories](https://docs.pwno.io/tool-reference/repositories.md): Clone helper repositories into the workspace for analysis or build support.
- [RetDec](https://docs.pwno.io/tool-reference/retdec.md): Inspect optional RetDec decompilation status and retrieve decompiled code.
- [Troubleshooting](https://docs.pwno.io/troubleshooting.md): Common pwno-mcp setup and runtime issues.
- [Verify Setup](https://docs.pwno.io/verify-setup.md): Run a fast end-to-end check against a local pwno-mcp instance.

## OpenAPI Specs

- [openapi](https://docs.pwno.io/api-reference/openapi.json)