HashiCorp Nomad HTTP API
The Nomad HTTP API provides full programmatic access to a Nomad cluster. All routes use the /v1/ prefix. Endpoints support managing jobs, nodes, allocations, deployments, and evaluations across on-premises and cloud environments. Authentication uses an ACL token via the X-Nomad-Token header or Bearer authorization.
What You Can Do
MCP Tools
get-jobs
List jobs
post-jobs
Create or register job
post-jobs-parse
Parse HCL jobspec
get-job-job-id
Read job
post-job-job-id
Update job
delete-job-job-id
Deregister job
get-job-job-id-versions
List job versions
get-job-job-id-summary
Read job summary
post-job-job-id-evaluate
Force evaluation
post-job-job-id-plan
Plan job
get-job-job-id-allocations
List job allocations
get-job-job-id-deployments
List job deployments
get-job-job-id-deployment
Read most recent deployment
get-job-job-id-scale
Read scale status
post-job-job-id-scale
Scale task group
get-job-job-id-actions
List task actions
get-nodes
List nodes
get-node-node-id
Read node
get-node-node-id-allocations
List node allocations
post-node-node-id-evaluate
Create node evaluation
post-node-node-id-drain
Toggle node drain
post-node-node-id-purge
Purge node
post-node-node-id-eligibility
Toggle node eligibility
get-allocations
List allocations
get-allocation-alloc-id
Read allocation
get-deployments
List deployments
get-deployment-deployment-id
Read deployment
get-evaluations
List evaluations
get-evaluation-eval-id
Read evaluation
get-namespaces
List namespaces
get-namespace-name
Read namespace
post-namespace-name
Create or update namespace
delete-namespace-name
Delete namespace
get-acl-tokens
List ACL tokens
get-acl-policies
List ACL policies
get-status-leader
Read leader address
get-status-peers
List server peers
get-agent-health
Agent health