Create a fresh disposable email inbox (or reuse an existing one by label).

Use this when an agent needs an email address to sign up / receive a verification message. Returns the address. Poll fetch_code to get the OTP.

Fetch the latest verification code/link from an inbox.

wait seconds for a message to arrive (polls). Optional match_from / match_subject substrings filter which message counts. Returns extracted code and any verification link, or {"empty": true}.

List all existing labeled inboxes/numbers.

Rent a phone number that can receive SMS/OTP codes.

Use this when an agent must verify via phone (WhatsApp, Telegram, banks, apps requiring SMS). Returns the rented number. Poll fetch_sms for the OTP. country e.g. "usa","russia","any"; service e.g. "discord", "google","any" (provider may use it to pick a suitable number).

Fetch the latest SMS (OTP) for a labeled number.

Polls up to wait seconds for a message to arrive. Returns extracted code and sender from, or {"empty": true}.

Stop renting a phone number and free it. Call when you're done with OTP.

Verify an AI agent's identity before transacting with it (Know Your Agent).

Call BEFORE paying or trusting another agent. Returns a trust score + flags. evidence keys (any subset): wallet_address, wallet_age_days, domain, pubkey, owner_email, declared_country. Higher trust = more verified attributes and a clean sanctions screen. Use the returned recommendation to decide whether to proceed with a counterparty agent. Returns: {trust_score: 0-100, verified: [...], flags: [...], recommendation}

Score a transaction's fraud risk BEFORE authorizing payment.

Call right before an agent pays. Combines counterparty signals + amount anomalies + sanctions screen + rail/category heuristics. Recommendation is one of: allow / review / decline. 'decline' = abort the payment. rail in: x402, ap2, acp, tap. category in: digital_goods, services, physical. Returns: {score: 0-100, recommendation, reasons: [...], screen_id}

Screen a counterparty against OFAC/EU/UN/UK sanctions lists.

Cheapest check, call first. At least one of name / wallet / country required. Free provider uses open sanctions data (no key). Useful as a fast pre-filter before the heavier risk_score call. Returns: {matches: [{list, entity, match_type, confidence}], clean: bool}

Open a dispute when an agent-paid transaction went bad (non-delivery, fraud).

Records the dispute with a 7-day auto-escalation window. Phase 1 = registry

• notification; Phase 2 will integrate agentcourt-api for arbitration. Returns: {dispute_id, status, escalation_at}