# Human Approval - HITL Platform — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hitl?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hitl_cancel_approval_request`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hitl`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hitl/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hitl/cancel/approval/request` — Irreversibly cancel a pending approval request so reviewers can no longer complete it. The request remains in history with cancelled status.
  - body: { request_id: string }
- `POST https://api.mcp.ai/api/hitl/create/approval/request` — Create and broadcast one human approval request to active members of an owned loop, consuming one provider request allowance.
  - body: { content: object, context?: object, loop_id: string, priority?: string, response: object, callback_url?: string, request_text: string, processing_type?: string, timeout_seconds?: integer }
- `POST https://api.mcp.ai/api/hitl/create/loop` — Create an approval loop and return its loop ID and human invitation links; the connected account is added as an active member.
  - body: { icon: string, name: string, description?: string }
- `POST https://api.mcp.ai/api/hitl/delete/loop` — 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.
  - body: { loop_id: string }
- `POST https://api.mcp.ai/api/hitl/get/account/status` — Return the connected HITL account identity, status, permissions, and provider-reported request allowance before creating an approval request.
- `POST https://api.mcp.ai/api/hitl/get/approval/request` — Get the current status, configuration, and human response for one approval request; use for deliberate polling after creation.
  - body: { request_id: string }
- `POST https://api.mcp.ai/api/hitl/list/approval/requests` — 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.
  - body: { loop_id?: string }
- `POST https://api.mcp.ai/api/hitl/list/loop/members` — Return a loop's active and pending human reviewers so an agent can verify readiness before broadcasting an approval request.
  - body: { loop_id: string }
- `POST https://api.mcp.ai/api/hitl/list/loops` — Return all approval loops owned by the connected account, including embedded members and membership counts.
- `POST https://api.mcp.ai/api/hitl/update/loop` — Update one or more display fields of an owned approval loop without changing its members or requests.
  - body: { icon?: string, name?: string, loop_id: string, description?: string }

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

## More
- Page: https://mcp.ai/hitl
- Agent spec (llms.txt): https://mcp.ai/hitl/llms.txt
- Postman collection: https://mcp.ai/hitl/postman.json