sms — Claude Code MCP server: what it does, how to install
An MCP server that provides physical SIM numbers for SMS verification, rentals, and proxies. Useful when agents automate signup and OTP flows.
claude mcp add sms -e VIRTUALSMS_API_KEY=<VIRTUALSMS_API_KEY> -- npx -y virtualsms-mcpWhat sms does
This server connects AI assistants to the VirtualSMS platform. It provisions carrier-backed mobile lines rather than VoIP addresses. Services accept them during signups because real SIM hardware handles the traffic.
The toolset covers the full onboarding chain. Tools like create_order reserve a line for a targeted service, while wait_for_sms intercepts incoming verification tokens. You can also trigger create_rental to keep a dedicated line from 1 to 30 days, or fetch matching residential and mobile proxies.
Most workflows depend on a funded account and a valid VIRTUALSMS_API_KEY. Without a prepaid balance, orders fail outright. However, the check_number tool runs without any credentials.
What it helps with
- Bypass signup rejections triggered by VoIP line detection
- Extract one-time SMS verification codes directly into model prompts
- Rent dedicated mobile lines for 1 to 30 days
- Order matching-country proxies for verification steps
- Inspect numbers for VoIP status before form submission
Example prompts for the agent
- Get a UK number for WhatsApp registration and return the token
- Check whether this phone number is recognized as VoIP
How to install sms
1Platform CLI
claude mcp add sms -e VIRTUALSMS_API_KEY=<VIRTUALSMS_API_KEY> -- npx -y virtualsms-mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http sms https://mcp.virtualsms.io/mcp1Platform CLI: remote server
codex mcp add sms --url https://mcp.virtualsms.io/mcp2Platform CLI
codex mcp add sms --env VIRTUALSMS_API_KEY=<VIRTUALSMS_API_KEY> -- npx -y virtualsms-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"sms": {
"url": "https://mcp.virtualsms.io/mcp"
}
}
}{
"mcpServers": {
"sms": {
"command": "npx",
"args": [
"-y",
"virtualsms-mcp"
],
"env": {
"VIRTUALSMS_API_KEY": "<VIRTUALSMS_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"sms": {
"type": "http",
"url": "https://mcp.virtualsms.io/mcp"
}
}
}{
"servers": {
"sms": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"virtualsms-mcp"
],
"env": {
"VIRTUALSMS_API_KEY": "<VIRTUALSMS_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http sms https://mcp.virtualsms.io/mcp2Platform CLI
gemini mcp add -e VIRTUALSMS_API_KEY=<VIRTUALSMS_API_KEY> sms npx -y virtualsms-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about sms
How to install sms in Claude Code?
To connect via HTTP, run claude mcp add --transport http sms https://mcp.virtualsms.io/mcp. To run locally via stdio, use claude mcp add sms -e VIRTUALSMS_API_KEY=<VIRTUALSMS_API_KEY> -- npx -y virtualsms-mcp.
What does the sms MCP server do?
It gives AI agents tools to acquire real SIM numbers, read incoming verification texts, rent dedicated numbers for up to 30 days, and configure country-matched proxies.
Do all tools require an API key?
Buying lines, renting numbers, and provisioning proxies require an API key and balance. The check_number tool can inspect numbers without an API key.
