Back to Browse

Agentsim MCP Server

Developer ToolsUse Caution4.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Control plane for agent auth walls. Connector 0 handles SMS OTP with US test numbers.

About

Control plane for agent auth walls. Connector 0 handles SMS OTP with US test numbers.

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

Security Report

4.0
Use Caution4.0High Risk

Valid MCP server (0 strong, 4 medium validity signals). 6 known CVEs in dependencies (1 critical, 3 high severity) Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 7 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.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

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

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "dev-agentsim-mcp": {
      "url": "https://mcp.agentsim.dev/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

agentsim-mcp

Availability: The free Hobby plan includes 10 live US SMS sessions per month for apps you own, with one active live session per account and no card required. Sample demos do not use the allowance. The new paid live offer is not open yet; existing agreements remain unchanged. Check current access and channel support before using live examples.

MCP server that exposes AgentSIM challenge tools to AI coding assistants: Codex CLI, Claude Code, Cursor, Windsurf, and any other MCP-compatible host. Primary tools: open_challenge, wait_for_verdict. Aliases: provision_number, wait_for_otp.

Setup

For Codex CLI, follow Connect Codex. It covers key handling, the SMS wait timeout, and browser access. Then use the complete phone sign-in prompt.

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

The hosted endpoint uses stateless HTTP and does not issue mcp-session-id headers. The session_id returned by AgentSIM tools identifies a challenge and remains valid across tool calls.

Tools

Control-Plane Nouns (Recommended)

ToolDescription
open_challengeOpen an authentication challenge session for a required owned service_url; accepts channel (sms_otp | email_otp | magic_link | webauthn_required), returns session ID + identifier
wait_for_verdictLong-poll for the challenge verdict — returns structured outcome including otp_code, magic_link, or webauthn_required; policy denial fails on open
get_messagesRead SMS metadata and parsed codes; reading codes consumes them
release_numberRelease a session early (allocation returned to pool)
list_numbersList all active sessions for this account

Legacy Aliases (Backward Compatibility)

ToolMaps toDescription
provision_numberopen_challenge(channel=sms_otp)Provision a temporary programmable US number for SMS OTP — kept for backward compatibility
wait_for_otpwait_for_verdictLegacy wait with automatic extension after timeout by default; number may be unchanged

Auth

For stdio, set AGENTSIM_API_KEY in the process environment. For hosted HTTP, every request must send its own x-api-key; the server validates and forwards that caller-scoped key. Get a key at console.agentsim.dev.

Supported Countries

US

Reviews

No reviews yet

Be the first to review this server!