
A nomad MCP Server (modelcontextprotocol)
A nomad MCP Server (modelcontextprotocol)
·
Quick start ⚙ Tools ⚙ Configuration ⚙ HTTP mode ⚙ Development ↗ ⚙ About MCP ↗
mcp-nomad lets AI assistants such as Claude inspect and operate a HashiCorp Nomad cluster: jobs, allocations, logs, nodes, variables, ACLs and more.
https://github.com/user-attachments/assets/731621d7-0acf-4045-bacc-7b34a7d83648
Add the server to claude_desktop_config.json (requires Node.js):
{
"mcpServers": {
"mcp_nomad": {
"command": "npx",
"args": ["-y", "@kocierik/mcp-nomad"],
"env": {
"NOMAD_ADDR": "http://127.0.0.1:4646",
"NOMAD_TOKEN": "<your-nomad-acl-token>"
}
}
}
}Add "-read-only" to args to expose only tools that cannot change the cluster.
Other ways to install; then use "command": "mcp-nomad" with the same env:
npm install -g @kocierik/mcp-nomadgo install github.com/kocierik/mcp-nomad@latest| Area | Read | Write |
|---|---|---|
| Jobs | list_jobs, get_job, get_job_summary, get_job_allocations, get_job_evaluations, get_evaluation, get_job_deployments, get_job_services | run_job, stop_job, scale_job |
| Deployments | list_deployments, get_deployment | |
| Allocations | list_allocations, get_allocation, get_allocation_logs | stop_allocation |
| Nodes | list_nodes, get_node | drain_node, eligibility_node |
| Namespaces | list_namespaces | create_namespace, delete_namespace |
| Variables | list_variables, get_variable | create_variable, delete_variable |
| Volumes | list_volumes, get_volume | delete_volume |
| ACL | list_acl_tokens, get_acl_token, list_acl_policies, get_acl_policy, list_acl_roles, get_acl_role | create_acl_token, delete_acl_token, create_acl_policy, delete_acl_policy, create_acl_role, delete_acl_role, bootstrap_acl_token |
| Sentinel | list_sentinel_policies, get_sentinel_policy | create_sentinel_policy, delete_sentinel_policy |
| Cluster | get_cluster_leader, list_cluster_peers, list_regions |
With -read-only the write column is not available at all. Whatever the mode, the Nomad ACLs attached to NOMAD_TOKEN decide what is actually allowed: use a token with only the permissions you want the assistant to have.
The server also provides resources (job specs and history, node status, allocation status and logs) and prompts.
| Variable | Purpose |
|---|---|
NOMAD_ADDR | Nomad API address (default http://127.0.0.1:4646) |
NOMAD_TOKEN | Nomad ACL token |
NOMAD_NAMESPACE | Default namespace when a request does not specify one |
NOMAD_REGION | Default region for multi-region clusters |
NOMAD_CACERT, NOMAD_TLS_SERVER_NAME, NOMAD_SKIP_VERIFY | TLS to Nomad |
NOMAD_CLIENT_CERT, NOMAD_CLIENT_KEY | Mutual TLS to Nomad |
| Flag | Default | Purpose |
|---|---|---|
-transport | stdio | stdio, sse or streamable-http |
-read-only | off | Only register tools that cannot change the cluster |
-port | 8080 | HTTP port |
-listen-address | 127.0.0.1 | HTTP listen address |
Claude Desktop uses stdio and needs nothing from this section.
The sse and streamable-http transports are protected by a bearer token, separate from the Nomad token:
export MCP_TOKEN="<choose-a-long-random-token>"
mcp-nomad -transport=streamable-httpAuthorization: Bearer <MCP_TOKEN>; the server refuses to start without it.127.0.0.1 only. Use -listen-address=0.0.0.0 (for example in Docker) only behind a trusted network or HTTPS reverse proxy.MCP_ALLOWED_ORIGINS (comma-separated, e.g. http://localhost:6274).Details: SECURITY.md.
Upgrading from 0.3.x: HTTP transports now require
MCP_TOKENand listen on127.0.0.1by default.
npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomadTo test HTTP mode, start the server as shown above with MCP_ALLOWED_ORIGINS="http://localhost:6274", open http://localhost:8080/mcp in the Inspector and enter MCP_TOKEN as the bearer token.
MIT, see LICENSE.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add mcp_nomad -- npx -y @kocierik/mcp-nomad{
"mcpServers": {
"mcp_nomad": {
"env": {
"NOMAD_ADDR": "",
"NOMAD_TOKEN": ""
},
"args": [
"-y",
"@kocierik/mcp-nomad"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"mcp_nomad","env":{"NOMAD_ADDR":"","NOMAD_TOKEN":""},"args":["-y","@kocierik/mcp-nomad"],"command":"npx"}'[mcp_servers.mcp_nomad]
command = "npx"
args = ["-y", "@kocierik/mcp-nomad"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/mcp-nomad to learn what the "Mcp Nomad" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomadThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its npm package has not answered in our offline sandbox, which usually means it needs an API key or other configuration to start. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/mcp-nomad)Nothing comparable is listed yet.
v0.4.0Release notesv0.3.2Release notesv0.3.1Release notesv0.3.0Release notesv0.2.9Release notesv0.2.8Release notesv0.2.7Release notesv0.2.6Release notesv0.2.5Release notesv0.2.4Release notesv0.2.3Release notesv0.2.2Release notesv0.2.1Release notesv0.2.0Release notesv0.1.11Release notesv0.1.10Release notesv0.1.9Release notesv0.1.8Release notesv0.1.6Release notesv0.1.4v0.1.4 - Initial ReleaseRelease notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "mcp-nomad" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.