worktree-orbit-mcp
Provides read-only inspection of Git worktree topology, offering aggregate signals about worktree counts, cleanliness, and states such as detached, locked, or prunable.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@worktree-orbit-mcp What's the status of all worktrees in this repo?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
worktree-orbit-mcp
Worktree Orbit is a local MCP for developers who keep several Git worktrees alive at once. It answers whether a repository has parallel worktrees, whether they are clean, and whether detached, locked, or prunable worktrees need attention.
Tool
inspect_worktree_topology: returns aggregate worktree count, primary and linked counts, clean or dirty counts, detached state, lock state, prunable state, and a coarse topology hint.
It never returns paths, branch names, hashes, remotes, lock reasons, subjects, authors, or file contents.
Related MCP server: GitOps Safe MCP
Safety
Local Git commands only. No network access is used.
The selected repository must stay inside
WORKTREE_ORBIT_ROOT.Commands are read-only: the server does not add, remove, move, lock, unlock, reset, prune, or modify worktrees.
Worktree status checks are bounded and time limited.
Results are aggregate signals, not a replacement for inspecting a specific worktree before deleting it.
Run
npm install
npm run build
node dist/index.jsAvailable Tools
1 toolinspect_worktree_topologyA
Summarize local Git worktree topology, clean or dirty state, detached worktrees, locks, and prunable entries without exposing paths, branch names, hashes, remotes, or content.
Inputs: cwd.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The tool's purpose is clearly described, making selection unambiguous.
The tool name 'inspect_worktree_topology' follows a clear verb_noun pattern in snake_case, which is consistent and predictable. As a single tool, it sets a clear convention.
The server has only one tool, which is on the low end of typical tool counts. While the narrow scope of inspection might justify a single tool, the server name suggests a broader worktree management capability, making the count feel slightly thin.
The tool provides a comprehensive inspection summary, but lacks any management operations (create, delete, prune, etc.) that the server name 'worktree-orbit' implies. This leaves significant gaps in the tool surface for full worktree lifecycle coverage.
Maintenance
Related MCP Connectors
Live GitHub repo AST X-Ray, 42 coding-agent DoD gates, Git worktree guards & brownfield baselines.
Screens public GitHub repos and PRs to generate risk maps, findings, and merge-readiness signals.
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Generate SBOMs, scan vulnerabilities, and analyze dependencies from local projects or Git repos.
Related MCP Servers
- FlicenseAqualityDmaintenanceProvides bounded, read-only analysis of local project directories, enabling inventory, marker detection, and safe file reads without executing code.4-
- AlicenseNot gradedqualityDmaintenanceEnables read-only inspection of Git repository status and diff summaries, along with validation of OpenTofu and Ansible configurations, through a strictly limited, non-mutating toolset.MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to inspect local Git repositories through five focused, read-only tools for repository trees, literal text search, numbered file reads, bounded git diffs, and project summaries while confining paths, skipping secret-like and binary files, and enforcing output limits.MIT
- AlicenseNot gradedqualityCmaintenanceEnables read-only, workspace-bound inspection of repositories and log files, returning JSON reports with file counts, largest files, TODO/FIXME markers, and warning/error counts.MIT