How to Use the Findymail MCP in Windsurf

Q: What happens if a lead search takes too long?

The agent uses getleadsearchstatus to monitor the progress of larger queries. Once the search finishes, it automatically calls getleadsearchdata to pull the fresh leads. You can keep writing code while the agent handles the waiting game.

Build clean, verified lead lists directly inside Windsurf by letting Cascade chain your prospecting searches and validation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Findymail MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated pipeline building in Windsurf

Stop jumping between browser tabs to copy-paste prospect details when you can run `search_leads` directly in your workspace. This MCP Server lets Cascade chain a sequence of steps to build your outbound pipeline from scratch. You tell it who you want to target, and it runs the query to find matches, then pipes those results straight into your target contact files. It doesn't stop at finding names. The agent automatically runs `create_contact_list` to segment your new targets, keeping your workspace clean and organized. You get a ready-to-use outbound list generated entirely through a single prompt.

Real-time verification inside your editor

Checking deliverability before writing outreach code is critical, and doing it through the MCP connection keeps your bounce rates low. Dirty data kills cold email campaigns before they even start. When you run a search, you need to know those addresses are real, which is why your agent triggers `verify_email` on the fly. If an email looks shaky, the agent can try to find an alternative using `find_email`. This keeps your bounce rate low and protects your domain reputation without requiring manual spreadsheet cleaning.

Deep company enrichment and phone discovery

Context is everything when personalizing your pitch, which is why your agent uses `enrich_company` to grab background data on target accounts. Having deep background details helps you write emails that actually get replies instead of landing in the spam folder. If you prefer calling, the agent calls `find_phone` to grab direct dials. Combining emails and phone numbers in one place makes multi-channel outreach actually work instead of just sounding like a good idea.

Setup guide

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

mcp_config.json

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

Run a simple query asking Cascade for your balance. The agent will call `get_credits` or `get_credits_summary` using this MCP Server to show your usage right in the chat panel. You never have to log into an external dashboard just to see what you have left.

Yes, Cascade excels at this. You can ask it to search for a specific persona, and it will trigger `search_leads`, wait for the results, and then systematically parse them. It handles the entire loop of finding and organizing the data without asking you for permission at every step.

Your agent can check existing files first before running any new queries. It uses `get_contact` to check if a lead is already in your local files or active contact lists. This prevents you from burning credits on people you already have in your database.

The agent uses `get_lead_search_status` to monitor the progress of larger queries. Once the search finishes, it automatically calls `get_lead_search_data` to pull the fresh leads. You can keep writing code while the agent handles the waiting game.

All communication goes through a zero-trust V8 sandbox. Vinkius MCP hosting secures your API keys and retrieved contact details, ensuring they are never stored on external servers or used to train models. Data stays strictly between your local client and the secure 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