Clicksend MCP Server

🚀 ClickSend MCP Server

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

🚀 Quick Start

The ClickSend MCP Server allows AI models to interact with ClickSend's API to send SMS messages and make voice calls. It provides a set of tools and features to ensure reliable and secure communication.

✨ Features

• SMS Functionality: Send SMS messages to any phone number worldwide.
• Text-to-Speech Calls: Initiate voice calls using customizable text-to-speech messages.
• Rate Limiting: Built-in protection mechanism, limiting operations to 5 per minute.
• Input Validation: Comprehensive validation of phone numbers and message content.
• Error Handling: Detailed error information and appropriate error propagation.

📦 Installation

Prerequisites

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

Setup

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configure the MCP Client

Add the following content to your cline_mcp_settings.json file or claude_desktop_config.json file.

Make sure to replace the directory with the correct build folder path and replace 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 Examples

Basic Usage

1. send_sms

Send an SMS message to a specified phone number.

Parameters:

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

Example:

{
  "name": "send_sms",
  "arguments": {
    "to": "+61423456789",
    "message": "你好，这是一条测试消息。"
  }
}

2. send_call

Initiate a voice call using TTS.

Parameters:

• to: Phone number in E.164 format (e.g., +61423456789)
• message: Text content to be read aloud via TTS

Example:

{
  "name": "send_call",
  "arguments": {
    "to": "+61423456789",
    "message": "你有一条新消息，请查阅。"
  }
}

🔧 Technical Details

• Support two-way communication for SMS and voice calls.
• Integrate with ClickSend's API functionality.
• Provide detailed logging and error handling mechanisms.

📄 License

MIT

👥 Contribution

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