Nomad MCP Server

@kocierik

About Nomad MCP Server

A nomad MCP Server (modelcontextprotocol)

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "nomad-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@kocierik/mcp-nomad"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Nomad MCP Server?

A Golang-based MCP server that connects to HashiCorp Nomad, enabling Claude Desktop and other MCP clients to interact with Nomad resources such as jobs, allocations, and cluster information.

How to use Nomad MCP Server?

Install via npm (npx -y @kocierik/mcp-nomad), download a pre-built binary from GitHub Releases, or build from source with Go. Configure Claude Desktop by adding an entry to claude_desktop_config.json with the mcp-nomad command and environment variables (e.g., NOMAD_ADDR, NOMAD_TOKEN).

Key features of Nomad MCP Server

Supports stdio, SSE, and Streamable HTTP transports
Configurable via command-line flags and environment variables
Environment variables for Nomad address, token, region, namespace, and TLS
Pre-built npm package and binary releases for easy setup
MCP Inspector integration for local testing and debugging
Implements a clean interface-based tool architecture

Use cases of Nomad MCP Server

Monitor Nomad job status and allocation details from a chat interface
Manage Nomad clusters without leaving the Claude Desktop environment
Automate common Nomad operations using natural language commands
Explore Nomad resources and evaluate cluster health quickly

FAQ from Nomad MCP Server

What dependencies are required?

Node.js is needed only if using the npm-based installation. Pre-built binaries have no runtime dependencies. Building from source requires Go.

What environment variables must be set?

NOMAD_ADDR is required (default http://localhost:4646). NOMAD_TOKEN is optional for authenticated clusters. NOMAD_REGION, NOMAD_NAMESPACE, and TLS variables (NOMAD_CACERT, NOMAD_SKIP_VERIFY, NOMAD_TLS_SERVER_NAME) are also recognized.

How do I change the transport type?

Use the -transport flag (options: stdio, sse, streamable-http) when starting the server. Default is stdio.

Can I test the server before using it with Claude?

Yes – run npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomad to launch the MCP Inspector connected to the server for debugging.

Does the server support TLS connections to Nomad?

Yes. Set the environment variables NOMAD_CACERT, NOMAD_SKIP_VERIFY, and NOMAD_TLS_SERVER_NAME to configure TLS for the Nomad HTTP client.

Frequently asked questions

What dependencies are required?

Node.js is needed only if using the npm-based installation. Pre-built binaries have no runtime dependencies. Building from source requires Go.

What environment variables must be set?

`NOMAD_ADDR` is required (default `http://localhost:4646`). `NOMAD_TOKEN` is optional for authenticated clusters. `NOMAD_REGION`, `NOMAD_NAMESPACE`, and TLS variables (`NOMAD_CACERT`, `NOMAD_SKIP_VERIFY`, `NOMAD_TLS_SERVER_NAME`) are also recognized.

How do I change the transport type?

Use the `-transport` flag (options: `stdio`, `sse`, `streamable-http`) when starting the server. Default is `stdio`.

Can I test the server before using it with Claude?

Yes – run `npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomad` to launch the MCP Inspector connected to the server for debugging.

Does the server support TLS connections to Nomad?

Yes. Set the environment variables `NOMAD_CACERT`, `NOMAD_SKIP_VERIFY`, and `NOMAD_TLS_SERVER_NAME` to configure TLS for the Nomad HTTP client.

Comments

Basic information

More Other MCP servers

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep