hydra-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HYDRA_URL | No | URL of a single Hydra instance used when no config file is present. | https://hydra.nixos.org |
| HYDRA_USERNAME | No | Username for the single Hydra instance used when no config file is present. | |
| HYDRA_MCP_CONFIG | No | Path to the Hydra MCP TOML configuration file. Used instead of the default ~/.config/hydra-mcp/config.toml or the --config option. | |
| HYDRA_PASSWORD_FILE | No | Path to the password file for the single Hydra instance used when no config file is present. |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_instancesA | List the configured Hydra instances, the default one and whether each can log in for write tools. |
| list_projectsB | List the projects of a Hydra instance with their jobsets. |
| get_projectA | Get one project's settings and the state of each of its jobsets (errors, last evaluation). |
| get_jobsetB | Get a jobset's configuration, evaluation state and errors, plus its most recent evaluations. |
| list_evalsA | List a jobset's evaluations, newest first, one page at a time. |
| get_evalA | Get an evaluation: its inputs, build counts by status and its builds (filter by status). status: all, failed (finished, not succeeded), succeeded or queued (not finished yet). |
| get_buildA | Get a build: status, timing, derivation, outputs, products, metrics and its build steps. steps="relevant" (default) lists failed and running steps plus the newest few; "all" lists every step (large for big closures). Failed steps name the dependency behind "dependency failed". |
| get_build_logA | Get the last lines of a build's log, or of one of its build steps (e.g. the failed dependency). |
| get_jobB | Get a job's build in the jobset's newest evaluation (any status) and its latest successful build. |
| get_queueB | Get the build queue (highest priority first), its size by jobset, and the builds running right now. |
| searchB | Search projects, jobsets, jobs and builds (by name, output or derivation path). |
| trigger_evaluationA | Ask Hydra to evaluate a jobset soon (needs restart rights on the project). force re-evaluates even if inputs are unchanged. |
| restart_buildB | Re-queue a finished build (needs restart rights). |
| cancel_buildA | Cancel a queued or running build (needs cancel rights). Confirm with the user first. |
| bump_buildB | Move a queued build to the front of the queue (needs bump rights). |
| manage_evalA | Restart an evaluation's failed or aborted builds, cancel its queued builds, or bump them to the front. cancel is destructive: confirm with the user first. |
| put_projectA | Create a project, or change the given fields of an existing one (others keep their values). Creating needs the create-projects role; editing needs project ownership. |
| put_jobsetA | Create a jobset, or change the given fields of an existing one (others keep their values). Give |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| debug_jobset | Find out why a jobset's evaluation or builds fail. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 18 tools
Most tools target a distinct resource+action (project, jobset, eval, build, queue, log), and descriptions clarify the read vs write split. There is mild overlap between the single-build write tools (restart_build, cancel_build, bump_build) and the bulk manage_eval, and between get_job and get_build, but the descriptions make the intended selection clear.
Nearly all tools follow verb_noun snake_case (list_projects, get_build, trigger_evaluation, cancel_build), which is predictable. Minor deviations are the bare 'search' (no noun) and the vague 'manage_eval', plus 'put_*' being used for create-or-update semantics.
18 tools is on the heavy side but each maps to a real Hydra concept (instances, projects, jobsets, evals, builds, queue, logs, search) plus a small write set. Nothing looks redundant enough to cut, though the read surface could be consolidated slightly.
Coverage is strong for the CI lifecycle: discovery, project/jobset inspection and editing, evaluations, builds, logs, queue control, and build restart/cancel/bump. Gaps are minor—no delete operations for projects, jobsets, or builds, and no tool to fetch build output/product contents beyond the log tail.