agentsim-mcp

MCP server for AgentSIM — give Claude, Cursor, and Windsurf real phone numbers for OTP verification.

1 stars PythonOthers Updated Sep 2, 2026

ai-agentsclaudecursormcpmcp-serverotpphone-verificationsms

Documentation

agentsim-mcp

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

Setup

Claude Code

bash

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

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:

json

{
  "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)

Tool	Description
`open_challenge`	Open an authentication challenge session — accepts channel (sms_otp \	email_otp \	magic_link \	webauthn_required), returns session ID + identifier (phone number or email address)
`wait_for_verdict`	Long-poll for the challenge verdict — returns structured outcome including otp_code, magic_link, webauthn_required, or policy_denied
`get_messages`	List raw SMS messages received on a session
`release_number`	Release a session early (allocation returned to pool)
`list_numbers`	List all active sessions for this account

Legacy Aliases (Backward Compatibility)

Tool	Maps to	Description
`provision_number`	`open_challenge(channel=sms_otp)`	Provision a temporary programmable US number for SMS OTP — kept for backward compatibility
`wait_for_otp`	`wait_for_verdict`	Long-poll until an OTP arrives — kept for backward compatibility

Auth

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

Supported Countries

US (more coming soon)

Frequently asked questions

What is agentsim-mcp?

agentsim-mcp is MCP server for AgentSIM — give Claude, Cursor, and Windsurf real phone numbers for OTP verification.

How do I install agentsim-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is agentsim-mcp open source?

Yes — it is hosted on GitHub at https://github.com/agentsimdev/agentsim-mcp and has 1 stars.

Related MCP tools

projectmem

Open-source coding agent memory. Records issues, attempts, fixes and decisions, then warns your agent before it repeats an approach that already failed. Native MCP server for Claude Code, Cursor, Antigravity and Codex. 100% local, no cloud, no telemetry. MIT.

796 Python

ai-agentsai-memoryai-tools+17

jcodemunch-mcp

Cut AI token costs 95%+ on code exploration. The leading MCP server for precise, symbol-level GitHub code retrieval via tree-sitter AST. Works with Claude Code, Cursor & any MCP client. 313B+ tokens saved.

2,651 Python

claudeclaude-codeai-coding+17

tradememory-protocol

Decision audit trail + persistent memory for AI trading agents. Outcome-weighted recall, tamper-evident SHA-256 chain with RFC 3161 anchoring, 20 MCP tools.

1,413 Python

claudeforexmcp+11

atlassian-mcp-server

Official remote MCP server for Atlassian. Securely connect Jira, Confluence, Jira Service Management, Bitbucket, and Compass to Claude, ChatGPT, Cursor, VS Code, and other AI tools using OAuth 2.1 or API tokens.

1,015 JavaScript

aiai-agentsatlassian+17

fastapi_mcp

Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth! Python-based implementation. Trusted by 11000+ developers.

11,002 Python

aiauthenticationauthorization+10

google_workspace_mcp

Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace MCP Server & CLI Tool

3,117 Python

aigmailgoogle-calendar+17

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP