Skip to main content
MCP server CX Codex

sv-number · sv-number — Claude Code MCP server: order phone numbers, read SMS

The mcp-server server gives your agent nine tools to order temporary phone numbers and read verification codes from SMS via the sms-verification-number.com API.

MIT ★ 429 updated 2026-08-10

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add mcp-server -e SVN_API_KEY=<SVN_API_KEY> -- npx -y sv-number-mcp
Open on GitHub

What mcp-server does

The agent calls order_number with a service code and country, gets a number, waits for the SMS with wait_for_code, and retrieves the code already extracted from the message. The server polls the API at a sensible interval, translates error tokens into actionable sentences, and stops polling after 20 minutes. The catalogue covers 200+ countries; list_services searches for a site's code by name or domain and shows the delivery rate where statistics exist.

You need an API key from your sms-verification-number.com profile and a funded balance — there's no free tier. The key is read from the SVN_API_KEY environment variable and never leaves the process. The server receives codes but won't send messages or work for bank or government registrations.

What it helps with

  • order a number for Telegram or Discord signup
  • retrieve a verification code and close the activation
  • find a site's service code by domain and pick the country with the best delivery rate
  • check your balance and list available operators
  • generate a TOTP code locally per RFC 6238

Example prompts for the agent

  • Order a number for Telegram in Indonesia and wait for the code
  • Show my balance on sms-verification-number.com and list countries with operators
  • Find the service code for discord.com, show prices and delivery rates

How to install mcp-server

Platform CLI

claude mcp add mcp-server -e SVN_API_KEY=<SVN_API_KEY> -- npx -y sv-number-mcp

Replace <…> 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 mcp-server

How do I install sv-number in Claude Code?

Run claude mcp add mcp-server -e SVN_API_KEY=<SVN_API_KEY> -- npx -y sv-number-mcp with your API key from the sms-verification-number.com profile.

What does sv-number do?

The server lets your agent order temporary phone numbers in 200+ countries and read verification SMS codes via the sms-verification-number.com API. Nine tools cover ordering, waiting for codes, cancellation, and balance checks.

Do I need a funded account to use sv-number?

Yes, your sms-verification-number.com account must have a balance — the API has no free tier. Check your key and balance with the get_balance tool.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

mcp-server by other authors comes first.

mcp-server HeyPuter mcp-server connects your AI agent to Puter for files, websites and workers. Useful when the project already lives in Puter's cloud. CX Codex +1 ★ 44,226repo stars mcp-server mapbox mcp-server connects Mapbox location APIs to your AI assistant for geocoding, multi-modal routing, and map rendering. Helpful when building travel planners or spatial query assistants. CX Codex +1 ★ 373repo stars mcp-server PackmindHub mcp-server connects team engineering playbooks and shared coding standards from Packmind directly to AI coding agents. CX Codex +1 ★ 327repo stars mcp-server BingoWon Search Apple developer documentation and WWDC transcripts, with results ranked for relevance to your question. Useful when an agent needs API references or coding context. CX Codex +1 ★ 117repo stars mcp-server UI5 mcp-server connects SAPUI5 and OpenUI5 developer tooling to AI assistants. Helps scaffold apps, inspect manifest schemas, and run linters directly in chat. CX Codex +1 ★ 109repo stars sms-10dlc-registration sentdm sms-10dlc-registration is a skill that prepares and validates Sent US A2P 10DLC brand and campaign registrations, including consent evidence, use cases, and sample messages. CX Codex +1 2,900installs sent-profile-provisioning sentdm The sent-profile-provisioning skill drives the Sender Profile lifecycle in Sent: list, inspect, create, update and delete over MCP tools, plus the wider REST flow. Useful when onboarding a tenant and getting a profile ready to send. CX Codex +1 2,700installs sms-alert membrane This skill connects an agent to SMS Alert through Membrane CLI, so it can work with alerts, contacts, groups, and templates. CX Codex +1 185installs api Political-Comms An MCP server over the Political Comms REST API: reads organizations, projects, contacts, analytics and billing, and stages or schedules US SMS/MMS sends. CX Codex +1 Buy UK eSIM buyukesim Buy UK eSIM connects travel eSIM catalogs and UK phone numbers to your AI assistant. Lets agents browse data plans freely and purchase connectivity using a no-KYC crypto wallet. CX Codex +1 1,005installs twilio-whatsapp-manage-senders official Twilio twilio-whatsapp-manage-senders is a Codex skill for registering and configuring WhatsApp Business senders through Twilio's Channels Senders API, including OTP verification and webhook setup. CX Codex GP ChatGPT +1 1installs

Project sponsors

Companies that keep this analytics open