How to Use the Clickatell MCP in Windsurf

Windsurf Cascade sends global SMS and WhatsApp campaigns directly from your editor using the Clickatell MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Clickatell MCP to Windsurf

Create your Vinkius account to connect Clickatell to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Clickatell with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Send SMS Campaigns Autonomously

The `send_bulk_messages` tool lets Cascade push notifications to thousands of users at once. You just tell the agent to notify your customer list about a server outage. It automatically grabs the recipient numbers, formats the payload, and executes the blast. Your agent immediately runs `get_message_status` to verify delivery across the network after hitting send. Failed deliveries get flagged in your IDE console so you can investigate routing issues immediately. You never have to guess if a text actually arrived.

Manage WhatsApp Templates in Windsurf

The `list_whatsapp_templates` tool fetches pre-approved formats directly into your workspace for business-initiated chats. Cascade reads these structures to ensure your outgoing messages match the exact parameters required by Meta. This guarantees compliance without leaving your code editor. You can instruct your client to clean up outdated promotional formats using `delete_whatsapp_template`. The agent handles the API calls while you focus on writing the new marketing copy. Old seasonal promotions disappear from your account in seconds.

Monitor Account Health via MCP

Cascade prevents budget overruns by calling `get_account_balance` before initiating any large broadcast. Empty accounts kill marketing campaigns instantly. If funds look low, the agent pauses the workflow and alerts you. The `list_source_numbers` tool finds your active sending numbers in seconds. Your agent pulls the exact short codes or long numbers assigned to your profile. This guarantees your scripts always reference valid originator IDs.

Setup guide

Set up Clickatell MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Clickatell MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Clickatell payment history." If connected, Cascade will call the Clickatell tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "clickatell-alternative-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Clickatell. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Clickatell now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Clickatell MCP in Windsurf

Open your MCP Servers UI under Settings. Add the Vinkius endpoint URL to your configuration file and click refresh. Cascade will automatically discover the messaging tools.

Yes. The agent uses the bulk sending tool to dispatch multiple texts simultaneously. You just provide the target list and the message copy.

Cascade can check your balance before running a campaign. If you lack sufficient funds, the agent halts the process and warns you.

You can fetch media details using the dedicated media tool. Your client retrieves the metadata needed to attach images or documents to outgoing chats.

Vinkius runs this integration inside an isolated V8 sandbox. Your recipient phone numbers and message bodies never persist on our infrastructure. The ephemeral connection drops immediately after the API returns a success code.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript