MCP debugger

PulseRN includes a local MCP server that lets compatible AI clients inspect debugging sessions and, when permitted, control Hermes and storage. The adapter runs over stdio and connects to the desktop app through an authenticated Unix socket or Windows named pipe. It does not open an MCP network port.

Enable MCP

1. Open PulseRN.
2. Select the top-level MCP section beside Settings.
3. Enable MCP and choose Codex, Claude, Cursor, or Other.
4. Choose an access mode.
5. Copy the generated configuration into the AI client.
6. Restart the client and confirm its connection in PulseRN.

Packaged builds bundle the MCP server. End users do not need Node.js, npm, or a separate MCP installation. Always copy the configuration generated by the installed app because executable and resource paths depend on the operating system and installation location.

Access modes

Mode	Intended access
Read-only	Sessions, events, diagnoses, network, Redux, navigation, performance, sources, and health
Debugger	Read-only tools plus Hermes discovery, pause, stepping, breakpoints, frames, scopes, and component inspection
Full	Debugger tools plus JavaScript evaluation and storage mutations

Use the least-permissive mode that completes the task.

Available workflows

An MCP client can:

• list sessions and query bounded, redacted events;
• inspect an event by stable ID;
• analyze errors and related preceding evidence;
• create and reopen diagnostic snapshots;
• inspect network, Redux, navigation, performance, and connection health;
• discover and connect to Hermes targets;
• search sources and request bounded source context;
• pause, resume, step, and manage normal or temporary breakpoints;
• inspect frames, scopes, properties, and the React component tree;
• interact with a component when the runtime exposes that capability;
• discover and operate registered storage providers in full mode.

Example requests:

Diagnose the newest session and show the evidence for its highest-confidence failure.
Find failed checkout requests and correlate them with Redux and navigation events.
Set a temporary breakpoint at the source of this error, then inspect local variables when it pauses.

Security model

MCP is disabled by default. Enabling it creates a random 256-bit token and a user-only access file. Disabling MCP disconnects clients, removes the file, and invalidates the token.

PulseRN validates and bounds requests, rate-limits sensitive commands, and writes sanitized actions to mcp-audit.jsonl. Storage values, JavaScript expressions, breakpoint conditions, log messages, and authentication tokens are not written to the audit log.

Full access can modify application state. Enable it only for a trusted local client. Application events and runtime values are marked as untrusted in tool responses and must not be treated as AI instructions.