sms-florin-mcp
MCP server for sms-florin — lets AI coding agents (Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline...) rent a real UK phone number and receive an SMS/OTP verification code directly inside an agentic workflow. Useful when an agent is testing a signup/verification flow and needs a real code instead of a mocked one.
Numbers are real SIM cards on UK carrier networks (EE/Three) — not VoIP — via sms-florin's own GOIP hardware.
Setup
Get an API key at flo-voice1.com/api-access (balance is shared with your regular account).
Claude Code / Claude Desktop
claude mcp add sms-florin -e SMS_FLORIN_API_KEY=your_key_here -- npx -y sms-florin-mcp
Or in claude_desktop_config.json:
{
"mcpServers": {
"sms-florin": {
"command": "npx",
"args": ["-y", "sms-florin-mcp"],
"env": { "SMS_FLORIN_API_KEY": "your_key_here" }
}
}
}
Cursor / Windsurf / other MCP clients
Same shape — point the client's MCP config at npx -y sms-florin-mcp with SMS_FLORIN_API_KEY set in the env.
| Tool | Description |
|---|
list_services | List available services (WhatsApp, Telegram, Google, Discord...) and their prices. |
rent_number | Rent a number for a service (instant or monthly), debiting your balance. Returns a rentalId. |
get_rental | Check a rental's status, phone number, and any SMS received so far. |
wait_for_sms | Block until the first SMS/OTP arrives, or time out — the one-step way to get a code in an automated flow. |
Example flow
Rent a WhatsApp number and wait for the verification code.
The agent calls rent_number({ serviceSlug: "whatsapp" }), then wait_for_sms({ rentalId }), and gets the code back to type into the signup form it's testing.
License
MIT