agentsim-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AGENTSIM_API_KEY | Yes | Your AgentSIM API key. Get it at https://console.agentsim.dev. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| provision_numberA | 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 |
| wait_for_otpA | Block until an SMS OTP arrives for this session, then return the code. Polls the AgentSIM API for up to If the OTP does not arrive in time, raises a ToolError with advice on retrying.
Always call |
| get_messagesA | 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. |
| release_numberA | 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. |
| list_numbersA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| verify_phone_number | Step-by-step guide to run an OTP session on a target workflow. Walks through the full AgentSIM workflow: provision → enter number → wait for OTP → inspect diagnostics → release. |
| debug_verification_failure | Diagnose why phone verification failed and suggest fixes. Common issues: VoIP blocking, carrier cold-start, number already used. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| account_status | Current AgentSIM account status including active sessions and usage. |
| quickstart_guide | AgentSIM quickstart guide — how to get started in 60 seconds. |
TDQS
Scored across 5 tools
Each tool has a distinct, non-overlapping purpose: provisioning, releasing, waiting for OTP, listing messages, and listing sessions. No ambiguity.
All tool names follow a consistent verb_noun pattern with underscores, e.g., provision_number, release_number, wait_for_otp.
Five tools is exactly right for the domain of temporary phone number management, covering all necessary operations without bloat.
The tool surface covers the full lifecycle: provision, release, wait for OTP, list messages, and list sessions. No obvious gaps.