Skip to main content
Glama
aelaguiz

herdr-mcp

by aelaguiz
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HERDR_BINNoPath to the herdr binary.herdr
HERDR_SESSIONNoHerdr session identifier.
HERDR_SOCKET_PATHNoPath to the Herdr session socket.
HERDR_MCP_LOG_LEVELNoPython log level (stderr).WARNING

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_workspacesA

List Herdr workspaces with their ids, labels, and aggregate agent status.

Workspace ids look like `w17`. Start here to orient in the session.
list_tabsA

List tabs across the session. Tab ids look like w17:t1.

list_panesA

List every pane with its id, workspace, tab, cwd, title, and agent status.

Pane ids look like `w17:p1` and are the target of every pane tool.
list_agentsA

List panes running a detected coding agent, with agent kind and status.

Status is one of idle, working, blocked, done, unknown. Agents are addressed
by pane id (`w17:p1`) or by their agent name.
get_agentA

Show one agent's current state.

target: a pane id like `w17:p1` or an agent name; get them from list_agents.
read_paneA

Read a pane's terminal output as plain text.

pane: pane id like `w17:p1` (see list_panes / list_agents).
lines: keep only the last N lines of the snapshot.
source: visible (what the user sees), recent (default scrollback tail),
recent-unwrapped (recent without soft wrapping), detection (bottom buffer
used for agent detection).
Note: herdr may return an empty string for source=recent with lines set on
panes with short scrollback; if that happens, retry without lines or with
source="visible".
prompt_agentA

Submit a prompt to an agent pane (types the text and submits it).

target: pane id like `w17:p1` or an agent name; see list_agents.
wait: also wait for the agent to settle (idle, done, or blocked) afterwards.
timeout_ms: only used with wait=True; the call fails if nothing matches in time.
wait_agentA

Wait until an agent reaches one of the requested states.

target: pane id like `w17:p1` or an agent name.
until: any of idle, working, blocked, done, unknown. Default: idle, done, blocked.
timeout_ms: the call fails if no requested state is observed in time.
send_textA

Send literal text to a pane without pressing Enter.

pane: pane id like `w17:p1`. Use run_command to send a command and Enter.
send_keysA

Send key presses to a pane, e.g. ["enter"], ["esc"], ["ctrl-c"].

pane: pane id like `w17:p1`. Keys are sent in order; use `esc` for Escape.
run_commandA

Run a shell command in a pane (sends the command text and Enter).

pane: pane id like `w17:p1`.
command: argv-style words, e.g. ["git", "status"]. This does not wait for the
command to finish; use wait_for_output or read_pane afterwards.
wait_for_outputA

Wait until a pane's output matches a pattern.

pane: pane id like `w17:p1`.
pattern: literal substring, or a Rust regular expression when regex=True.
The existing snapshot is searched first, then polled until timeout_ms.
source: visible, recent (default), or recent-unwrapped.
split_paneA

Split a pane and return the new pane's id.

pane: pane id like `w17:p1` to split.
direction: right or down.
ratio: fraction of the split given to the new pane, between 0 and 1.
close_paneA

Close a pane and any process running in it. pane: pane id like w17:p1.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored across 14 tools

Disambiguation4/5

Most tools have clearly distinct resource/action pairs (list_panes, list_agents, split_pane, close_pane, wait_agent, wait_for_output). The main ambiguity is among send_text, send_keys, run_command, and prompt_agent, since all deliver input to a pane; the descriptions largely clarify them, but an agent could still misselect send_text vs run_command or prompt_agent when composing an action.

Naming Consistency5/5

Almost every tool follows a clear verb_noun pattern: list_*, get_agent, prompt_agent, wait_agent, send_text, send_keys, run_command, split_pane, close_pane. The plural/singular list_* vs get_ is conventional and predictable, and there are no mixed casing or random names.

Tool Count5/5

14 tools is a well-scoped number for a terminal/agent-orchestration server. Each tool covers a meaningful operation without excessive redundancy or an overwhelming surface.

Completeness4/5

The surface covers orientation, reading output, sending input and keys, running commands, waiting for output/agent state, splitting panes, and closing panes—so core workflows are solid. The main gap is that there is no explicit way to create a new workspace or tab, only split an existing pane, which limits some session-management scenarios.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources