Claude Code MCP Integration

What is Claude Code MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude to interact with external tools and services. The WebSMS MCP server enables Claude Code to send SMS messages, check delivery status, and manage your messaging directly through natural language commands.

Instead of writing code or using APIs directly, simply tell Claude what you want to do: "Send an SMS to 027 123 4567 asking if they want coffee" - and Claude handles the rest, including phone number normalization, cost calculations, and delivery confirmation.

Built-in Safeguards

The WebSMS MCP includes intelligent safeguards to prevent accidental costs:

• Cost warnings - See the cost before sending, especially for multi-segment messages
• Phone normalization - Local formats like "027 123 4567" are automatically converted to international format
• Character counting - Warns about Unicode (emoji) messages that use more segments
• Rate limiting - Built-in 10 messages/second limit to prevent runaway costs
• Credential protection - Warns if credentials are stored insecurely

Quick Setup

{
  "mcpServers": {
    "websms": {
      "command": "npx",
      "args": ["@websms-nz/websms-mcp"],
      "env": {
        "WEBSMS_CLIENT_ID": "your-client-id",
        "WEBSMS_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

# Clone the repository
git clone https://gitlab.com/icepicknz/websms-mcp.git

# Install dependencies and build
cd websms-mcp
npm install
npm run build

{
  "mcpServers": {
    "websms": {
      "command": "node",
      "args": ["/path/to/websms-mcp/dist/index.js"],
      "env": {
        "WEBSMS_CLIENT_ID": "your-client-id",
        "WEBSMS_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}