MCP.Market

Hatchet MCP server

by ElliotPadfield·io.github.ElliotPadfield/hatchet-mcp·v0.1.1·1 stars

Observe and operate Hatchet workflows from an AI agent — runs, logs, trigger, cancel, replay.

B78/100grade B
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
New

1 stars44 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • cancel_runswrite action

    MUTATES LIVE STATE. Cancel one or more runs/tasks by external id.

  • get_queue_metrics

    Get task/queue metrics for the tenant (queue health).

  • get_runwrite action

    Get the full detail of one workflow run (status, tasks, errors) by its external id.

  • get_run_logswrite action

    Get log lines for a task by its external id.

  • list_runs

    List recent workflow/task runs. Filters: status, workflow ids, time window. Defaults to the last 24h if 'since' is omitted.

  • list_workers

    List workers and their status.

  • list_workflows

    List workflow definitions for the tenant.

  • replay_runs

    MUTATES LIVE STATE. Replay/retry one or more runs/tasks by external id.

  • trigger_workflow

    MUTATES LIVE STATE. Trigger a new workflow run by name with a JSON input payload.

  • whoami

    Show 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

no findings
  • 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
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.js

TypeScript / 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.

  • Superlog
    Open-source agent that observes and fixes your application. Query logs, traces, metrics, incidents.
    A
  • Orcareplay
    Read, replay and fork recorded coding-agent runs.
    A
  • IWE (iwe.md)
    Markdown knowledge base as agent memory. Runs against the notes directory it is started in.
    A
  • Mockserver
    Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.
    A
  • Emulo
    Mine your AI coding session logs into a you.md profile with dated receipts, for an agent to read.
    A