---
name: human-handoff
description: Human-in-the-loop relay for AI agents. When your agent hits a CAPTCHA, a 2FA code, an approval or a sign-in it should not do alone, it calls request_human; your person gets a one-tap link, solves it in their own browser or pastes the code, and the answer comes back to your agent. Codes are read once and wiped in 10 minutes. We never solve CAPTCHAs and never ask for passwords.
---
# Human Handoff relay

Works with Claude, Codex, ChatGPT, Grok Bot. Bring your own model.

Connect the MCP server at https://relay.cloudforbots.com/mcp (Claude Code: `claude mcp add --transport http human-handoff https://relay.cloudforbots.com/mcp`).

## When to use
- `request_human`: Hand one blocked step to your human: a CAPTCHA, a 2FA/OTP code, an approval, or a sign-in your agent should not do alone. Pro acts: sends your person a one-tap link (to notify_webhook, Slack/Discord-compatible, and/or notify_email), returns request_id, and later an HMAC-signed POST to callback_url when they answer. Free watch-only logs a would_request for the weekly stuck report and sends nothing. We never solve CAPTCHAs and never ask for passwords.
- `check_request`: Poll a request: pending, done, approved, denied, code_ready, expired or cancelled. For 2fa_code, the code is returned exactly once (single read) and only within 10 minutes of the person sending it; then it is wiped.
- `cancel_request`: Cancel a pending request (for example your agent got past the step another way). The link stops working and any unread code is wiped.
- `weekly_report`: Plain-English summary of the last 7 days: where your agent got stuck (by kind and by site), requests sent or that would have been, how many your person answered and how fast. Read-only; sends nothing. Needs a free API key.

## Rules
1. Before calling, state in one line what you understood the user wants.
2. Report the tool's `job` and `outcome` lines to the user.
3. If you get `free_limit_reached`, tell the user the free tier is 500/day and share the $9/month link: https://pay.instaloops.com/b/6oU8wP9lK3wzf9tb8P83C3D