home / mcp / clicksend mcp server

ClickSend MCP Server

Provides SMS messaging and TTS call capabilities via ClickSend API for MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "j-gal02-clicksend-mcp": {
      "command": "node",
      "args": [
        "/directory/to/build/folder/clicksend-mcp/build/index.js"
      ],
      "env": {
        "CLICKSEND_API_KEY": "ZZZZZZZZ-YYYY-YYYY-YYYY-XXXXXXXXXXXX",
        "CLICKSEND_USERNAME": "[email protected]"
      }
    }
  }
}

ClickSend MCP Server enables you to send SMS messages and create Text-to-Speech (TTS) calls through ClickSend’s API using MCP clients. It provides a practical bridge between your AI workflows and global communications, with built-in input validation and rate limiting to keep usage reliable and within safe bounds.

How to use

You interact with the ClickSend MCP Server through an MCP-compatible client. Start the server locally, then request SMS messages to any phone number or initiate TTS calls by providing the required parameters. The server enforces a rate limit of five actions per minute to prevent abuse and returns clear errors when inputs are invalid or the limit is reached.

Set up your MCP client to connect to your local ClickSend MCP instance or to the configured runtime for your environment.
Use the available actions to send an SMS or start a TTS call by supplying the recipient number and content.
Monitor responses and handle rate-limit errors by retrying after the suggested delay.
Ensure your ClickSend API credentials are secured and not exposed in client-side code.

How to install

Follow these concrete steps to install and run the ClickSend MCP Server locally.

Prerequisites you need before installation are Node.js (v16 or higher) and a ClickSend account with API credentials.

Step 1: Clone the project and navigate to the directory.

Step-by-step setup

git clone https://github.com/J-Gal02/clicksend-mcp.git
cd clicksend-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the MCP server (if a start script is provided in package.json)
npm run start

Configure the MCP client

Add the MCP server configuration to your client’s settings file so it can launch the ClickSend MCP Server as a local process.

Example client configuration snippet

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

Usage tips

After starting the server, you can invoke the available actions (send_sms and make_tts_call) through your MCP client, providing the required arguments as described in the action documentation.

Available tools

send_sms

Sends an SMS message to a specified phone number. Requires recipient number in E.164 format and the message content.

make_tts_call

Initiates a Text-to-Speech call to a specified phone number with customizable voice and message content.