Skip to main content
Glama

ClickSend MCP Server

ClickSend MCP Server

A Model Context Protocol (MCP) server that provides SMS messaging and Text-to-Speech (TTS) call capabilities through ClickSend's API. This server enables AI models to send SMS messages and initiate voice calls programmatically.

Features

  • SMS Messaging: Send SMS messages to any phone number worldwide
  • Text-to-Speech Calls: Make voice calls with customizable text-to-speech messages
  • Rate Limiting: Built-in protection with 5 actions per minute limit
  • Input Validation: Comprehensive validation for phone numbers and message content
  • Error Handling: Detailed error messages and proper error propagation

Installation

Prerequisites

  • Node.js (v16 or higher)
  • ClickSend account with API credentials
  • MCP-compatible Client

Setup

  1. Clone the repository:
git clone https://github.com/J-Gal02/clicksend-mcp.git cd clicksend-mcp
  1. Install dependencies:
npm install
  1. Build the project:
npm run build

Setting up the MCP Client

Add the following sections into your cline_mcp_settings.json file or claude_desktop_config.json file.

Be sure to replace the directory with the correct path to the build folder, as shown in the example below, as well as the username and API key with your own.

{ "mcpServers": { "clicksend": { "command": "node", "args": ["/directory/to/build/folder/clicksend-mcp/build/index.js"], "env": { "CLICKSEND_USERNAME": "example@droove.net", "CLICKSEND_API_KEY": "ZZZZZZZZ-YYYY-YYYY-YYYY-XXXXXXXXXXXX" } } } }

Usage

Available Tools

1. send_sms

Send SMS messages to specified phone numbers.

Parameters:

  • to: Phone number in E.164 format (e.g., +61423456789)
  • message: Text content to send

Example:

{ "name": "send_sms", "arguments": { "to": "+61423456789", "message": "Hello from ClickSend MCP!" } }
2. make_tts_call

Initiate Text-to-Speech calls.

Parameters:

  • to: Phone number in E.164 format
  • message: Text content to convert to speech
  • voice: Voice type ('female' or 'male', defaults to 'female')

Example:

{ "name": "make_tts_call", "arguments": { "to": "+61423456789", "message": "This is a Text-to-Speech call from ClickSend MCP", "voice": "female" } }

Rate Limiting

The server implements a rate limit of 5 actions per minute to prevent abuse. Requests exceeding this limit will receive an error response with a retry delay suggestion.

Development

Available Scripts

  • npm run build: Compile TypeScript and make the output executable
  • npm run start: Start the MCP server
  • npm run dev: Run TypeScript compiler in watch mode

Project Structure

clicksend-mcp/ ├── src/ │ ├── index.ts # Main server implementation │ ├── client.ts # ClickSend API client │ └── utils/ │ └── validation.ts # Input validation utilities ├── build/ # Compiled JavaScript output └── package.json # Project configuration

Error Handling

The server provides detailed error messages for various scenarios:

  • Invalid phone numbers
  • Message content validation failures
  • Rate limit exceeded
  • API authentication errors
  • Network connectivity issues

Error responses include appropriate error codes and descriptive messages to help diagnose issues.

TODO

  • Multiple Recepients
  • Configure Sender IDs
  • SMS
  • TTS
  • Email
  • Media Uploading
    • Email Attachments
    • MMS
    • Letters
    • Postcards
    • Fax
  • Cost Calculation and Confirmation
  • Statistics
  • History
  • Contacts
  • Automations

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

This server enables AI models to send SMS messages and initiate Text-to-Speech calls programmatically using ClickSend's API with built-in rate limiting and input validation.

  1. Features
    1. Installation
      1. Prerequisites
      2. Setup
      3. Setting up the MCP Client
    2. Usage
      1. Available Tools
      2. Rate Limiting
    3. Development
      1. Available Scripts
      2. Project Structure
    4. Error Handling
      1. TODO
        1. License
          1. Contributing

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables Claude and other AI assistants to send SMS and MMS messages using Twilio.
              Last updated -
              78
              9
              JavaScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              A server implementing Model Context Protocol that enables AI assistants to interact with Slack API through a standardized interface, providing tools for messaging, channel management, user information retrieval, and more.
              Last updated -
              9
              53
              JavaScript
              Apache 2.0
            • -
              security
              F
              license
              -
              quality
              A full-stack SMS assistant that integrates MessageMedia SMS API with OpenAI's GPT models, enabling AI-driven SMS conversations and message management through function calling and contextual memory.
              Last updated -
              JavaScript
            • A
              security
              A
              license
              A
              quality
              A server that enables AI assistants to interact with the Omnisend marketing platform, supporting contact management, product management, and event tracking operations through natural language.
              Last updated -
              10
              TypeScript
              Apache 2.0
              • Linux
              • Apple

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/J-Gal02/clicksend-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server