HashiCorp Nomad HTTP API
The HashiCorp Nomad HTTP API provides programmatic access to all Nomad functionality including job scheduling, allocation management, node operations, deployments, services, evaluations, namespaces, ACL policies, and cluster status. All API routes are prefixed with /v1/ and the default port is 4646. The API is RESTful, responds to standard HTTP verbs, and supports ACL token authentication via the X-Nomad-Token header or Bearer scheme.
What You Can Do
MCP Tools
listjobs
List jobs
registerjob
Register a new job
parsejob
Parse a job specification
listjobstatuses
List job statuses
readjob
Read a job
deregisterjob
Deregister a job
evaluatejob
Create a new evaluation for a job
planjob
Plan a job update
listjoballocations
List allocations for a job
listjobevaluations
List evaluations for a job
listjobdeployments
List deployments for a job
listjobversions
List versions of a job
revertjob
Revert job to an older version
setjobstability
Set job stability
readjobsummary
Read a job summary
dispatchjob
Dispatch a parameterized job
listallocations
List allocations
readallocation
Read an allocation
listallocationservices
List allocation services
listallocationchecks
List allocation health checks
listevaluations
List evaluations
countevaluations
Count evaluations
readevaluation
Read an evaluation
listevaluationallocations
List allocations for an evaluation
listdeployments
List deployments
readdeployment
Read a deployment
listdeploymentallocations
List deployment allocations
faildeployment
Fail a deployment
pausedeployment
Pause or resume a deployment
promotedeployment
Promote a deployment
listnodes
List nodes
readnode
Read a node
evaluatenode
Create a new evaluation for a node
drainnode
Set node drain mode
purgenode
Purge a node
listnodepools
List node pools
createnodepool
Create or update a node pool
readnodepool
Read a node pool
deletenodepool
Delete a node pool
listservices
List services
readservice
Read a service
deleteservice
Delete a service registration
listvolumes
List volumes
listnamespaces
List namespaces
createnamespace
Create or update a namespace
readnamespace
Read a namespace
deletenamespace
Delete a namespace
listaclpolicies
List ACL policies
readaclpolicy
Read an ACL policy
upsertaclpolicy
Create or update an ACL policy
deleteaclpolicy
Delete an ACL policy
listacltokens
List ACL tokens
createacltoken
Create an ACL token
readselfacltoken
Read own ACL token
readacltoken
Read an ACL token
deleteacltoken
Delete an ACL token
listagentmembers
List agent members
readagentself
Read agent self
joinagent
Join an agent
forceleaveagent
Force leave an agent