otpkit
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FIVESIM_API_KEY | No | Optional API key for the paid 5sim SMS provider. | |
| SMSPOOL_API_KEY | No | Optional API key for the paid smspool SMS provider. |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_temp_emailB | Create a temporary email address. All providers are free with no API key. Args: provider: grabmail | catchmail | guerrillamail | maildrop username: Custom username prefix. Random if omitted. Returns: JSON with the new address and provider name. |
| list_temp_emailsA | List all temporary email addresses created in this session. |
| check_emailA | Check inbox for new messages. Auto-extracts OTP codes and verification links. Args: address: Temp email address to check. Returns: JSON with messages, each containing extracted otps[] and links[]. |
| wait_for_emailA | Poll until a new email arrives or timeout. Args: address: Temp email address to watch. timeout: Max seconds to wait (default 60, max 120). poll_interval: Seconds between polls (default 5, min 3). Returns: JSON with the new message including extracted otps[] and links[], or timeout status. |
| list_free_sms_numbersA | List available free public phone numbers for receiving SMS. No auth needed. Returns: JSON with available phone numbers from receive-sms-free.cc. These are shared public numbers — anyone can read messages. |
| read_free_smsA | Read recent SMS messages on a free public phone number. No auth needed. Args: phone: Phone number (digits only, from list_free_sms_numbers). |
| wait_for_smsA | Poll until a new SMS arrives on a free public number or timeout. Args: phone: Phone number to watch. timeout: Max seconds to wait (default 120, max 300). poll_interval: Seconds between polls (default 10, min 5). |
| get_sms_providersA | List all SMS providers and their configuration status. |
| buy_temp_numberA | Buy a private temporary phone number (paid, requires API key in env). Args: country: Country code — e.g. "russia", "usa", "india". service: Target service — e.g. "telegram", "whatsapp", "google", "any". provider: 5sim | smspool |
| check_paid_smsB | Check if an SMS arrived on a paid temporary number. Args: order_id: Order ID from buy_temp_number. |
| extract_otp_from_textB | Extract OTP codes (4-8 digits) and verification links from any text. Args: text: Raw text to scan — email body, SMS content, HTML, etc. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Most tools are clearly partitioned by channel (temp email, free SMS, paid SMS) and action (create, list, check, wait, buy). check_email vs wait_for_email and read_free_sms vs wait_for_sms could be momentarily confused, but descriptions clearly distinguish one-shot reads from polling.
Nearly all tools follow a verb_noun snake_case pattern (create_temp_email, read_free_sms, buy_temp_number). Minor inconsistency: the object is sometimes 'temp_email' and sometimes just 'email', and free/paid qualifiers are applied inconsistently, but the pattern remains readable.
11 tools is well within the ideal 3-15 range and each maps to a distinct step in the OTP acquisition workflow. No obviously redundant or filler tools.
The surface covers the full lifecycle of receiving OTPs via email and SMS, plus a standalone extraction utility. Minor gaps: no deletion/cleanup of temp addresses, no listing of existing paid orders/numbers, and no provider configuration setter (only get_sms_providers status).