When you get approval_required
Tool result JSON (inside MCP content) looks like:
match_code is two digits (00–99). Default prompt TTL is about 300 s.
What to show the user
- Your verified agent domain (from key verification — not a marketing name).
- The match code, so they can confirm the phone prompt is the same request.
How to retry
Wait at least
retry_after_seconds (often 5) before retrying. Do not spin.
Hold a live request
Add this header to a live/mcp request:
denied. If the hold times out, the result is the
normal approval_required object with retry_after_seconds: 5.
This is opt-in and only applies to live MCP. Without the header, the retry contract
above is unchanged. Intermediaries and client HTTP timeouts must allow the requested
hold duration.
Limits
Do not
- Call
/papi/*(phone API — not for agents). - Expect
/mcpto return a capability biscuit on approval. - Hide the match code or substitute a different identity string.