wait_for_otp
ActiveTool of Palmyr
Wait for an SMS verification code / OTP to arrive on a Palmyr phone number you own, and return the parsed code. Blocks up to timeout_s (default 60, max 90) checking every ~2s — one call replaces hand-rolled polling of phone_read_messages during account signups and 2FA flows. Messages that arrived up to lookback_s seconds (default 10) BEFORE the call also match, so a code that landed early is not missed — pass lookback_s=0 when reusing a number across signups so a stale code can't be re-served. Default extraction handles standalone 4-8 digit codes, 'code is/code:' tokens, and Google-style G-XXXXXX; pass pattern to override (max 256 chars; a pattern that blows its per-match budget is dropped mid-wait and pattern_timeout: true is reported). Returns { found: true, code, message_text } on a hit or { found: false, waited_s } on timeout (not an error — just call again). Costs 0.02 USDC, paid per-action via x402.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"number_id"
],
"properties": {
"pattern": {
"type": "string",
"description": "Custom extraction regex overriding the default OTP formats (first capture group wins, else the full match; max 256 chars)"
},
"payment": {
"type": "string",
"description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
},
"number_id": {
"type": "string",
"description": "Phone number id returned by phone_buy_number"
},
"timeout_s": {
"type": "number",
"description": "Seconds to block waiting (default 60, max 90)"
},
"lookback_s": {
"type": "number",
"description": "Also match messages received up to this many seconds before the call (default 10; use 0 for reused numbers)"
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
Palmyr
https://github.com/0xArtex/Palmyr
1/7 registries