We use cookies to improve your experience on this site and serve more relevant content to you. By continuing to browse our site you agree to our use of cookies, revised Privacy Policy and Terms of Service.  More information about cookies

VertexSMS MCP server

The VertexSMS MCP server lets AI assistants like Claude, Cursor, and VS Code Copilot use your VertexSMS account directly — no glue code, no API plumbing. The assistant sees a set of tools and calls them on your behalf.

Model Context Protocol (MCP) is an open standard published by Anthropic for connecting AI applications to external systems. Read the protocol spec if you are curious about how it works under the hood; you do not need to know it to use our server.

Endpoint

The MCP server is hosted at:

https://mcp.vertexsms.com/mcp

It speaks the MCP Streamable HTTP transport. Both standard bearer-token auth and full OAuth 2.1 are supported — see Authentication.

Tools

Ten tools wrapping the VertexSMS REST API.

Available tools
Tool
Category
Description
CategorySMS
DescriptionSend an SMS message.
CategorySMS
DescriptionLook up per-country SMS pricing.
CategoryNumbers
DescriptionValidate and convert phone numbers to E.164.
CategoryNumbers
DescriptionLook up a mobile operator by VertexSMS ID.
CategoryNumbers
DescriptionList MCC/MNC codes for a country.
CategoryNumbers
DescriptionList mobile number prefixes for a country.
CategoryHLR
DescriptionRun a synchronous HLR lookup on a phone number.
CategorySender ID
DescriptionSubmit an alphanumeric Sender ID for approval.
CategorySender ID
DescriptionRegister a mobile number as a sender.
CategorySender ID
DescriptionConfirm a mobile-number sender via the PIN sent by SMS.
Why use this instead of the REST API directly?

For traditional integrations (your application calls our API from server code), the REST API is the right tool. The MCP server is for the case where the caller is an AI assistant that does not have a hand-coded integration with VertexSMS — you want the assistant to be able to discover what is possible and use it on demand.

Concrete examples: asking Claude Desktop to send a verification code to a phone number; letting Cursor validate a CSV of phone numbers as part of a code-generation task; using a custom internal AI agent to price-check campaigns before bulk sending.

Get started

If you have a VertexSMS account already, head to the Quickstart — you can be running tool calls from Claude Desktop in about 60 seconds.

If you do not have an account yet, contact us through the contact form; registration is currently invite-only.