# MCP server — Quickstart


Source: https://vertexsms.com/en/mcp/quickstart

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, see Authentication first.

## Claude Desktop

Open `claude_desktop_config.json`:

| 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`:

```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 and restart Claude Desktop. The ten VertexSMS tools appear in the tools menu.

## Cursor

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

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

Restart Cursor. Tools become available to the agent immediately.

## VS Code (GitHub Copilot Chat)

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

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

Reload the window — the tools are then 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.

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

## Smoke test

Ask the assistant a free, read-only question:

```
"What is the SMS rate to Lithuania?"
```

The assistant should call `get_sms_rates` with country `LT` and report per-operator pricing in EUR. An auth error means the bearer token is wrong; a "tool not found" means the config file did not load — recheck the path and restart the client.