# AgentSIM MCP server

Real SIM-backed phone numbers for AI agents — autonomous OTP capture, no VoIP, no human steps.

## Links
- Registry page: https://www.getdrio.com/mcp/dev-agentsim-mcp
- Repository: https://github.com/Fato07/agentsim

## Install
- Command: `uvx agentsim-mcp`
- Endpoint: https://mcp.agentsim.dev/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: x-api-key (required; secret)
- Package: Pypi agentsim-mcp v0.3.1
- Environment variable: AGENTSIM_API_KEY (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.agentsim.dev/mcp
- Header: x-api-key

## Tools
- provision_number - Lease a real mobile 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 exclusively yours 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`. Endpoint: https://mcp.agentsim.dev/mcp
- 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. Endpoint: https://mcp.agentsim.dev/mcp
- 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. Endpoint: https://mcp.agentsim.dev/mcp
- 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. Endpoint: https://mcp.agentsim.dev/mcp
- 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. Endpoint: https://mcp.agentsim.dev/mcp

## Resources
- agentsim://status - Current AgentSIM account status including active sessions and usage. MIME type: text/plain
- agentsim://docs/quickstart - AgentSIM quickstart guide — how to get started in 60 seconds. MIME type: text/plain

## Prompts
- verify_phone_number - Step-by-step guide to verify a phone number on a target service.

Walks through the full AgentSIM workflow: provision → enter number → wait for OTP → use code → release. Arguments: service, agent_id
- debug_verification_failure - Diagnose why phone verification failed and suggest fixes.

Common issues: VoIP blocking, carrier cold-start, number already used. Arguments: error_message

## Metadata
- Owner: dev.agentsim
- Version: 0.3.1
- Runtime: Pypi
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Mar 23, 2026
- Source: https://registry.modelcontextprotocol.io