Mcp Nomad

@kocierik

About Mcp Nomad

A nomad MCP Server (modelcontextprotocol)

Config

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

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mcp Nomad?

Mcp Nomad is a Golang-based MCP server that connects to HashiCorp Nomad, a cluster scheduler. It enables LLM clients like Claude Desktop to interact with Nomad through MCP tools. The server supports multiple installation methods: prebuilt npm package, GitHub releases binary, or building from source.

How to use Mcp Nomad?

Install via npx @kocierik/mcp-nomad, or download a release binary, or build from source with Go. Configure Claude Desktop by adding the server to claude_desktop_config.json with the appropriate command and environment variables (NOMAD_ADDR and NOMAD_TOKEN). Optionally set NOMAD_REGION, NOMAD_NAMESPACE, and TLS-related env vars. The server can run on stdio (default), SSE, or Streamable HTTP transport.

Key features of Mcp Nomad

Three installation options: npm, GitHub releases, or source build
Supports stdio, SSE, and Streamable HTTP transport types
Configurable via environment variables and command-line flags
TLS support with CACERT, skip verify, and server name
Uses official Nomad HTTP API with typed helper functions
Safe API calls via an allow-list for direct requests

Use cases of Mcp Nomad

Manage Nomad jobs and allocations through natural language in Claude Desktop
Query cluster status, such as node health and allocation details
Perform Nomad operations (stop, restart, inspect) without leaving the chat interface

FAQ from Mcp Nomad

What transport types does Mcp Nomad support?

stdio (default), SSE, and Streamable HTTP. Use the -transport flag to change.

How do I point Mcp Nomad to my Nomad server?

Set the NOMAD_ADDR environment variable or use the -nomad-addr flag. Default is http://localhost:4646.

What are the prerequisites for installing Mcp Nomad?

For the npm package, Node.js is required. The GitHub release binary has no prerequisites. Building from source requires a working Go installation.

How can I test Mcp Nomad locally?

Run the MCP Inspector with npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomad. For Streamable HTTP or SSE, start the binary with -transport=sse or -transport=streamable-http and use the Inspector with the appropriate URL.

Does Mcp Nomad support authentication and TLS?

Yes. Provide a Nomad ACL token via NOMAD_TOKEN, and configure TLS with NOMAD_CACERT, NOMAD_SKIP_VERIFY, and NOMAD_TLS_SERVER_NAME environment variables.

Frequently asked questions

What transport types does Mcp Nomad support?

stdio (default), SSE, and Streamable HTTP. Use the `-transport` flag to change.

How do I point Mcp Nomad to my Nomad server?

Set the `NOMAD_ADDR` environment variable or use the `-nomad-addr` flag. Default is `http://localhost:4646`.

What are the prerequisites for installing Mcp Nomad?

For the npm package, Node.js is required. The GitHub release binary has no prerequisites. Building from source requires a working Go installation.

How can I test Mcp Nomad locally?

Run the MCP Inspector with `npx @modelcontextprotocol/inspector npx @kocierik/mcp-nomad`. For Streamable HTTP or SSE, start the binary with `-transport=sse` or `-transport=streamable-http` and use the Inspector with the appropriate URL.

Does Mcp Nomad support authentication and TLS?

Yes. Provide a Nomad ACL token via `NOMAD_TOKEN`, and configure TLS with `NOMAD_CACERT`, `NOMAD_SKIP_VERIFY`, and `NOMAD_TLS_SERVER_NAME` environment variables.

Comments

Basic information

More Other MCP servers

Production-ready MCP integrations for AI applications

Klavis-AI

Klavis AI: MCP integration platforms that let AI agents use tools reliably at any scale

5.8K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K