How to Use the Adversus MCP in Windsurf

Q: Can Windsurf and Adversus add contacts to my live campaigns?

Yes. Cascade can execute the addcontacttocampaign tool if you tell it to. Always point it at a test campaign during development so you do not accidentally dial real customers.

Connect Windsurf to Adversus and let Cascade build sales dashboards by pulling live campaign data directly into your codebase.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Adversus MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Lead Syncing with Windsurf

Cascade reads your project context and decides when to fetch sales data. You ask it to build a dashboard showing active outbound targets, and it immediately fires `list_active_leads` to get the raw numbers. It does not wait for you to approve every API call. The agent then maps those leads to your local database schema. If it needs team context, it runs `list_account_users` to match sales reps with their current workload. You just watch the code appear in your editor while Cascade handles the backend integration.

Campaign Management via MCP Server

Pulling call center metrics usually means tabbing between a browser and your IDE. This integration stops that context switch. Cascade calls `list_campaigns` to grab every active dialing initiative right inside your workspace. When you need to drill down into specific contact lists, the agent executes `get_campaign_details` followed by `list_campaign_contacts`. It builds the necessary React components and populates them with real Adversus data before you even touch the keyboard.

Feed Your CRM Projects

Building custom tools for your sales team requires actual test data. Instead of mocking up fake leads, you tell Windsurf to use the `list_crm_projects` tool. Cascade pulls your actual pipeline structures straight into your development environment. Adding test records is just as fast. The agent uses `add_contact_to_campaign` to push a dummy contact into a staging campaign, verifying your new API routes work perfectly. It chains these operations together without breaking a sweat.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "adversus-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 Adversus. 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 Adversus 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 Adversus MCP in Windsurf

Open the MCP panel and hit the Marketplace tab for a one-click install. You can also manually edit ~/.codeium/windsurf/mcp_config.json and add the server block. Hit refresh and Cascade will see the new tools.

Yes. Cascade can execute the add_contact_to_campaign tool if you tell it to. Always point it at a test campaign during development so you do not accidentally dial real customers.

Check your API token in the MCP configuration. If the credentials are valid, tell Cascade to run list_active_leads explicitly to verify the connection is working.

The agent receives raw JSON containing dialer settings, active agent counts, and pipeline metrics. It uses that payload to generate accurate TypeScript interfaces or populate your local database.

Vinkius runs this MCP integration in an isolated V8 sandbox. Your outbound sales contacts and team user lists never touch our logging systems. The connection is ephemeral and requires only your endpoint token to authenticate.

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