# VertexSMS

> VertexSMS is a global communications platform: bulk SMS, Viber business messages, VoIP, transactional and marketing email, an omnichannel contact center, a REST API, and an MCP server that lets AI assistants like Claude, Cursor, and VS Code Copilot use VertexSMS directly.

VertexSMS supports A2P SMS at scale (marketing campaigns, two-factor authentication, alerts and notifications, two-way conversations, an SMS gateway), Viber Business messaging with buttons and images, HLR number lookup, sender-ID registration, and number validation/correction. Integration is via REST API or — for AI assistants — via the Model Context Protocol (MCP) server at `https://mcp.vertexsms.com/mcp`.

Account access is currently invite-only. New users request access via the contact form.

## Bulk SMS

- [Bulk SMS overview](https://vertexsms.com/en/bulk-sms): umbrella page covering all SMS products
- [SMS marketing](https://vertexsms.com/en/bulk-sms/sms-marketing): mass SMS campaigns and promotional messaging
- [SMS gateway](https://vertexsms.com/en/bulk-sms/sms-gateway): high-throughput A2P gateway
- [Two-factor authentication](https://vertexsms.com/en/bulk-sms/two-factor-authentication): SMS-based 2FA delivery
- [Two-way SMS](https://vertexsms.com/en/bulk-sms/two-way-communication): inbound replies and conversational SMS
- [SMS alerts and notifications](https://vertexsms.com/en/bulk-sms/sms-alert-notifications): transactional and operational alerts

## VoIP services

- [VoIP services overview](https://vertexsms.com/en/voip-services)
- [IVR](https://vertexsms.com/en/voip-services/ivr): interactive voice response
- [Click-to-call](https://vertexsms.com/en/voip-services/click-to-call)
- [Cloud telephony](https://vertexsms.com/en/voip-services/cloud-telephony)
- [Text-to-speech](https://vertexsms.com/en/voip-services/text-to-speech)
- [Speech-to-text](https://vertexsms.com/en/voip-services/speech-to-text)
- [Hold music](https://vertexsms.com/en/voip-services/hold-music)
- [Call routing](https://vertexsms.com/en/voip-services/call-routing)

## Email

- [Email overview](https://vertexsms.com/en/email)
- [Email marketing](https://vertexsms.com/en/email/email-marketing)
- [Transactional emails](https://vertexsms.com/en/email/transactional-emails)
- [Email automation](https://vertexsms.com/en/email/email-automation)

## Omnichannel

- [Omnichannel contact center](https://vertexsms.com/en/omnichannel-contact-center): unified inbox across SMS, Viber, voice, and email

## Documentation

- [Documentation overview](https://vertexsms.com/en/docs): single entry point — choose between the REST API (server-to-server) and the MCP server (AI assistants)

## REST API

- [Introduction](https://vertexsms.com/en/api/introduction): REST principles, HTTP status codes, error handling, security
- [Authentication](https://vertexsms.com/en/api/authentication): X-VertexSMS-Token header or `at` query parameter
- [Sending SMS](https://vertexsms.com/en/api/sms): POST /sms — required and optional fields, DLR callbacks, scheduled sendings, encoding
- [Sending Viber](https://vertexsms.com/en/api/viber): POST /viber — buttons and images via the `im` interactive-message option
- [HLR number lookup](https://vertexsms.com/en/api/hlr): POST /hlr — operator, country, MCC/MNC, IMSI, ported info via callback
- [Sender ID](https://vertexsms.com/en/api/senderid): register alphanumeric senders or MSISDN senders with PIN confirmation
- [Error codes](https://vertexsms.com/en/api/errors): callback error code catalog (0, 1, 2, 20-24, 40-53, 999)
- [Other endpoints](https://vertexsms.com/en/api/other): operator lookup, rates, MCC/MNC list, mobile prefixes, number correction

## MCP server (for AI assistants)

- [Introduction](https://vertexsms.com/en/mcp/introduction): server endpoint, available tools, what MCP is and when to use it instead of the REST API
- [Quickstart](https://vertexsms.com/en/mcp/quickstart): config snippets for Claude Desktop, Cursor, VS Code, Claude.ai
- [Authentication](https://vertexsms.com/en/mcp/authentication): bearer tokens (BYO) and OAuth 2.1 with five scopes
- [Tools reference](https://vertexsms.com/en/mcp/tools): full reference for the 10 tools — send_sms, get_sms_rates, correct_phone_number, get_operator, get_mcc_mnc_list, get_mobile_prefixes, lookup_hlr, register_sender_id, register_msisdn_sender, confirm_msisdn_sender
- [Errors](https://vertexsms.com/en/mcp/errors): uniform error envelope and error code catalog
- [Request MCP access](https://vertexsms.com/en/register-mcp): prefilled contact form for MCP server access

## Company

- [About](https://vertexsms.com/en/about)
- [Contact](https://vertexsms.com/en/contact)
- [Blog](https://blog.vertexsms.com)

## Optional

- [Privacy policy](https://vertexsms.com/en/privacy)
- [Terms of service](https://vertexsms.com/en/terms)
- [Cookie policy](https://vertexsms.com/en/cookies)
- [Full content for LLM ingestion](https://vertexsms.com/llms-full.txt): complete API and MCP documentation in plain text