Back to Browse

Agentsim MCP Server

Developer ToolsModerate5.2MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

Real SIM-backed mobile numbers for AI agents to receive SMS and OTP codes.

About

Real SIM-backed mobile numbers for AI agents to receive SMS and OTP codes.

Remote endpoints: streamable-http: https://mcp.agentsim.dev/mcp

Security Report

5.2
Moderate5.2Moderate Risk

AgentSIM MCP server is a well-structured tool for OTP session management with proper authentication via API keys and appropriate permissions scoped to its purpose. The code demonstrates good security practices including input validation, error handling, and credential management. Minor findings relate to code quality and logging practices, but do not constitute security vulnerabilities. Supply chain analysis found 6 known vulnerabilities in dependencies (1 critical, 3 high severity).

8 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

process_spawn

Check that this permission is expected for this type of plugin.

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

agentsim-mcp

MCP server that exposes AgentSIM OTP session tools to AI coding assistants: Claude Code, Cursor, Windsurf, and any other MCP-compatible host.

Setup

Claude Code

claude mcp add agentsim -e AGENTSIM_API_KEY=asm_live_xxx -- uvx agentsim-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agentsim": {
      "command": "uvx",
      "args": ["agentsim-mcp"],
      "env": {
        "AGENTSIM_API_KEY": "asm_live_xxx"
      }
    }
  }
}

Cursor / Windsurf

Add agentsim-mcp as a stdio MCP server with AGENTSIM_API_KEY in the environment config.

Remote (no install)

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_..."
      }
    }
  }
}

Tools

ToolDescription
provision_numberProvision a temporary programmable US number for an OTP session — returns number, session ID, expiry
wait_for_otpLong-poll until an OTP arrives on the session (returns parsed code)
get_messagesList raw SMS messages received on a session
release_numberRelease a session early (number returned to pool)
list_numbersList all active sessions for this account

Auth

Set AGENTSIM_API_KEY in your environment. Get your key at console.agentsim.dev.

Supported Countries

US (more coming soon)

Reviews

No reviews yet

Be the first to review this server!