How to Use the Clickatell MCP in Windsurf

Q: How do I configure the Clickatell MCP Server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file. Add the server under the mcpServers key, then click Refresh in the MCP panel. You can also use the built-in marketplace for a one-click install.

Q: Can Windsurf and Clickatell cancel scheduled SMS drops?

Yes. Cascade can call cancelqueuedmessage to delete scheduled messages before they go out. It irreversibly vaporizes the block.

Q: Does Clickatell work with Windsurf for bulk messaging?

It does. You can pass large arrays to dispatchbulksms. The agent handles the 164 boundaries natively to avoid API lag.

Q: How do I check my SMS balance without leaving the editor?

Just ask Cascade. It uses the getaccountbalance tool to pull your active funding limits directly from the cloud.

Connect the Clickatell MCP Server to Windsurf to let Cascade autonomously plan and execute SMS campaigns.

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

Build messaging flows with Windsurf

Connecting the Clickatell MCP Server lets Cascade read your prompt and figure out SMS workflows without asking permission. Tell it to spin up a new marketing push. It checks your funding limits using `get_account_balance` before doing anything else. Once it confirms you have the budget, Windsurf triggers `dispatch_bulk_sms` to hit your target MSISDNs. It chains these operations together natively inside your editor.

Manage inbound SMS routing

Managing Clickatell two-way text messages usually means writing custom webhook logic. This MCP Server lets your agent do the actual configuration directly. You just describe how you want replies handled. The agent maps the HTTP logic via `upsert_inbound_rule` and immediately verifies existing setups with `list_inbound_rules`. If a route goes bad, it calls `wipe_inbound_rule` to clear the legacy bounds.

Track carrier delivery metrics

Firing off Clickatell texts is only half the job. You need to know if they actually reached the handsets. Ask your agent to audit recent blasts. It pulls exact carrier statuses using `get_delivery_status` and tests specific routing paths via `test_carrier_coverage`. You get structural extraction of delivery properties right in your IDE.

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-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 ~/.codeium/windsurf/mcp_config.json file. Add the server under the mcpServers key, then click Refresh in the MCP panel. You can also use the built-in marketplace for a one-click install.

Yes. Cascade can call `cancel_queued_message` to delete scheduled messages before they go out. It irreversibly vaporizes the block.

It does. You can pass large arrays to `dispatch_bulk_sms`. The agent handles the 164 boundaries natively to avoid API lag.

Just ask Cascade. It uses the `get_account_balance` tool to pull your active funding limits directly from the cloud.

Vinkius runs this connection inside a V8 Isolate Sandbox. Your phone numbers, message payloads, and inbound webhook structures stay completely ephemeral. The system requires a single endpoint token, ensuring zero-trust execution.

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