Skip to main content
The HITL MCP server lets an AI assistant run your workflows and wait for a person’s answer, and build workflows for you. It runs locally (@hitl-sh/mcp, with your API key) or remotely at https://mcp.hitl.sh/mcp (sign in through the browser).

​
Set up

This runs claude mcp add hitl -e HITL_API_KEY=… -- npx -y @hitl-sh/mcp with the key from HITL_API_KEY (or the one saved by hitl login). By hand:
Remote, signing in through the browser instead of a key:
then run /mcp in Claude Code and sign in.
The MCP Inspector with one server, npx -y @hitl-sh/mcp, over standard I/O, shown as Connected

The MCP Inspector connected to npx -y @hitl-sh/mcp

​
Run a workflow and see the answer

This walk-through uses the MCP Inspector so you can see each call; in Claude or Cursor the assistant makes the same calls when you ask it to.
1

Find the workflow and its input

list_workflows lists your workflows. get_workflow_input returns the fields the workflow’s steps read, with an example body.
The result of get_workflow_input for the Refund approval workflow: the fields amount, currency, customer.email, customer.name, order_id and reason, and an example body
2

Run it

run_workflow takes the workflow id, the input, and optionally a callback_url and live.
The run_workflow tool in the Inspector with its id, input, callback_url and live fields
It answers at once with the execution, status: running:
The run_workflow result: Workflow run started, with the execution id, workflow Refund approval, status running, finished false and the input for Mary Jackson's $320 refund
3

A person answers

The reviewers get the question on their phone, in the web inbox or in Telegram, and answer.
4

Get the answer

get_execution with the execution id and wait (up to 60 seconds) returns as soon as the run has finished: status: completed, result: "approve", and in decisions who answered (Priya Shah) and where (web_portal).
The get_execution result: status completed, finished true, result approve, a decision by Priya Shah on web_portal, and the webhook action's result
In a chat, all of that is one request: “Run Refund approval for Mary Jackson’s $320 order ORD-48252 and tell me what the reviewer decided.”

​
Tools

Each tool maps to one API endpoint and takes the same fields. Signing up (getting a key) is in the CLI, since the server needs a key to start.

​
Configuration

The key is only sent to hitl.sh hosts.