How to Use the SmartLead MCP in Windsurf

Q: Can Windsurf help me manage sending limits and SmartLead accounts?

Absolutely. You can use listemailaccounts to see your current pool of senders. The agent tracks which accounts are available, letting you run campaigns knowing you won't hit a hard limit.

Manage cold outreach campaigns using Windsurf's autonomous Cascade agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect SmartLead MCP to Windsurf

Create your Vinkius account to connect SmartLead to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup SmartLead with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Analyze campaign performance across multiple tools.

The `get_campaign_analytics` tool pulls detailed metrics for any SmartLead campaign. You set the goal—like finding out which subject lines perform best—and Windsurf figures out the steps to get that data. It doesn't just show you a report; it runs through multiple tools, correlating analytics with `list_leads` to identify exactly which segments need immediate attention for your outreach.

Scale lead management from start to finish.

Need to build out a list? Start by calling `list_email_accounts` to check current sender limits. Then, the agent uses `add_lead` repeatedly to populate new contacts into SmartLead. It handles the whole sequence without you having to prompt it for each step. This is perfect for onboarding large batches of data. Windsurf chains together lead retrieval and population tasks, making sure your entire outreach pipeline stays full.

Control campaign flow with multi-step commands.

The `list_campaigns` tool lets you see every active SmartLead effort at a glance. If one campaign is running too hot, Windsurf can automatically call `pause_campaign`. It's proactive control. Later, when the list is scrubbed and ready to go again, it executes `resume_campaign`. This gives your autonomous agent complete operational control over campaign status changes.

Setup guide

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

mcp_config.json

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

Windsurf can chain together multiple actions. First, you'd run `list_leads` to pull all existing contacts. Then, it uses that data to feed into a targeted mini-campaign using the MCP Server, ensuring precise segmenting.

Absolutely. You can use `list_email_accounts` to see your current pool of senders. The agent tracks which accounts are available, letting you run campaigns knowing you won't hit a hard limit.

The server primarily touches lead contact information and campaign performance metrics. Specifically, it handles raw lead records retrieved via `list_leads`.

You simply update the goal for Cascade. Instead of a broad blast, you might tell it to pause the old campaign and create new segments using `get_campaign_analytics` data.

Yes. You can use a multi-step process: list accounts, add leads in batches, and then schedule the campaign run using `add_lead` followed by campaign initiation.

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