ahpc MCP server
Commit Nov 12, 2026Connect to Agent Host Protocol hosts to manage sessions, interact with agents, and expose host sessions to other agents via MCP.
Also known as ahpio/ahpc
- Stars
- 8
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 12, 2026
- License
- MIT
What is ahpc MCP?
ahpc connects to Agent Host Protocol hosts to manage sessions, interact with agents, and expose host sessions to other agents via MCP.
Summary generated from the project's README
About ahpc MCP server
Managing Agent Host Protocol sessions and interacting with remote agents from a terminal is what ahpc enables. This client connects to AHP-compatible hosts, such as ahpd or VS Code, to provide a centralized way to control agentic workflows. Users can operate via a command line interface, an interactive TextUI chat, or by running it as a tool server that exposes host sessions to other agents through MCP.
Developers use the tool to list, create, configure, and archive sessions, while also managing turns, tool call approvals, and file diffs. It provides visibility into host filesystems, running shells, and automation histories. By using the mcp command, you can connect your local host sessions to clients like Claude Code, Claude Desktop, or VS Code, allowing an external agent to drive the sessions on your host via a JSON API or MCP.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableahpio/ahpc is public and reachablegithub.com/ahpio/ahpc ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/ahpio/ahpc ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubahpc
A terminal client for the Agent Host Protocol. It can be used as cli (commands), tui (interactive chat), or a tool server that lets an agent elsewhere drive the sessions on your host.
Connect to an AHP host, manage sessions, and work with agents directly from your terminal.
[!NOTE]
ahpcis a client. It does not run agents or models itself. You need an AHP-compatible host to connect to.
The interface is built with TextUI, a component toolkit for terminal applications.
Quick start
npm install -g @softov/ahpc
Or run it without installing, with npx @softov/ahpc.
The package is scoped; the command it installs is ahpc.
A scripted host is built in, so the screen runs with nothing else to set up:
ahpc
Point it at a real host:
ahpc --host ws://127.0.0.1:9187
ahpc session list --host ws://127.0.0.1:9187
ahpd and VS Code's agent host are both AHP hosts.
What it does
| Sessions | List, create, configure, archive and delete sessions on a host. |
| Turns | Send a prompt, stream the reply, queue follow-ups, cancel. |
| Answering | Approve or deny tool calls, and answer questions the agent asks mid-turn. |
| Chats | Multiple conversations in one session. |
| Changes and files | Files a session changed, their diffs, and the host's filesystem. |
| Terminals | Shells running on the host, and their output. |
| Automations | Scheduled and triggered runs, with their history. |
| Customizations | Skills, prompts, agents and MCP servers, and which are enabled. |
| Telemetry | Stream the host's log. |
| Tool server | Serve those sessions to an agent somewhere else, over MCP or a plain JSON API. |
Use it from another agent
ahpc mcp gives the sessions on your host to an MCP client. For Claude Code:
claude mcp add ahp -- ahpc --host ws://127.0.0.1:9187 mcp
Claude Desktop, VS Code, Windows, remote hosts and the HTTP API are in Tool server.
Documentation
The full docs are at ahpio.github.io/ahpc, and their source is in docs/:
- Get started, Connect, Configure
- Screen, New session, Session, Keys, Commands, Tool server, Recording
- One page per subject: Sessions, Turns, Changes, Automations and more
- Reference: CLI, MCP tools, Environment, Config file
AHP support
All 30 client-to-server requests are implemented, and 21 of the 45 client-dispatchable actions are used. Nine of the ten server-initiated methods are implemented; createResourceWatch is not. docs/CONFORMANCE.md covers the full surface.
Development
The layout, the checks and how a release is published are in DEVELOPER.md.
git clone https://github.com/ahpio/ahpc
cd ahpc
npm install
npm test
npm run docs:dev # the docs site, at http://localhost:5173/ahpc/
License
MIT.
ahpc MCP questions
Does ahpc run agents or models?
No, ahpc is strictly a client and requires an AHP-compatible host to connect to.
What can I manage on an AHP host using ahpc?
You can list, create, configure, archive, and delete sessions, as well as manage turns, chats, files, and terminals.