Human Approval - HITL Platform
HITL.sh adds human approval and review workflows to AI agents and automations through loops and structured requests.
Verdict
Common use cases
- Gate production deployments with engineer sign-off
- Require manager approval before budget spend
- Review AI-drafted customer emails before sending
- Confirm data deletion requests meet compliance
- Validate model outputs in regulated workflows
Integration
- Vendor
- Human Approval - HITL Platform
- Category
- other
- Auth
- API_KEY
- Tools
- 10
- Composio slug
hitl
Tools
- Cancel Approval Request
Irreversibly cancel a pending approval request so reviewers can no longer complete it. The request remains in history with cancelled status.
- Create Approval Request
Create and broadcast one human approval request to active members of an owned loop, consuming one provider request allowance.
- Create Loop
Create an approval loop and return its loop ID and human invitation links; the connected account is added as an active member.
- Delete Loopdestructive
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.
- Get Account Status
Return the connected HITL account identity, status, permissions, and provider-reported request allowance before creating an approval request.
- Get Approval Request
Get the current status, configuration, and human response for one approval request; use for deliberate polling after creation.
- 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.
- List Loop Members
Return a loop's active and pending human reviewers so an agent can verify readiness before broadcasting an approval request.
- List Loops
Return all approval loops owned by the connected account, including embedded members and membership counts.
- Update Loop
Update one or more display fields of an owned approval loop without changing its members or requests.
Setup
Setup guide
- 11. Sign up at the Human Approval vendor site and generate an API key from your account dashboard. 2. In Switchy, open your workspace settings and navigate to the MCP Integrations panel. 3. Click 'Add Integration', select 'Human Approval - HITL Platform', and paste your API key when prompted. 4. Switchy validates the key by calling the Get Account Status tool; you'll see your request allowance and account identity. 5. Create your first approval loop by opening a Project and typing '@Human Approval create a loop named Engineering Review'. 6. The MCP returns a loop ID and invitation links; share those links with teammates who should review requests. 7. Test the connection by asking '@Human Approval create an approval request in loop [ID] asking if we should proceed with deployment'. 8. Check your email or the invitation link for the approval prompt; approve or reject it. 9. Poll the request status by typing '@Human Approval get approval request [request ID]' to confirm the agent sees your decision.
What teammates see: by default, memories from Human Approval - HITL Platform are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Create Review Loop
@Human Approval create an approval loop named 'Marketing Campaign Review' and return the invitation links so I can add my team.
Request Deployment Approval
@Human Approval create an approval request in loop [loop_id] asking 'Should we deploy version 2.4.1 to production?' with a 30-minute timeout.
Check Approval Status
@Human Approval get the current status and any feedback for approval request [request_id].
List Pending Requests
@Human Approval list all approval requests in loop [loop_id] and show me which are still pending.
Cancel Stale Request
@Human Approval cancel approval request [request_id] because the deployment window has closed.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@human-approval create a loop called 'Production Deploys' and invite sarah@example.com and mike@example.com as reviewers
Loop created successfully with ID loop_abc123. Sarah and Mike have been sent invitation links to join as active reviewers. The loop is now ready to receive approval requests. Your account remains as the loop owner and can broadcast requests once at least one invitee accepts their membership.
This example shows loop creation, the foundation for all approval workflows. The MCP returns invitation links but cannot force acceptance — you must wait for humans to join before the loop becomes functional. Requires API_KEY auth with loop creation permissions.
@human-approval send an approval request to the 'Production Deploys' loop asking if we should merge PR #847 to main, with a 2-hour timeout
Approval request req_xyz789 broadcast to 2 active members in 'Production Deploys' loop. The request asks: 'Should we merge PR #847 to main?' Reviewers have 2 hours to respond via their notification channels. This consumed 1 request from your provider allowance (47 remaining). Poll the request status with get-approval-request to see human responses as they arrive.
This demonstrates the core human-in-the-loop capability: pausing AI workflows for human judgment. The MCP does not block or wait — your agent must poll for responses. Each request consumes allowance quota. If no human responds before timeout, the request expires without approval.
@human-approval check all pending approval requests in the last 24 hours and summarize which ones are still waiting for human review
Found 3 approval requests from the past 24 hours: req_xyz789 (PR #847 merge) is pending with 0/2 responses after 45 minutes; req_abc456 (database migration) was approved by 2/2 reviewers 6 hours ago; req_def012 (API key rotation) expired without response after 2-hour timeout. One request still needs human attention before your workflow can proceed.
This synthesis example shows how an AI can monitor approval state across multiple requests and surface blockers. The MCP returns historical data but cannot predict when humans will respond. Useful for daily standup summaries or identifying stalled workflows that need follow-up.
Use-case deep-dives
When your AI assistant needs a human gate for spend decisions
A 6-person startup uses an AI agent to draft vendor contracts and schedule payments. The agent can negotiate terms and queue invoices, but any spend over $500 needs a human yes-or-no before the wire goes out. This MCP is built for exactly that gate: the agent calls Create Approval Request mid-workflow, waits for a loop member to approve or reject, then continues or halts based on the response. The 10-tool surface is narrow by design—this isn't a collaboration platform, it's a blocking checkpoint. If your agent workflows already have clear decision thresholds and you need audit trails for compliance, this is the right primitive. If you're looking for threaded discussion or multi-stage review, you'll outgrow it fast.
Gating AI responses when the stakes get legal or reputational
A 3-person SaaS support team uses an AI agent to draft replies to inbound tickets. Most answers ship automatically, but refund requests over $200 or any mention of 'lawyer' trigger a human approval loop before the reply goes out. The agent creates the request, a support lead reviews the draft in Slack or email (via the invitation link), and approves or rewrites. The MCP's Get Approval Request tool lets the agent poll for the decision without blocking other tickets. The trade-off: if you need reviewers to leave inline comments or suggest edits, this MCP won't carry that payload—it's a binary gate, not a collaboration surface. For high-volume support teams where most escalations resolve in under 5 minutes, the request allowance and loop-member management become the bottleneck to watch.
When your content agent needs a final human read before publish
A 4-person marketing team runs an AI agent that drafts blog posts, social captions, and email newsletters on a weekly cadence. The agent writes, formats, and stages everything in the CMS, but a human editor must approve each piece before it goes live. The agent calls Create Approval Request with the draft link, the editor reviews in their own tool, and the agent polls Get Approval Request to decide whether to hit publish or archive. This works cleanly when the review is pass-fail and the editor's feedback happens outside the loop (in Google Docs comments, for example). If your editorial process requires the reviewer to leave structured notes or request revisions inside the approval flow, this MCP won't carry that context—you'd need a richer integration or a custom webhook setup.
Frequently asked
What does the Human Approval MCP do in Switchy?
It lets AI agents pause workflows and ask real humans for approval before taking sensitive actions. Your team creates approval loops, agents broadcast requests to those loops, and humans approve or reject via web links. The MCP handles the entire request lifecycle — creation, polling for responses, and cancellation if needed.
Do I need a separate Human Approval account to use this MCP?
Yes. You connect via API key, which ties the MCP to your Human Approval account. That account controls your request allowance and owns the approval loops. Check your provider limits with the Get Account Status tool before creating requests — each approval consumes one allowance unit.
Can the MCP automatically approve requests without human input?
No. The entire point is human-in-the-loop verification. Agents create requests and poll for responses, but a real person must click approve or reject. If you want auto-approval logic, build it into your agent's decision tree before calling Create Approval Request.
How is this different from just sending a Slack message asking for approval?
Slack messages disappear in chat history and lack structured state tracking. Human Approval gives you persistent request IDs, response history, and analytics. The MCP polls for definitive approve/reject answers instead of parsing freeform replies. Use Slack if you want discussion; use this if you need audit trails.
Who on my team should set up the approval loops?
Whoever owns the Human Approval account creates loops and invites reviewers. In Switchy, any team member with the API key can trigger approval requests, but only loop members receive the actual review links. Coordinate loop membership with your compliance or ops lead before connecting the MCP.