AGASTHY — MCP server for Claude Code: what it does, how to install
AGASTHY is an MCP server for Claude Code that answers plain questions about the machine it runs on: which coding agents are live, what holds a port, where the tokens went.
Apache-2.0 ★ 9 updated 2026-11-17
Open on GitHubWhat AGASTHY does
The server reads the local machine and hands the answer back with evidence attached: cloned repos, active runtimes, processes holding ports, servers left running after an agent session. Start it with agasthy mcp; the same CLI exposes agents, processes, usage and telemetry on their own.
Everything sits in a single SQLite file on disk. No account, nothing uploaded. Answers are read-only, and the model can suggest a change without executing it. Hard limits hold the line: no sudo, no deleting repositories or files tracked by Git, no Docker volumes, no system processes.
Package inventory, repository list and impact analysis depend on scans the desktop app performs, so a CLI-only install covers fewer questions. Homebrew comes first: brew install hmakt99/tap/agasthy-cli, then claude mcp add agasthy -- agasthy mcp to register the server. Without the CLI nothing starts.
What it helps with
- list coding-agent sessions and the servers they left behind
- work out token spend by project and model
- check what depends on a package before removing it
- map which process holds which port
- spot duplicate MCP configs and instruction files
Example prompts for the agent
- Ask AGASTHY which agent sessions are still running and what they left behind.
- Show token spend for this project through AGASTHY.
- What stops working if I drop
openssl@3?
How to install AGASTHY
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AGASTHY
How do I install AGASTHY in Claude Code?
Install the CLI with brew install hmakt99/tap/agasthy-cli, then register the server: claude mcp add agasthy -- agasthy mcp.
What does AGASTHY do?
It reads the state of the machine and answers questions about it: repos, runtimes, busy ports, agent sessions, token spend. Read-only throughout.
What does AGASTHY need to work?
Homebrew plus the installed CLI — the server will not start without it. Repo lists, packages and impact analysis come from scans made by the desktop app.