How to Use the HeyReach MCP in Windsurf

Q: Can Windsurf manage HeyReach sender profiles?

Yes. The listlinkedinaccounts tool identifies every connected sender profile in your HeyReach workspace. Windsurf reads this list to determine which account should send a specific message or run a campaign.

Q: How does Windsurf track HeyReach campaigns?

Cascade runs listcampaigns to retrieve your active IDs. It then matches these IDs against your local prospect lists to ensure leads go to the correct outreach sequence.

Q: Can I check a lead's status directly in Windsurf?

Yes, the listleadcampaigns tool reveals every campaign associated with a specific lead. Windsurf queries this data to prevent sending duplicate messages to the same person.

Command LinkedIn campaigns and send follow-ups autonomously using Cascade inside Windsurf with this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HeyReach MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-inject leads into active campaigns

The `add_leads_to_campaign` tool lets Cascade push fresh prospect lists directly into your active sequences. Windsurf reads your local CSV files, extracts the LinkedIn profile URLs, and formats them into the required JSON structure automatically. You don't have to manually export or map fields anymore. Cascade calls `list_campaigns` to grab the right target ID, matches your local data, and updates your outreach pipeline in one shot using the MCP Server.

Autonomous inbox management in Windsurf

The `list_conversations` tool fetches your recent LinkedIn messages so your AI agent can monitor active threads. Cascade scans these conversations, flags replies that need attention, and drafts contextual responses. When a prospect replies, Windsurf uses `send_linkedin_message` to deliver your response instantly. It handles the entire conversation flow without requiring you to switch tabs or open a browser.

Guardrail campaigns with automatic pausing

The `pause_campaign` tool stops active sequences instantly when performance metrics drop or manual intervention is needed. Windsurf monitors your campaign status and triggers this stop command the moment it detects an issue. You can also use `resume_campaign` to kick things back off once you adjust your targeting. Cascade coordinates these shifts behind the scenes to protect your sender accounts from getting flagged.

Setup guide

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

mcp_config.json

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

Open your Windsurf settings and add the MCP Server configuration under the mcpServers key in your ~/.codeium/windsurf/mcp_config.json file. Cascade automatically discovers all ten MCP tools once you reload the workspace.

Yes. The `list_linkedin_accounts` tool identifies every connected sender profile in your HeyReach workspace. Windsurf reads this list to determine which account should send a specific message or run a campaign.

Cascade runs `list_campaigns` to retrieve your active IDs. It then matches these IDs against your local prospect lists to ensure leads go to the correct outreach sequence.

Yes, the `list_lead_campaigns` tool reveals every campaign associated with a specific lead. Windsurf queries this data to prevent sending duplicate messages to the same person.

All lead details, message history, and campaign metrics are processed locally in the V8 Isolate Sandbox using this MCP Server. Vinkius handles the API token authentication securely, ensuring your LinkedIn profile URLs and workspace details are never exposed to external servers.

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