Tidyports MCP server

by dan-fetch-studio·io.github.dan-fetch-studio/tidyports·v0.1.2

No reviews yet

See and kill the dev servers your coding agents leave running, and get collision-free ports.

A85/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A85/100

full report

Adoption

New

0 stars31 downloads/wk

Reviews

Write one

Nobody has reviewed Tidyports yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Tidyports tools (4, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

alloc_port
Return a stable free port assigned to this git worktree, so parallel agents/worktrees don't collide on the same port (EADDRINUSE). Wire the returned port into the dev server's launch command.
free_port
Return a single TCP port that is NOT currently in use, so you can bind a server without an EADDRINUSE collision. Stateless — for a STABLE port that's remembered per worktree across restarts, use alloc_port instead.
kill_portwrite action
Stop whatever dev server is listening on the given local port (frees it).
list_servers
List the local dev servers currently listening — port, process, git branch, owner, and an idle hint. Read-only. Use it to answer 'what's running?', 'which server is on :3001?', or 'which worktree is serving this?'.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings

Code scan2 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 58 days ago12/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Tidyports compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 85/100; higher than 70% of 48,255 servers
Tools: 4; the typical server has 7
Tools that change things: 25%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 31; more than 19% of 12,191 servers with a package

What its tools let an agent do: 3 read · 1 run or deploy

Install Tidyports in Claude Code, Cursor or VS Code

Runs npx -y @tidyports/mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add tidyports -- npx -y @tidyports/mcp

Add to Cursor

What the publisher says

From the Tidyports repository's README, as published. We do not edit it. Read it on GitHub

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.

Tools

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.

Nothing above is checked by us. What we check is on the safety report.

Tidyports: common questions

Is Tidyports MCP server safe?: Yes, by our scan: it is graded A (85/100). Read the Tidyports safety report
How do I install Tidyports?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Tidyports need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Tidyports maintained?: The last commit was 98 days ago (2026-07-29). The latest release is v0.1.2.
How does Tidyports compare with other MCP servers?: safety score 85/100 (higher than 70% of 48,255 servers); tools 4 (the typical server has 7); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.