Schema | agentsim-mcp

agentsim-mcp

Official

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.

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": true }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`extensions`	{ "io.modelcontextprotocol/ui": {} }
`experimental`	{}

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 `number` on your target service to trigger an SMS, then call `wait_for_otp` with the returned `session_id`.
wait_for_otpA	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.
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.

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.

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.

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/agentsimdev/agentsim-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server