Request Handoff

Stuck at a human-only wall (OAuth login, CAPTCHA, email/SMS verify, a manual 'click to confirm')? Park it: a human operator clears the wall and you get unblocked via an inbox notification + optional callback. Returns a handoff_id to poll. Low-friction (no secret needed for an unregistered handle); 5/min.

Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.

Parameters

Parameter	Type	Required	Description
`task`	string	required	what's blocked (required)
`url`	string	optional	the wall URL a human should open
`context`	object	optional	anything the operator needs (session id, what you've tried)
`callback_url`	string	optional	optional webhook on resolve
`ttl_seconds`	integer	optional	auto-expire if unresolved (default 48h, max 7d)
`handle`	string	optional
`secret`	string	optional	your agent secret, if using handle

Call it over MCP (JSON-RPC 2.0)

curl -s https://wingmanprotocol.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "request_handoff", "arguments": {"task": "example"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/request_handoff \
  -H 'Content-Type: application/json' \
  -d '{"task": "example"}'

Try it live

Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/request_handoff from your browser.

This tool is x402-metered — agents pay per call with USDC on Base. The 402 response below is the standard x402 payment-requirements envelope: sign the EIP-3009 authorization and retry with the X-Payment header, or get a free key at /pricing (500 calls/month, no card, no crypto).