# Human Approval - HITL Platform — MCP server on mcp.ai
> Connect your Human Approval - HITL Platform account and use 10 tools for AI agents straight from your AI agent. Connect with your own API key. HITL.sh adds human approval and review workflows to AI agents and automations through loops and structured requests.

By: mcp.ai · official
Page: https://mcp.ai/hitl

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_hitl?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/hitl/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/hitl/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/hitl/skill.md
Postman collection (v2.1): https://mcp.ai/hitl/postman.json

## Tools
- hitl_cancel_approval_request(request_id: string) — Irreversibly cancel a pending approval request so reviewers can no longer complete it. The request remains in history with cancelled status.
- hitl_create_approval_request(content: object, context?: object, loop_id: string, priority?: string, response: object, callback_url?: string, request_text: string, processing_type?: string, timeout_seconds?: integer) — Create and broadcast one human approval request to active members of an owned loop, consuming one provider request allowance.
- hitl_create_loop(icon: string, name: string, description?: string) — Create an approval loop and return its loop ID and human invitation links; the connected account is added as an active member.
- hitl_delete_loop(loop_id: string) — Permanently delete an owned loop and all of its memberships, approval requests, responses, feedback, and analytics. This cascading deletion erases the loop's entire history and cannot be undone.
- hitl_get_account_status() — Return the connected HITL account identity, status, permissions, and provider-reported request allowance before creating an approval request.
- hitl_get_approval_request(request_id: string) — Get the current status, configuration, and human response for one approval request; use for deliberate polling after creation.
- hitl_list_approval_requests(loop_id?: string) — Return approval requests created by the connected API key, optionally restricted to one loop; pagination controls are omitted because the live API currently ignores them.
- hitl_list_loop_members(loop_id: string) — Return a loop's active and pending human reviewers so an agent can verify readiness before broadcasting an approval request.
- hitl_list_loops() — Return all approval loops owned by the connected account, including embedded members and membership counts.
- hitl_update_loop(icon?: string, name?: string, loop_id: string, description?: string) — Update one or more display fields of an owned approval loop without changing its members or requests.

## Example prompts
- "What can I do in Human Approval - HITL Platform?"
- "Show me a summary of my Human Approval - HITL Platform account"

## Links
Docs: https://mcp.ai/docs/mcps/hitl
Website: https://mcp.ai/mcps/hitl