MCP.so
Sign In

Agentsim

@agentsimdev

About Agentsim

Real SIM-backed mobile numbers for AI agents. Provision phone numbers, receive SMS, and capture OTP codes - bypasses VoIP blocks that reject Twilio/Vonage. 5 tools: provision_number, wait_for_otp, get_messages, release_number, list_numbers.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "agentsim": {
      "type": "http",
      "url": "https://mcp.agentsim.dev/mcp",
      "env": {
        "AGENTSIM_API_KEY": "asm_live_..."
      }
    }
  }
}

Tools

5

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`.

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.

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.

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.

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.

Overview

What is Agentsim?

AgentSIM provides real SIM-backed US mobile numbers for AI agents. Unlike VoIP numbers from Twilio or Vonage, these numbers pass carrier-lookup checks as line_type: mobile and work with services that block virtual numbers, such as Google, Stripe, and WhatsApp.

How to use Agentsim?

Get an API key at console.agentsim.dev, connect the MCP server to your AI assistant, then ask it to provision a number and wait for an OTP. The server exposes five tools: provision_number, wait_for_otp, get_messages, release_number, and list_numbers.

Key features of Agentsim

  • Provision real US mobile numbers via MCP tools
  • Wait for SMS OTPs with a configurable timeout
  • Retrieve all messages for a given session
  • Release numbers back to the pool when done
  • List all active sessions for your API key
  • 10 free sessions per month on the Hobby plan

Use cases of Agentsim

  • Automate SMS OTP verification for AI agent logins
  • Register AI agents on Google, Stripe, or WhatsApp
  • Test phone‑verified user flows without manual intervention
  • Handle one‑time verification codes in automated workflows

FAQ from Agentsim

What kind of phone numbers does Agentsim provide?

Real SIM‑backed US mobile numbers that pass carrier‑lookup checks as line_type: mobile.

How is Agentsim different from Twilio or Vonage?

Unlike VoIP numbers from Twilio or Vonage, Agentsim numbers work with services that block virtual numbers.

What is the pricing?

10 free sessions per month on the Hobby plan, then $0.99 per session. OTP timeouts are not billed.

Where do I get an API key?

At console.agentsim.dev.

What tools are available?

provision_number, wait_for_otp, get_messages, release_number, and list_numbers.

Frequently asked questions

What kind of phone numbers does Agentsim provide?

Real SIM‑backed US mobile numbers that pass carrier‑lookup checks as `line_type: mobile`.

How is Agentsim different from Twilio or Vonage?

Unlike VoIP numbers from Twilio or Vonage, Agentsim numbers work with services that block virtual numbers.

What is the pricing?

10 free sessions per month on the Hobby plan, then $0.99 per session. OTP timeouts are not billed.

Where do I get an API key?

At [console.agentsim.dev](https://console.agentsim.dev).

What tools are available?

`provision_number`, `wait_for_otp`, `get_messages`, `release_number`, and `list_numbers`.

Comments

More Communication MCP servers