How to Use the 2Chat MCP in Windsurf

Windsurf chains WhatsApp automation directly. Cascade reads context and sends messages without needing you to prompt every step.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect 2Chat MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade Orchestrates WhatsApp via Windsurf

The `send_message` tool pushes text or media directly to WhatsApp users or groups. Cascade grabs context from your active editor, formats the payload, and fires it off. You don't have to break focus to handle messaging logistics. This MCP Server lets your agent pull the right phone number using `list_numbers` and trigger the send in one fluid motion.

Autonomous Group Management

The `create_group` tool instantly spins up new WhatsApp channels with specific participants. Cascade looks at your project roster and builds the group without asking for permission. Once the room exists, your agent can pull the UUID via `list_groups` to start blasting updates. The whole MCP setup happens in the background while you keep coding.

Pre-Flight Number Verification

The `check_number` tool confirms a phone number actually exists on WhatsApp before attempting delivery. Your IDE checks the registry first to avoid bouncing requests. Catching dead numbers early keeps your application logs clean. Cascade runs this check automatically whenever it spots a new contact in your codebase.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "2chat-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 2Chat. 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 2Chat 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 2Chat MCP in Windsurf

Open Settings, go to Cascade, and find the MCP Servers UI. You can add the endpoint there or hit the built-in marketplace for a quick install.

Yes. Cascade can pass public media URLs straight into the send tool. It handles both plain text and media payloads.

Your agent will run the listing tool to find out which WhatsApp accounts are connected. It automatically picks the right origin number for the outbound message.

The agent usually verifies the contact first. If it skips that and the number is fake, the API throws an error that Cascade reads and reports back to you.

Vinkius runs the integration inside an ephemeral V8 Isolate sandbox. Your phone numbers, group participants, and message contents pass through a zero-trust environment that wipes itself clean after the execution finishes.

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