v2.0 Now with MCP server for AI agents

SMS verification
from the terminal.

Buy temporary phone numbers and receive OTP codes in one command. Multi-provider, real-time, 170+ countries.

$ pip install fastrecvsms click to copy
fastrecvsms
$ fastrecvsms buy whatsapp --country russia
 
Provider: 5sim
Service: whatsapp
Country: russia
Number: +7 (985) 412-7803
Price: 22.00 RUB
Order ID: 387141506
 
Waiting for SMS... [elapsed: 12s]
 
SMS Received!
Code: 483-291
Features

Everything you need in one CLI

Built for security professionals who need fast, reliable SMS verification without leaving the terminal.

Multi-Provider

Unified interface for 5sim.net and SMS-Activate. Switch providers with a flag, same commands everywhere.

Real-Time Monitoring

Live terminal display with elapsed timer while waiting for SMS. Know the moment your code arrives.

One-Command Flow

Buy a number and automatically wait for the verification code - single command, no context switching.

Secure Configuration

API keys stored locally in TOML config. Environment variable overrides for CI/CD and automation pipelines.

Rich Terminal UI

Color-coded output, formatted tables, and clear verification code display. Built with Rich for a polished experience.

MCP Server

Built-in Model Context Protocol server. Let your AI agent buy numbers and receive codes autonomously.

170+
Countries
2
Providers
8
MCP Tools
3.9+
Python
Providers

One interface, multiple backends

Connect to the provider that works best for your region and use case.

5sim.net

Default Provider
  • Extensive country coverage
  • Competitive pricing
  • Fast number activation
  • Supports 100+ services

SMS-Activate

Alternative
  • Wide service selection
  • Multiple payment methods
  • High number availability
  • Reliable SMS delivery
Commands

Complete CLI reference

Everything is a single command away. No multi-step workflows.

Buy & Receive
fastrecvsms buy telegram
fastrecvsms buy instagram --country usa
fastrecvsms buy facebook --no-wait
fastrecvsms buy google --timeout 300
Order Management
fastrecvsms check 387141506
fastrecvsms check 387141506 --wait
fastrecvsms cancel 387141506
fastrecvsms finish 387141506
Account
fastrecvsms balance
fastrecvsms balance -p sms-activate
Configuration
fastrecvsms config set-key 5sim KEY
fastrecvsms config show
fastrecvsms config set-default sms-activate
AI Integration

MCP Server for AI agents

Let Claude, Cursor, or any MCP-compatible AI agent handle SMS verification autonomously.

Plug into any MCP client

FastRecvSMS ships a built-in Model Context Protocol server. Add it to your AI editor's config and your agent can buy numbers, wait for codes, and manage orders - no human in the loop.

claude_desktop_config.json
{
  "mcpServers": {
    "fastrecvsms": {
      "command": "fastrecvsms-mcp"
    }
  }
}
ToolDescription
buy_numberBuy a temporary phone number
wait_for_smsPoll until SMS received
check_smsCheck if code has arrived
get_balanceCheck provider balance
list_servicesList services with prices
cancel_orderCancel an active order
finish_orderMark order complete
list_active_ordersList pending orders
Python API

Use it as a library

Import directly for scripting, automation, or integration into larger workflows.

example.py Python
from fastrecvsms.config import Config
from fastrecvsms.providers import get_provider

config = Config()
provider = get_provider("5sim", config.get_api_key("5sim"))

# Buy a number and get the verification code
order = provider.buy_number("whatsapp", "russia")
print(f"Phone: {order.phone}")

result = provider.check_order(order.id)
if result.sms_code:
    print(f"Code: {result.sms_code}")

Ready to automate SMS verification?

Install FastRecvSMS and start receiving codes in seconds.

Install v2.0 Read the docs