nomad-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOMAD_ADDR | No | Nomad HTTP API address | http://127.0.0.1:4646 |
| NOMAD_TOKEN | No | ACL token, sent as X-Nomad-Token | |
| NOMAD_CACERT | No | Path to a CA bundle for a private/internal CA | |
| NOMAD_NAMESPACE | No | Default namespace applied when a tool call doesn't specify one | |
| NOMAD_SKIP_VERIFY | No | Skip TLS certificate verification | false |
| NOMAD_MCP_WRITE_MODE | No | Enable write tools (set to 'on' to enable) | |
| NOMAD_MCP_WRITE_TOOLS | No | Comma-separated list of specific write tools to allow (e.g. 'stop_job,scale_task_group') |
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": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_jobsA | List Nomad jobs, optionally filtered by name prefix and namespace. |
| get_jobA | Get the full spec and status of a single Nomad job by ID. |
| get_job_allocationsB | List allocations belonging to a job. |
| get_job_deploymentsC | List deployments for a job. |
| get_job_evaluationsA | List evaluations for a job (useful for diagnosing why a job isn't placing). |
| get_allocationB | Get details of a single allocation, including task states and events. |
| get_allocation_logsA | Fetch recent stdout/stderr log output for a task in an allocation. |
| list_nodesA | List client nodes in the Nomad cluster. |
| get_nodeA | Get details of a single Nomad client node, including allocations and resource usage. |
| list_deploymentsC | List recent deployments across the cluster. |
| get_deploymentC | Get details of a single deployment. |
| list_namespacesA | List Nomad namespaces. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Every tool maps to a distinct resource and scope, with list_ and get_ clearly separating collection vs single-detail operations. Potentially similar tools like get_job_deployments and list_deployments are disambiguated by job-scoped vs cluster-scoped descriptions.
All tools follow a consistent list_/get_ + resource noun pattern in snake_case. Singular resources use get_, plural resources use list_, and job-scoped variants like get_job_allocations are predictable.
Twelve tools provide well-scoped coverage of Nomad's main observable resources: jobs, allocations, deployments, nodes, and namespaces. There is no obvious redundancy, and each tool serves a distinct inspection or diagnostic purpose.
As a read-only observability toolset, it covers the key Nomad resources needed for inspecting jobs, allocations, deployments, evalutions, and nodes. Minor gaps like no cluster-wide allocation list, no single evaluation detail, and no write/lifecycle operations prevent a perfect score if full Nomad management is expected.