hatchet-mcp MCP Server

An MCP server that lets AI agents observe and operate Hatchet workflows — status, runs, logs, workers, and metrics, plus trigger / cancel / replay.

Local serverstdioMIT

What is the hatchet-mcp Server?

hatchet-mcp is an MCP project maintained in the elliotpadfield/hatchet-mcp repository. The maintainer describes its purpose as “An MCP server that lets AI agents observe and operate Hatchet workflows — status, runs, logs, workers, and metrics, plus trigger / cancel / replay”. Read the project documentation for the complete scope.

Installation

The documented npm package is hatchet-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares HATCHET_CLIENT_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
whoamiShow the resolved Hatchet tenant + server URL and confirm the token works.
list_workflowsList workflow definitions for the tenant.
list_runsList workflow runs (with an optional lookback window and filters).
get_runGet the full detail of one workflow run — status, tasks, errors.
get_run_logsGet log lines for a task by its external id.
list_workersList workers and their status.
get_queue_metricsGet task/queue metrics for the tenant (queue health).
trigger_workflowTrigger a new workflow run by name with a JSON input payload.
cancel_runsCancel one or more runs/tasks by external id.
replay_runsReplay/retry one or more runs/tasks by external id.

How to install the hatchet-mcp Server

{
  "mcpServers": {
    "hatchet": {
      "command": "npx",
      "args": [
        "-y",
        "hatchet-mcp"
      ],
      "env": {
        "HATCHET_CLIENT_TOKEN": "YOUR_HATCHET_CLIENT_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
HATCHET_CLIENT_TOKENDeclared in the maintainer’s client configuration.Yes