Verify Setup

Most users can skip this page, but it is useful when you are validating a new client config or debugging a first-time setup issue.

Ask your agent to run a tiny debugger flow

Use pwno-mcp to create a debug session called chal-a, load /workspace/chal, set a breakpoint at main, run the program, show full context, then step once.

Check the expected behavior

You should see the session created, the binary loaded, execution stop at main, a full context snapshot returned, and one successful step.

Fall back to manual tool calls if needed

If your agent cannot complete the flow, run the sequence below through any MCP inspector or compatible client.

Use pwno-mcp to create a debug session called chal-a, load /workspace/chal, set a breakpoint at main, run the program, show full context, then step once.

{"tool":"create_debug_session","arguments":{"session_id":"chal-a"}}
{"tool":"set_file","arguments":{"binary_path":"/workspace/chal","session_id":"chal-a"}}
{"tool":"set_breakpoint","arguments":{"location":"main","session_id":"chal-a"}}
{"tool":"run","arguments":{"args":"","start":false,"session_id":"chal-a"}}
{"tool":"get_context","arguments":{"context_type":"all","session_id":"chal-a"}}
{"tool":"step_control","arguments":{"command":"n","session_id":"chal-a"}}

If you followed Quick Start, the host path is ./workspace/chal and the in-container tool path is /workspace/chal.

Common stepping commands are c, n, s, ni, and si.

If this flow fails, go straight to Troubleshooting or check the transport, session, and path rules in Core Concepts.

Quick Start

Claude Desktop

Introduction

Client Setup