PortPeek MCP gives parallel agents a shared port registry
u/adammor built PortPeek, a local MCP server that lets parallel coding agents coordinate port usage through four tools — preventing silent failures when multiple agents race for the same port.
Score breakdown
PortPeek replaces ad-hoc, per-agent port guessing with a shared coordination layer, eliminating the silent binding failures that occur when multiple MCP-compatible agents run concurrently on the same machine.
- 01Built by u/adammor to solve silent port conflicts when running multiple agents like Claude Code and Cursor in parallel
- 02Provides four MCP tools: `list_active_ports`, `get_available_port`, `reserve_port`, and `release_port`
- 03Runs entirely locally on macOS — no accounts or cloud required
u/adammor published PortPeek, a local MCP server built to address a recurring pain point when running multiple coding agents simultaneously — agents independently attempting to bind to the same port, causing silent failures that can take minutes to diagnose. The project was motivated by the author's own experience running Claude Code and Cursor side by side.
The server runs entirely on the local Mac with no accounts or cloud component.
PortPeek exposes four MCP tools to agents: `list_active_ports` to inspect what is currently listening, `get_available_port` to claim a free port before starting a service, `reserve_port` to lock a port so no other agent can take it mid-run, and `release_port` to free it when the service is done. The server runs entirely on the local Mac with no accounts or cloud component. Installation is via `brew install adamorad/tap/portpeek-mcp && portpeek-mcp --install-launch-agent`, followed by adding `{"mcpServers":{"portpeek":{"url":"http://localhost:27182"}}}` to the agent configuration. The project is compatible with Claude Code, Cursor, Cline, Windsurf, and any MCP-compatible agent.
Key facts
- 01Built by u/adammor to solve silent port conflicts when running multiple agents like Claude Code and Cursor in parallel
- 02Provides four MCP tools: `list_active_ports`, `get_available_port`, `reserve_port`, and `release_port`
- 03Runs entirely locally on macOS — no accounts or cloud required
- 04Install via Homebrew: `brew install adamorad/tap/portpeek-mcp && portpeek-mcp --install-launch-agent`
- 05Agent config entry: `{"mcpServers":{"portpeek":{"url":"http://localhost:27182"}}}`
- 06Compatible with Claude Code, Cursor, Cline, Windsurf, and any MCP-speaking agent
Topics
Summary and scoring are generated automatically from the original article. We always link back to the publisher and never republish images or paywalled content. Last processed Jun 11, 2026 · 08:34 UTC. How this works →