Hatchet MCP server
io.github.ElliotPadfield/hatchet-mcp·v0.1.1·1 starsObserve and operate Hatchet workflows from an AI agent — runs, logs, trigger, cancel, replay.
1 stars44 downloads/wk
Reviews
Write oneNobody has reviewed Hatchet yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Hatchet tools (10, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
cancel_runswrite actionMUTATES LIVE STATE. Cancel one or more runs/tasks by external id.
get_queue_metricsGet task/queue metrics for the tenant (queue health).
get_runwrite actionGet the full detail of one workflow run (status, tasks, errors) by its external id.
get_run_logswrite actionGet log lines for a task by its external id.
list_runsList recent workflow/task runs. Filters: status, workflow ids, time window. Defaults to the last 24h if 'since' is omitted.
list_workersList workers and their status.
list_workflowsList workflow definitions for the tenant.
replay_runsMUTATES LIVE STATE. Replay/retry one or more runs/tasks by external id.
trigger_workflowMUTATES LIVE STATE. Trigger a new workflow run by name with a JSON input payload.
whoamiShow the resolved Hatchet tenant + server URL and confirm the token works.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 34 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Hatchet compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 4,460 AI and agents servers
- Tools
- 10
- the typical AI and agents server has 6
- Tools that change things
- 30%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 50% of 2,711 AI and agents servers
- Downloads a week
- 44
- more than 36% of 1,538 AI and agents servers with a package
What its tools let an agent do: 6 read · 2 change · 1 delete · 1 run or deploy
Install Hatchet in Claude Code, Cursor or VS Code
Runs npx -y hatchet-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add hatchet-mcp -- npx -y hatchet-mcp
What the publisher says
From the Hatchet repository's README, as published. We do not edit it. Read it on GitHub
hatchet-mcp
An MCP server that lets AI agents observe and operate Hatchet workflows — status, runs, logs, workers, and metrics, plus trigger / cancel / replay.
Why: Hatchet has a great API but no MCP. This wraps it so agents (Claude Code / Desktop, etc.) can see and act on workflow state.
Install
Add this to your Claude Code / Claude Desktop MCP config:
{
"mcpServers": {
"hatchet": {
"command": "npx",
"args": ["-y", "hatchet-mcp"],
"env": { "HATCHET_CLIENT_TOKEN": "<your-hatchet-api-token>" }
}
}
}Get the token from the Hatchet dashboard → API tokens. The token is a JWT that encodes the server URL and tenant, so it's the only required setting.
Configuration
Self-hosting? Set HATCHETAPIBASE to your own Hatchet instance and it works anywhere.
Tools
Observability (read-only)
Actions (mutate live state)
Safety
The read tools (whoami, listworkflows, listruns, getrun, getrunlogs, listworkers, getqueuemetrics) are non-destructive.
triggerworkflow, cancelruns, and replayruns mutate live state** — their descriptions are prefixed MUTATES LIVE STATE so agents and users know they affect real runs.
The token grants full tenant access — treat it as a secret. Never commit it to source control.
Development
pnpm install
pnpm test # vitest
pnpm build # tsup -> dist/index.jsTypeScript / ESM, tested with vitest.
Status
v0.1.0 — all tools verified against Hatchet Cloud; works with self-hosted instances via HATCHETAPIBASE. trigger_workflow uses the stable /workflow-runs/trigger endpoint.
Nothing above is checked by us. What we check is on the safety report.
Hatchet: common questions
- Is Hatchet MCP server safe?
- Mostly: it is graded B (78/100). Read the Hatchet safety report
- How do I install Hatchet?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Hatchet need an API key?
- Yes. The registry entry asks for
HATCHET_CLIENT_TOKEN. - Is Hatchet maintained?
- The last commit was 72 days ago (2026-08-24). The latest release is v0.1.1.
- What can I use instead of Hatchet?
- Servers from other publishers that do the same job: Superlog MCP server, Orcareplay MCP server and IWE (iwe.md) MCP server.
- How does Hatchet compare with other AI and agents MCP servers?
- safety score 78/100 (higher than 57% of 4,460 AI and agents servers); tools 10 (the typical AI and agents server has 6); tools that change things 30% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Hatchet
Same job from other publishers: the closest match first, then the best rated.
- SuperlogOpen-source agent that observes and fixes your application. Query logs, traces, metrics, incidents.not reviewedEstablishedA
- OrcareplayRead, replay and fork recorded coding-agent runs.not reviewedEstablishedA
- IWE (iwe.md)Markdown knowledge base as agent memory. Runs against the notes directory it is started in.not reviewedEstablishedA
- MockserverMock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.not reviewedEstablishedA
- EmuloMine your AI coding session logs into a you.md profile with dated receipts, for an agent to read.not reviewedEstablishedA