Agentsim MCP Server

dev.agentsim/mcp

answering

Agentsim is answering right now. Last checked 9 min ago. It exposes 5 tools. Last commit 17 Jun 2026.

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

Uptime history 41 hours of history

41 hours agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

402 ms

Response time

average over 24h

Stars

last commit 17 Jun 2026

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 9 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add mcp --transport http https://mcp.agentsim.dev/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.mcp]
url = "https://mcp.agentsim.dev/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 5

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

messages

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.

numbers

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.

provision

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

release

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.

wait

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.

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.agentsim.dev/mcp	streamable-http	answering	376 ms	9 min ago

Agentsim — questions

Answers built from our own checks of this server.

What can Agentsim do?

It exposes 5 tools, read directly from the server on our last check. Among them: get_messages, list_numbers, provision_number, release_number, wait_for_otp. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Agentsim working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 402 ms. The bar chart above shows every period we have measured.

How do I connect Agentsim?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Agentsim need an API key?

No. Agentsim completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 5 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Agentsim?

It answers our handshake in 402 ms on average, which is faster than 33% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Agentsim open source?

Yes — it is published under the MIT licence, written in Python and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.