HashiCorp Nomad MCP

DevOpsstdio
Repository

A Model Context Protocol server for HashiCorp Nomad that lets AI agents inspect and operate a Nomad cluster. Supports listing jobs, allocations, and nodes, reading allocation logs, and submitting or stopping jobs, which helps with debugging scheduling issues and running day-to-day workload operations.

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "nomad": {
      "command": "npx",
      "args": [],
      "env": {
        "NOMAD_ADDR": "<YOUR_NOMAD_ADDR>",
        "NOMAD_TOKEN": "<YOUR_NOMAD_TOKEN>"
      }
    }
  }
}

Tools (3)

list_jobs

List jobs registered in the Nomad cluster.

{
  "type": "object",
  "properties": {
    "namespace": {
      "type": "string",
      "description": "Optional Nomad namespace"
    }
  }
}

get_allocation_logs

Read stdout or stderr logs for an allocation.

{
  "type": "object",
  "required": [
    "alloc_id"
  ],
  "properties": {
    "task": {
      "type": "string",
      "description": "Task name within the allocation"
    },
    "alloc_id": {
      "type": "string",
      "description": "Allocation identifier"
    }
  }
}

stop_job

Stop a running job.

{
  "type": "object",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Job identifier to stop"
    }
  }
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server information

Author
kocierik (@kocierik)
Repository
https://github.com/kocierik/mcp-nomad
License
MIT
Stars
0
Last updated
July 28, 2026