Breakdown Connectivity

Diagnose connectivity failures with Breakdown

Use Breakdown's local MCP server to add current and historical network evidence to an agent's own troubleshooting process. Select actions according to the task, available tools, environment capabilities, and existing user instructions.

Check for Breakdown

Look for Breakdown MCP tools such as get_current_network_health and list_recent_network_issues.

If they are available, use whichever tools fit the task. A useful starting point for many failures is current health plus recent issues, followed by evidence focused on the affected DNS resolver, Wi-Fi interface, app, endpoint, route, or time window.

Relate retained issue timestamps to the reported failure instead of assuming every listed issue is current. Prefer focused time windows and bounded result counts when detailed evidence would otherwise be large.

Read references/mcp-tools.md when choosing among Breakdown's evidence and analysis tools.

Set up Breakdown when unavailable

Breakdown requires macOS 13 or later. Its MCP bridge forwards requests to the running Breakdown app.

Use the bundled helper when shell access is available:

sh

./scripts/setup-breakdown.sh status

The helper exposes separate operations so the calling agent can compose the setup that fits its environment:

sh

./scripts/setup-breakdown.sh install
./scripts/setup-breakdown.sh open-app
./scripts/setup-breakdown.sh configure-codex
./scripts/setup-breakdown.sh configure-claude-code [local|project|user]
./scripts/setup-breakdown.sh print-config

status also reports whether the Mac is supported, the app is running, local MCP discovery is missing, disabled, invalid, or configured, and Codex or Claude Code already has a breakdown MCP entry.

configure-claude-code accepts an optional Claude Code MCP scope. Omit it to use Claude Code's default, or pass local, project, or user when a particular scope fits the task.

Claude Code resolves default/local and project-scoped MCP configuration from the current project directory. When using either form, resolve this helper from the skill directory while keeping the intended Claude project as the command's working directory. The Claude configuration fields in status are resolved in the same context.

install downloads the current stable package from Breakdown's official website, verifies its Developer ID Installer signature, and opens it with the standard macOS installer. An agent can instead use the official download URL or the downloaded package with other installation mechanisms available in its environment.

After installation, keep Breakdown running. Configure the client to launch:

text

/Applications/Breakdown/Breakdown.app/Contents/MacOS/BreakdownMCPBridge

Reload or reconnect the MCP client if that client requires it, then confirm that Breakdown's tools are discoverable.

Work with the evidence

Choose the depth that is useful for the task:

• Inspect current segment health and freshness for a compact snapshot.
• Review recent issues when the failure may have happened before the current moment.
• Request time-series or route evidence around the relevant app, endpoint, resolver, interface, or time window.
• Use Breakdown analysis when a synthesized evidence-backed investigation would help.
• Export an Evidence Report when a portable artifact is useful.

Interpret Breakdown's structured results together with the task's other evidence. Decide subsequent actions using the agent's normal reasoning and operating instructions.

If direct setup is unavailable

Give the official download and setup information:

• Download: https://breakdown.live/download/mac
• Agent guide: https://breakdown.live/for-agents/
• Platform: macOS 13 or later
• Installed bridge: /Applications/Breakdown/Breakdown.app/Contents/MacOS/BreakdownMCPBridge