<h4 align="center">Golang-based MCP server connecting to Nomad</h4>
MCP Nomad MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Golang-based MCP server connecting to Nomad.
Once MCP Nomad is connected, these are the calls the assistant has available:
NOMAD_ADDR — Nomad HTTP API address (default: http://localhost:4646)NOMAD_TOKEN — Nomad ACL token (optional)NOMAD_REGION — forwarded as the REST region query parameter when callers do not override it (multi-region clusters)NOMAD_NAMESPACE — default namespace for tools that accept an optional namespace when the tool omits itTLS — NOMAD_CACERT, NOMAD_SKIP_VERIFY, NOMAD_TLS_SERVER_NAME (see utils/client.go / buildTLSConfig)Prerequisite — Node.jsYou will need 3 environment variables: NOMAD_TOKEN, NOMAD_ADDR, NOMAD_REGION. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
@kocierik/mcp-nomad on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. MCP Nomad's toolset — NOMAD_ADDR, NOMAD_TOKEN, NOMAD_REGION and 3 more — is a fair guide to whether it matches your workflow. It is maintained by kocierik; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| NOMAD_ADDR | Nomad HTTP API address (default: http://localhost:4646) |
| NOMAD_TOKEN | Nomad ACL token (optional) |
| NOMAD_REGION | forwarded as the REST region query parameter when callers do not override it (multi-region clusters) |
| NOMAD_NAMESPACE | default namespace for tools that accept an optional namespace when the tool omits it |
| TLS | NOMAD_CACERT, NOMAD_SKIP_VERIFY, NOMAD_TLS_SERVER_NAME (see utils/client.go / buildTLSConfig) |
| Prerequisite | Node.js |
{
"mcpServers": {
"nomad": {
"command": "npx",
"args": ["-y", "@kocierik/mcp-nomad"],
"env": {
"NOMAD_TOKEN": "your-value",
"NOMAD_ADDR": "your-value",
"NOMAD_REGION": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| NOMAD_TOKEN | Credential the server authenticates with. | Yes |
| NOMAD_ADDR | Configuration value read at startup. | Optional |
| NOMAD_REGION | Configuration value read at startup. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.