Hatchet MCP
About
MCP server for Hatchet — let AI agents observe and operate your workflows: runs, logs, workers, metrics, plus trigger/cancel/replay. Single-token setup, npx-installable.
Details
- Author
- ElliotPadfield
- GitHub stars
- 1
- Downloads
- 276
- Categories
- Cloud Service, Automation, Infrastructure, Developer Tools
Jump to
- Read-only observability tools for workflows, runs, logs, workers, and queue metrics
- Action tools to trigger, cancel, and replay workflow runs
- Single environment variable (HATCHET_CLIENT_TOKEN) encodes server URL and tenant
- Works with Hatchet Cloud and self-hosted instances via HATCHET_API_BASE
- Built with TypeScript and ESM, tested with vitest
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Hatchet MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Add the server to your MCP configuration using npx -y hatchet-mcp with the required environment variable HATCHET_CLIENT_TOKEN (obtained from the Hatchet dashboard under API tokens). Optionally set HATCHET_API_BASE for self-hosted instances and HATCHET_TENANT_ID to override the tenant decoded from the token. Once configured, agents can invoke the provided tools to interact with Hatchet workflows.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"hatchet mcp": {
"hatchet": {
"command": "npx",
"args": [
"-y",
"hatchet-mcp"
],
"env": {
"HATCHET_CLIENT_TOKEN": "<your-hatchet-api-token>"
}
}
}
}
}McpServers
{
"hatchet": {
"command": "npx",
"args": [
"-y",
"hatchet-mcp"
],
"env": {
"HATCHET_CLIENT_TOKEN": "<your-hatchet-api-token>"
}
}
}An MCP server that lets AI agents observe and operateHatchetworkflows — 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.
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.
Self-hosting? SetHATCHET_API_BASEto your own Hatchet instance and it works anywhere.
The read tools (whoami,list_workflows,list_runs,get_run,get_run_logs,list_workers,get_queue_metrics) are non-destructive.
trigger_workflow,cancel_runs, andreplay_runsmutate live state— their descriptions are prefixedMUTATES LIVE STATEso 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.
pnpm install pnpm test # vitest pnpm build # tsup -> dist/index.js
v0.1.0 — all tools verified against Hatchet Cloud; works with self-hosted instances viaHATCHET_API_BASE.trigger_workflowuses the stable/workflow-runs/triggerendpoint.
Manage and observe Prefect workflows through natural language.
MCP server for catching cron silent failures — jobs that exit 0 with empty output, retry storms, action-budget leaks. 6 silent-fail patterns across system cron, systemd timers, OpenClaw cron logs.
Provides comprehensive Datadog monitoring capabilities through MCP clients. Requires Datadog API and Application keys.
Scout's official MCP pipes error, trace and metric data from production to your AI agent
Interact with Apache Airflow using natural language to manage and monitor your data workflows.
Stateful health monitoring, diagnostics, and web attestation for AI agents. 11 MCP tools. Free Founder's Beta
Paid remote MCP for CLI tool MCP, structured receipts, usage logs, and audit-ready evidence for agent and CI workflows.
Remote MCP server that gives your AI agent a dead-man's-switch: it calls create_heartbeat, pings on schedule, and emails you the instant an agent or cron loop stops checking in.
MCP server for the Enoch control plane: dispatch gates, evidence sync, provenance, and quality gates for long-running autonomous AI work.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
