NetPeek MCP is a local service on the iPhone, off by default. After you enable it, a trusted client on the same Wi-Fi network or a USB link can call capture-analysis tools with Authorization: Bearer <token>. NetPeek does not upload captures anywhere; review the privacy behaviour of whichever client you connect.
Enable
- Open Settings → NetPeek MCP and enable the service.
- Copy the MCP URL and token. Share them only with a trusted client.
- Merge
mcpServers.netpeekinto Claude Code, Codex, or another compatible client. The auth header isAuthorization: Bearer <token>. - Run the Bearer-authenticated health check from a terminal, then refresh the tool catalog.
Tools
The service exposes 16 tools. Compact list and search responses stay redacted. After a successful authenticated get_request or get_body, the client may read URL, query, headers, cookies, Authorization, and bodies. digest and redacted are optional caller-selected previews, not extra permission scopes.
list_requests/search_requests— paginated or filtered recent captures (compact, redacted).get_request/get_body— full detail and pageable body bytes.get_stats/list_runs/get_run— totals, host distribution, capture runs.list_favorites— favorited rows.decode_jwt/explain_tls/analyze_timing/audit_security— analysis helpers.diff_runs/diff_requests/infer_api_schema— compare and summarize.import_rewrite_bundle— import rewrite rules, scripts, replays, or constants when the client requests it.
Prompts
The service also advertises workflow prompts: netpeek_skill, traffic_triage, debug_api_failure, privacy_audit, why_slow, find_cleartext, diff_captures, reverse_api, explain_app_behavior, and install_rewrite_bundle.
Token handling. Do not share the token on an untrusted network. Revoke Token invalidates the current credential and stops the service; Reset Token issues a new one. Missing or invalid Bearer credentials are rejected on every /mcp* route.