ClickSend

ClickSend MCP Server extends ClickSend’s messaging capability into AI-guided workflows, letting you send SMS from AI-driven tools and assistants without writing custom integration code. It exposes straightforward MCP endpoints and a local runtime that you can run from your desktop to reach ClickSend’s SMS service quickly and securely.

How to use

You run a local MCP server and connect your MCP client to it. The server provides a simplified set of endpoints to send SMS, estimate prices, fetch templates, retrieve history, view statistics, and search contact lists. To start using it, configure your MCP client to load the server, then issue SMS requests and related actions from your client’s command palette or chat-style prompts.

How to install

Prerequisites: Node.js 18 or newer. If you manage Node versions, you can use a version manager such as nvm to ensure you’re running the correct runtime.

Install steps you can follow now:

1. Install Node.js 18 or later (using a version manager is recommended).

2. Choose a runtime option for the MCP server and configure the MCP client accordingly (see the configuration sections for details).

Configuration and runtime options

Two MCP runtime options are provided for this server. You can run the MCP server via a one-off command with npx, or you can run a local build with node. Both methods require your ClickSend credentials.

{
  "mcpServers": {
    "clicksend": {
      "command": "npx",
      "args": [
        "-y",
        "@clicksend/clicksend-mcp-server@latest"
      ],
      "env": { 
        "CLICKSEND_USERNAME": "<username>",
        "CLICKSEND_API_KEY": "<api-key>"
      }
    }
  }
}

Additional runtime option (local build)

If you prefer running a local build, you can start the MCP server with node and point to the built script. Ensure you replace the path with your actual build location.

{
  "mcpServers": {
    "clicksend": {
      "command": "node",
      "args": [
        "/path/to/repository/build/clicksend-mcp.js"
      ],
      "env": {
        "CLICKSEND_USERNAME": "your clicksend username",
        "CLICKSEND_API_KEY": "your API Key",
      }
    }
  }
}

Security and credentials

Keep your ClickSend credentials secure. Do not commit usernames or API keys to version control or share them publicly. Use environment variables and secret management wherever possible.

Features and endpoints

The server provides convenient actions to manage and send SMS, including single-message sending, price calculation, template retrieval, history viewing, statistics, and contact list discovery. You can perform these actions via your MCP client using natural prompts.

Troubleshooting

Common issues include ensuring numbers are in E.164 format (for example, +61411111111) and validating that your ClickSend credentials are correctly set. If you encounter authentication errors, re-check your CLICKSEND_USERNAME and CLICKSEND_API_KEY values.

Notes

This server is designed to enable AI-driven SMS workflows. Manage your credentials securely, and monitor rate limits and pricing on your ClickSend account to avoid unexpected costs.

Available tools

send-sms

Send a single SMS message to a specified number or to a recipient from a contact list.

calculate-sms-price

Estimate the price of sending messages based on type and length.

view-sms-templates

Retrieve available SMS templates and optionally filter results.

view-sms-history

View previously sent SMS messages with filtering and pagination options.

view-sms-statistics

Get SMS statistics for the last 30 days.

view-contact-lists

Search and view contact lists for sending messages to groups.