io.github.flovoice53-tech/sms-florin-mcp
Rent a real UK phone number and receive SMS/OTP codes — built for AI coding agents.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
sms-florin-mcpclaude mcp add sms-florin-mcp -e 'SMS_FLORIN_API_KEY=<your sms_florin_api_key>' -- npx -y sms-florin-mcp@0.1.2{
"mcpServers": {
"sms-florin-mcp": {
"command": "npx",
"args": [
"-y",
"sms-florin-mcp@0.1.2"
],
"env": {
"SMS_FLORIN_API_KEY": "<your sms_florin_api_key>"
}
}
}
}Environment variables
SMS_FLORIN_API_KEYrequired secret Your sms-florin API key — generate one at https://flo-voice1.com/api-access
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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-mcpOr 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.
Tools
| 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.
Need one for your own API?
I build custom MCP servers like this one — npm package, published to the official Anthropic MCP registry / Docker MCP catalog / Glama, same setup as above. Details on Fiverr, starting at $90.
License
MIT
Frequently asked questions
What is io.github.flovoice53-tech/sms-florin-mcp?
Rent a real UK phone number and receive SMS/OTP codes — built for AI coding agents.
How do I install io.github.flovoice53-tech/sms-florin-mcp?
It runs on your machine. In Claude Code: claude mcp add sms-florin-mcp -e 'SMS_FLORIN_API_KEY=<your sms_florin_api_key>' -- npx -y sms-florin-mcp@0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.flovoice53-tech/sms-florin-mcp need an API key?
Yes. It expects SMS_FLORIN_API_KEY, which you set in its configuration.
Is io.github.flovoice53-tech/sms-florin-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.flovoice53-tech/sms-florin-mcp?
It is published by flovoice53-tech. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.