clicksend-mcp

clicksend-mcp

2
communication

The ClickSend MCP Server is designed to facilitate SMS messaging and Text-to-Speech calls by leveraging ClickSend's API. It provides a structured setup for communication services with rate limiting, input validation, and detailed error handling.

ClickSend MCP Server

A Model Context Protocol (MCP) server facilitating SMS messaging and Text-to-Speech (TTS) calls through ClickSend's API, enabling AI models to send SMS and initiate voice calls.

Features

  • SMS Messaging: Send SMS worldwide
  • Text-to-Speech Calls: Initiate customizable TTS calls
  • Rate Limiting: Max 5 actions/minute
  • Input Validation: Validate phone numbers and messages
  • Error Handling: Detailed error propagation

Installation

  • Prerequisites: Node.js, ClickSend account, MCP-compatible Client

Setup

  1. Clone the repository
  2. Install dependencies
  3. Build the project

Setting up the MCP Client

  • Configure directory paths, username, and API key

Usage

Tools

send_sms
  • Parameters: to, message
make_tts_call
  • Parameters: to, message, voice

Rate Limiting

  • Limit of 5 actions per minute; error response with retry delay suggested.

Error Handling

Detailed error messages provided for scenarios such as invalid phone numbers, message validation failures, rate limit exceeded, and API errors.

Development

Scripts

  • npm run build
  • npm run start
  • npm run dev

Structure

clicksend-mcp/ with src/ and build/ directories

TODO

  • Multiple recipients, sender IDs, email features, media uploading, cost calculation, statistics, and automations.