Skip to main content
Glama
Sign In
sms-florin-mcp

sms-florin-mcp

by flovoice53-tech
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

sms-florin-mcp

npm version npm downloads

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.

Related MCP server: MCP Agents SMS

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

Available Tools

4 tools
get_rentalGet rental statusA

Check a rental's status, phone number, and any SMS messages received so far.

Inputs: rentalId (required).

list_servicesList servicesA

List the services sms-florin can rent a UK phone number for (WhatsApp, Telegram, Google, Discord, etc.), with their prices.

Inputs: no named parameters.

rent_numberRent a phone numberA

Rent a real UK phone number for a given service so it can receive an SMS/OTP verification code. Debits the account balance. Returns a rentalId to check with get_rental or wait_for_sms.

Inputs: serviceSlug (required), period.

wait_for_smsWait for SMSA

Block until the first SMS/OTP code arrives on a rental, or time out. The one-step way to rent a number and get the code in an automated flow.

Inputs: rentalId (required), timeoutMs, intervalMs.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: listing services, renting a number, checking rental details, and blocking for SMS. wait_for_sms is differentiated from get_rental by its blocking behavior and automation focus.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (list_services, rent_number, get_rental, wait_for_sms), making the set predictable and easy to navigate.

    Tool Count5/5

    Four tools is well-scoped for a focused SMS rental service. Each tool serves a necessary step in the core workflow, and the count feels neither thin nor bloated.

    Completeness4/5

    The core flow of renting a number and retrieving SMS is fully covered. However, there is no cancellation or balance-check tool, which are minor gaps that could be worked around but leave some lifecycle unfinished.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • joltsms-mcp-server

      rchanllc
      A
      license
      A
      quality
      C
      maintenance
      MCP server for provisioning dedicated real-SIM US phone numbers, receiving inbound SMS, and extracting OTP codes. Built for AI agents automating phone verification workflows.
      12
      506 npm
      1
      MIT

    • MCP Agents SMS

      gonchasobaka
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables AI agents to autonomously buy virtual phone numbers and receive SMS verification codes. Supports multiple providers (5sim, SMS-Activate, OnlineSim) with automatic cheapest-provider selection.
      2
      MIT

    • identity-mcp

      purple-flea
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that gives AI agents disposable email addresses and real phone numbers with automatic OTP extraction and self-destructing identities.
      MIT