Agentsim
About
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.
Details
- Author
- agentsimdev
- Downloads
- 373
- Categories
- Communication, Other, Developer Tools, Security, AI
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AgentsimCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
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`.
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.
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.
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.
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"agentsim": {
"agentsim": {
"type": "http",
"url": "https://mcp.agentsim.dev/mcp",
"env": {
"AGENTSIM_API_KEY": "asm_live_..."
}
}
}
}
}McpServers
{
"agentsim": {
"type": "http",
"url": "https://mcp.agentsim.dev/mcp",
"env": {
"AGENTSIM_API_KEY": "asm_live_..."
}
}
}MCP server that exposes AgentSIM OTP session tools to AI coding assistants: Claude Code, Cursor, Windsurf, and any other MCP-compatible host.
claude mcp add agentsim -e AGENTSIM_API_KEY=asm_live_xxx -- uvx agentsim-mcp
Add to~/Library/Application Support/Claude/claude_desktop_config.json:
{ "mcpServers": { "agentsim": { "command": "uvx", "args": ["agentsim-mcp"], "env": { "AGENTSIM_API_KEY": "asm_live_xxx" } } } }
Addagentsim-mcpas a stdio MCP server withAGENTSIM_API_KEYin the environment config.
Connect directly to the hosted MCP server without installing anything locally:
{ "mcpServers": { "agentsim": { "type": "streamable-http", "url": "https://mcp.agentsim.dev/mcp", "headers": { "x-api-key": "asm_live_..." } } } }
SetAGENTSIM_API_KEYin your environment. Get your key atconsole.agentsim.dev.
1001SMS MCP Server helps developers give AI agents access to temporary phone numbers for account registrations, OTP verifications, SMS code receiving, and automated signup workflows. Easy integration for MCP-compatible tools and custom agents.
Gives an AI agent a disposable email and a real UK phone number to test signup/verification flows end to end
Provision dedicated US phone numbers and receive SMS/OTP codes for automated verification workflows.
Manage your WhatsApp, SMS and Phone Calls using a single MCP connector
Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.
Build with the Kudosity API to send SMS and MMS. Access developer docs, API references and live testing tools to send messages, manage contact lists, configure webhooks and more.
Send and receive emails, SMS, and voice calls via Pingram.
Platfone - Receive SMS & Virtual Numbers MCP
Virtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle
Send SMS, WhatsApp, and RCS messages programmatically with DLT compliance. Manage contacts, schedule campaigns, and track delivery reports.
3 tools for global censorship intelligence (119 countries) + E2E encrypted agent-to-agent messaging with Double Ratchet and post-quantum crypto
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
