Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open