dev.agentsim/mcp

Tools

• get_messages

  List all SMS messages received in this session without consuming the OTP. Use this to inspect raw messages or check if an SMS arrived before calling wait_for_otp. Does NOT mark the OTP as consumed.

  shallow
• list_numbers

  List active sessions, optionally filtered by agent_id. Use this to check for leaked sessions or inspect what numbers are currently active in your account.

  shallow
• open_challenge

  Open an authentication challenge session. Supports multiple channels: sms_otp (programmable US number), email_otp (mock inbox), magic_link (mock inbox), and webauthn_required (detect-and-halt). Returns the challenge identifier (phone number or email address) and a session_id needed for all subsequent calls. The session is reserved for ttl_seconds. Next step: use the returned identifier on your target service to trigger the challenge, then call `wait_for_verdict` with the returned `session_id`.

  shallow
• provision_number

  Lease a temporary programmable phone number for receiving SMS OTP codes. Returns the phone number (e164 format) and a session_id needed for all subsequent calls. The number is reserved for your session for ttl_seconds. Next step: use the returned `number` on your target service to trigger an SMS, then call `wait_for_otp` with the returned `session_id`.

  shallow
• release_number

  Release a provisioned number back to the pool. Always call this when you are done with the session — even on error — to avoid consuming pool capacity unnecessarily.

  shallow
• wait_for_otp

  Block until an SMS OTP arrives for this session, then return the code. Polls the AgentSIM API for up to `timeout_seconds`. Returns the OTP code and the message it was extracted from. If the OTP does not arrive in time, raises a ToolError with advice on retrying. Always call `release_number` after you have used the OTP.

  shallow
• wait_for_verdict

  Block until a challenge verdict arrives for this session. Polls the AgentSIM API for up to `timeout_seconds`. Returns the structured verdict, which may include: - otp_code: the parsed OTP (for sms_otp, email_otp channels) - magic_link: the extracted HTTPS URL (for magic_link channel) - webauthn_required: true if WebAuthn/passkey was detected (detect-and-halt) - policy_denied: true if the service_url is blocked by account policy Always call `release_number` after processing the verdict.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/39a76f8d-3d6e-464b-82cd-257a7ab1105a/badge.svg)](https://vouch.tools/servers/39a76f8d-3d6e-464b-82cd-257a7ab1105a)