tidyports
See and control the local dev servers your coding agents leave running. Lists listeners with provenance — which agent, terminal and git worktree started each — kills strays, and allocates collision-free ports so parallel agents stop fighting over :3000.
README
TidyPorts integrations
Let your coding agent see and control the local dev servers it starts.
If you run Claude Code, Cursor or Codex across several git worktrees, each one starts dev
servers you never typed a command for. Ports collide, and an agent that hits EADDRINUSE
often can't tell a port conflict from a bug — so it "fixes" working code instead.
These integrations give the agent a way to look, rather than guess.
mcp/ |
An MCP server — typed tools for any MCP client (Claude Code, Cursor, Claude Desktop, Windsurf, Zed). |
skills/ |
A Claude Code skill, if you'd rather it shelled out to the CLI directly. |
guard/ |
Wrap your dev command so EADDRINUSE names what is holding the port, instead of only saying that something is. |
raycast/ |
A Raycast extension for the same list, without leaving the launcher. |
Tools
| Tool | What it does |
|---|---|
list_servers |
Listening dev servers: port, process, branch, owner, idle. Read-only. |
kill_port |
Stop the server on a given port. |
alloc_port |
A stable, collision-free port for this worktree — the fix for parallel agents fighting over :3000. |
free_port |
A port nothing is listening on right now, to bind immediately. |
Install
The skill, for any agent (Claude Code, Cursor, Copilot, Gemini…):
npx skills add dan-fetch-studio/tidyports-integrations
The MCP server:
npm install -g @tidyports/mcp
Then register it with your client, pointing at the installed tidyports-mcp binary. For
Claude Code:
claude mcp add tidyports -- tidyports-mcp
It needs the TidyPorts app
These are a thin layer over the tidy-ports CLI, which ships inside
TidyPorts — a free macOS menu-bar app that shows every dev server
running on your Mac and which agent started it.
brew install --cask dan-fetch-studio/tap/tidyports
Or download it from tidyports.app/download. macOS 15+.
Licence
The integrations here are MIT (see LICENSE). The TidyPorts app itself is source-available under its own licence.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.