How to Use the Gupshup Messaging MCP in Windsurf

Let Windsurf write and run WhatsApp notification flows autonomously using your Gupshup API account.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gupshup Messaging MCP to Windsurf

Create your Vinkius account to connect Gupshup Messaging 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 Gupshup Messaging with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate WhatsApp campaigns in Windsurf

Cascade handles the logic of selecting templates and sending them out. When you ask it to notify a list of users, it queries `get_template_info` to verify structure, then dispatches the alerts using `send_template_message` in a single loop. You don't have to write the boilerplate code or trigger each API call manually. The agent handles formatting variables and matching language codes on the fly. It monitors the response from each dispatch, keeping your team updated on what actually went through the MCP server to the Gupshup API.

Send media and interactive buttons

Toss a PDF or an image to your workspace and tell Cascade to distribute it. The agent uses `send_media_message` to push files directly to user phones without requiring you to write custom upload scripts. It can also append quick-reply options using `send_interactive_message` to gather immediate customer feedback. This lets you build complex, multi-option menus directly from your workspace chat.

Real-time chat reactions and text testing

Testing conversational flows inside Windsurf becomes straightforward when using this MCP toolset. You can instruct the agent to run test sequences using `send_text_message` and watch how the formatting renders on a real device. It can even trigger a quick acknowledgement using `send_reaction` to test how your end-users experience interactive chat states. No more switching back and forth between Postman and your editor.

Setup guide

Set up Gupshup Messaging 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 Gupshup Messaging 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 Gupshup Messaging payment history." If connected, Cascade will call the Gupshup Messaging tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "gupshup-messaging-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 Gupshup. 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 Gupshup Messaging 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 Gupshup Messaging MCP in Windsurf

Cascade runs a loop over your contact list, using the MCP Server to call `send_template_message` for each recipient. It manages the rate limits automatically and logs any failed numbers directly in your terminal.

Yes. You can prompt Cascade to generate up to three quick-reply options using `send_interactive_message`. It builds the JSON payload and sends it to your test device instantly.

No code is needed. Once you register this MCP server in your Windsurf configuration, Cascade discovers the six messaging tools and runs them on demand.

You can send images, videos, audio files, and documents. The agent uses `send_media_message` to handle these payloads, requiring only a public URL for the asset.

Your Gupshup API credentials and customer phone numbers never leave your local machine or touch external intermediary servers. The Vinkius runtime isolates this MCP Server in a zero-trust sandbox, passing data directly to the official Gupshup endpoint.

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