MCP Quickstart | VertexSMS

Get an AI assistant talking to your VertexSMS account in under a minute. You will need a VertexSMS account and an API token, if you do not have a token yet, jump to Authentication first.

Claude Desktop

Open the claude_desktop_config.json file in your config directory.

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Add a vertexsms entry under mcpServers:

claude_desktop_config.json
{
  "mcpServers": {
    "vertexsms": {
      "url": "https://mcp.vertexsms.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VERTEXSMS_TOKEN"
      }
    }
  }
}

Replace YOUR_VERTEXSMS_TOKEN with your VertexSMS API token. Save the file and restart Claude Desktop. The ten VertexSMS tools will appear in the tools menu.

Cursor

Open Cursor → Settings → MCP, or edit ~/.cursor/mcp.json directly:

~/.cursor/mcp.json
{
  "mcpServers": {
    "vertexsms": {
      "url": "https://mcp.vertexsms.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VERTEXSMS_TOKEN"
      }
    }
  }
}

Restart Cursor. The tools become available to the agent immediately.

VS Code (GitHub Copilot Chat)

VS Code's MCP support lives in settings.json under the mcp.servers key:

settings.json
{
  "mcp.servers": {
    "vertexsms": {
      "url": "https://mcp.vertexsms.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VERTEXSMS_TOKEN"
      }
    }
  }
}

Reload the window and the tools will be available to Copilot Chat in agent mode.

Claude.ai (web)

For users on Claude paid plans, MCP servers can be added in Settings → Connectors. Choose "Add custom connector", paste the server URL, and select OAuth (recommended) or API key authentication.

If you choose OAuth, you will be redirected to the VertexSMS dashboard to approve the connection, no token paste required. See Authentication → OAuth for details.

Smoke test

To verify the connection, ask the assistant something simple that hits a free, read-only tool:

EXAMPLE PROMPT
"What is the SMS rate to Lithuania?"

The assistant should call get_sms_rates with country LT and report the per-operator pricing in EUR. If you instead get an authentication error, double-check the bearer token. If you get a "tool not found," the config file did not load, check the path and restart the client.

Next steps

Tools reference, what each of the ten tools does, with examples.

Authentication, bearer tokens vs. OAuth.

Let your AI talk.We handle the SMS.